Rutas
Una ruta es un corredor habilitado para tu compañía: un país, moneda y método de pago de destino, junto con sus comisiones y límites restantes.
get_routes
Lista los corredores habilitados para tu compañía, opcionalmente filtrados por moneda de origen.
Firma
def get_routes(self, source_currency: Optional[str] = None) -> RoutesResponse:
Parámetros
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
source_currency | Optional[str] | No | Filtro por moneda de origen. Omítelo (o pasa None) para listar todas las rutas habilitadas para tu compañía. Se manda como el query parameter sourceCurrency. |
Retorno
RoutesResponse:
| Campo | Tipo | Descripción |
|---|---|---|
routes | Optional[List[Route]] | Los corredores habilitados. |
Route:
| Campo | Tipo | Descripción |
|---|---|---|
name | Optional[str] | Nombre de la ruta, p. ej. "BANK_TRANSFER-VE". |
method | Optional[str] | Método de pago de este corredor — consulta Tipos de payout. |
country | Optional[str] | País de destino. |
currency | Optional[str] | Moneda de destino. |
rate | Optional[str] | Tipo de cambio indicativo — un decimal string (p. ej. "852.79"), igual que el resto de los montos en el wire. El tipo de cambio que realmente aplica a una transferencia es el que queda fijado en su cotización. |
fees | Optional[List[RouteFee]] | Reglas de precio — pricing_rule, pricing_type, percentage_value, flat_value, pricing_label. |
limits | Optional[RouteLimits] | per_transaction (PerTransactionLimit: min/max en strings decimales), transaction (TransactionWindows con daily/weekly/monthly TransactionWindow: max/current/remaining como conteos), fund (FundWindows con daily/weekly/monthly FundWindow: max/current/remaining en strings decimales). |
Ejemplo
routes = client.get_routes("USDR")
for r in routes.routes or []:
print(r.name, r.country, r.currency, r.rate)
Errores
B2B_UNAUTHORIZED— token o firma de request inválidos.ValueError— se lanza localmente cuandosource_currencyestá presente pero vacío.
Notas
- Llámalo sin
source_currencypara listar todas las rutas habilitadas para tu compañía. ratees indicativo — no lo uses para calcular un monto de pago. Usa elexchange_ratede una cotización en su lugar.