Skip to main content

​
Resumen

El cash-in de Venezuela acredita una cuenta USDT operativa. Envíe amount como cadena decimal positiva. No envíe un número JSON. Pueden aparecer hasta 8 dígitos fraccionarios. montoFiat y tasaCompra son metadatos en VES. No son el monto del libro. No es un checkout hospedado. Cree el cash-in con POST /api/v1/ve/transactions/inbound.

​
Requisitos

  • Token Bearer con acceso a la cuenta USDT
  • Nombre opcional del banco del pagador, desde GET /api/v1/ve/banks (onramp.banks[].name)

​
Flujo

  1. Llame a GET /api/v1/ve/banks si quiere fijar el banco del pagador
  2. POST /api/v1/ve/transactions/inbound con accountId y amount
  3. Consulte GET /api/v1/ve/transactions/{id}/status, o defina webhookUrl — vea Recepción de webhooks

​
Solicitud

Obligatorios: accountId, amount. Opcionales: bancoPago, webhookUrl. bancoPago debe ser un onramp.banks[].name exacto. No es el id numérico ni un country.banks[].label. Omítalo para dejar el banco del pagador sin definir. Un nombre desconocido o un id crudo devuelve 400 con code: VE_INBOUND_INVALID_BANCO_PAGO.

​
Ejemplo

ONRAMP_BANK_NAME es un marcador. Copie el nombre exacto de onramp.banks[].name en GET /api/v1/ve/banks.

​
Éxito

201 devuelve id, status: pending, amount (cadena decimal USDT) y orden_id. montoFiat y tasaCompra se incluyen solo cuando la respuesta de creación los trae.

​
Estado

GET /api/v1/ve/transactions/{id}/status lee el estado del cash-in y del payout. amount es una cadena decimal USDT. Cuando ya existen las instrucciones de pago, el cuerpo puede incluir banco y numero_cuenta, solo de entrada. Esos campos de cobro no se devuelven en un payout. Vea Payouts para pending_kyc, kyc_url, kyc_expires_at y cancelledReason.

​
Errores

​
Estado de la cuenta

La cuenta debe estar Operativa y en USDT. Bloqueada o Cerrada devuelve 403 con code: ACCOUNT_NOT_OPERATIVE.