Payout Crypto - ON RAMP by Mesadepagos

El módulo Payout Crypto permite enviar fondos desde una wallet creada en ON RAMP hacia una wallet externa indicada por el partner. El endpoint v3 mantiene el mismo contrato de request y response que v2. Obtén un token con POST /v3/auth/login. Consulta la wallet de origen y sus assets configurados en Wallets v3.

Endpoint

POST /v3/transactions/payouts/crypto

Headers

Header	Requerido	Descripción
`Authorization`	Sí	`Bearer <token>` de sesión JWT
`Content-Type`	Sí	`application/json`

Crear Payout Crypto

Usa este endpoint para solicitar un payout crypto desde una wallet interna hacia una dirección destino.

Request

{
  "walletId": "550e8400-e29b-41d4-a716-446655440000",
  "destinationWallet": "0x0000000000000000000000000000000000000000",
  "amount": "100",
  "asset": "USDC",
  "blockchain": "Polygon",
  "externalReference": "9dd9614e-5059-4cb5-826c-ef092fd99cb9"
}

Campos

Campo	Tipo	Requerido	Descripción
`walletId`	string	Sí	UUID v4 de la wallet interna desde donde se hará el payout.
`destinationWallet`	string	Sí	Dirección de la wallet externa que recibirá el payout.
`amount`	string	Sí	Monto cripto positivo como string, con hasta 8 decimales.
`asset`	string	Sí	Asset que se enviará. Ejemplo: `USDC` o `USDT`.
`blockchain`	string	Sí	Blockchain del asset. Ejemplo: `Polygon` o `Ethereum`.
`externalReference`	string	Sí	Referencia única enviada por el partner para conciliación.

Probar en Sandbox

Usa estos parámetros como base para hacer una prueba en sandbox:

Parámetro	Valor de prueba	Notas
`baseUrl`	`https://sandbox-rampa.mesadepagos.com/api`	URL base del ambiente sandbox.
`token`	`<TOKEN>`	Reemplazar por el JWT obtenido en login.
`walletId`	`550e8400-e29b-41d4-a716-446655440000`	Reemplazar por una wallet real del tenant.
`destinationWallet`	`0x0000000000000000000000000000000000000000`	Wallet externa destino.
`amount`	`100`	Monto crypto a enviar.
`asset`	`USDC`	También puede ser `USDT`.
`blockchain`	`Polygon`	También puede ser `Ethereum`.
`externalReference`	`9dd9614e-5059-4cb5-826c-ef092fd99cb9`	Debe ser único por operación.

curl --request POST 'https://sandbox-rampa.mesadepagos.com/api/v3/transactions/payouts/crypto' \
  --header 'Authorization: Bearer <TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
    "walletId": "550e8400-e29b-41d4-a716-446655440000",
    "destinationWallet": "0x0000000000000000000000000000000000000000",
    "amount": "100",
    "asset": "USDC",
    "blockchain": "Polygon",
    "externalReference": "9dd9614e-5059-4cb5-826c-ef092fd99cb9"
  }'

Response

{
  "transactionId": "550e8400-e29b-41d4-a716-446655440001",
  "walletId": "550e8400-e29b-41d4-a716-446655440000",
  "destinationWallet": "0x0000000000000000000000000000000000000000",
  "amount": "100",
  "asset": "USDC",
  "blockchain": "Polygon",
  "externalReference": "9dd9614e-5059-4cb5-826c-ef092fd99cb9",
  "status": "pending_transaction",
  "message": "Payout crypto created"
}

Consideraciones

walletId debe corresponder a una wallet existente del partner autenticado.
destinationWallet debe pertenecer a la misma blockchain enviada en el request.
Usa un externalReference único por operación para conciliación.

El destino debe ser una dirección EVM válida (0x seguido de 40 caracteres hexadecimales). La wallet de origen debe estar activa y tener el asset seleccionado configurado en la blockchain solicitada. Reemplaza los identificadores y la dirección del ejemplo por valores reales de tu ambiente. Un request exitoso devuelve HTTP 201 con status: "pending_transaction"; esto no confirma la liquidación. Los cambios de estado final llegan mediante una notificación withdrawal_crypto. Consulta los webhooks de transacciones cripto y la referencia API de Payout Crypto.

​Endpoint

​Headers

​Crear Payout Crypto

​Request

​Campos

​Probar en Sandbox

​Response

​Consideraciones