Saltar al contenido principal

USDR

USDR (Retorna USD) es la unidad de cuenta propia de Retorna: la moneda en la que está denominada la wallet de tu organización y desde la que arranca cada transferencia. Es el lado origen de los fondos de todo el flujo: mantienes USDR, cotizas desde USDR y Retorna paga en la moneda local del destino.

USDR no es un código ISO 4217. Es un código de moneda interno de Retorna, y por eso los campos de moneda aceptan de 3 a 5 caracteres en mayúsculas (^[A-Z]{3,5}$) en lugar de los tres de ISO 4217: USDR tiene cuatro.

Valor

La plataforma trata 1 USDR = 1 USD. USDR es la unidad con la que Retorna lleva tu saldo y cotiza las transferencias; no es un tipo de cambio que tengas que cotizar ni convertir de tu lado.

Dónde lo vas a ver​

Como moneda de tu wallet​

Toda wallet de organización se aprovisiona en USDR. El saldo que devuelve GET /me/wallets/{currency} es un monto en USDR:

{
  "status": "ACTIVE",
  "currency": "USDR",
  "amount": "1000.50"
}

Los movimientos de la wallet también están denominados en USDR — un top_up (un depósito on-chain) o un b2b_manual_credit (un crédito registrado por tesorería) suman USDR a tu saldo:

{
  "id": "c941d781-0a8e-45c5-a7ba-abfdcf96ffe7",
  "type": "top_up",
  "amount": "20.00",
  "currency": "USDR",
  "status": "COMPLETED",
  "created_at": "2026-06-05T16:21:42.004Z"
}

Como moneda de origen de un quote​

El source.currency de POST /quotations es USDR. El tipo de cambio que recibes es el de USDR → moneda de destino para ese corredor:

{
  "source": { "currency": "USDR" },
  "destination": {
    "country": "VE",
    "currency": "VES",
    "payout_method": { "type": "P2P_PHONE_TRANSFER" }
  },
  "quote": { "mode": "SEND_EXACT", "amount": "100.00" }
}

Las comisiones también se cobran en USDR: la respuesta del Quote reporta fees.total_in_source_currency y el par gross_amount / net_amount del lado origen, todo en USDR.

Como filtro de corredor por defecto​

GET /me/routes usa USDR como valor por defecto de sourceCurrency, así que listar tus corredores disponibles y sus límites operativos ya responde la pregunta "¿qué puedo enviar desde mi saldo en USDR?".

Consideraciones​

  • Envía el código tal cual — los códigos de moneda son solo en mayúsculas, una única grafía por moneda. usdr se rechaza en validación con un 400.
  • Una moneda de origen equivocada es una falla de cotización, no de validación — un source.currency bien formado pero no soportado llega al motor de cotización y vuelve como 422 B2B_RATE_NOT_FOUND, porque no existe tarifa activa para ese corredor.
  • El saldo de la wallet es el techo — las órdenes se debitan de tu saldo en USDR, así que el gross_amount del quote más sus comisiones tienen que estar cubiertos por él.
tip

Los montos se devuelven como strings decimales ("1000.50", "20.00"), nunca como floats. Parséalos con un tipo decimal seguro — nunca con punto flotante binario — para que no se desplacen los centavos.