Saltar al contenido principal

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​

NombreTipoRequeridoDescripción
source_currencyOptional[str]NoFiltro 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:

CampoTipoDescripción
routesOptional[List[Route]]Los corredores habilitados.

Route:

CampoTipoDescripción
nameOptional[str]Nombre de la ruta, p. ej. "BANK_TRANSFER-VE".
methodOptional[str]Método de pago de este corredor — consulta Tipos de payout.
countryOptional[str]País de destino.
currencyOptional[str]Moneda de destino.
rateOptional[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.
feesOptional[List[RouteFee]]Reglas de precio — pricing_rule, pricing_type, percentage_value, flat_value, pricing_label.
limitsOptional[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 cuando source_currency está presente pero vacío.

Notas​

  • Llámalo sin source_currency para listar todas las rutas habilitadas para tu compañía.
  • rate es indicativo — no lo uses para calcular un monto de pago. Usa el exchange_rate de una cotización en su lugar.

Referencia de API​

GET /me/routes