> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mesadepagos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payout Crypto

> Envío de payouts desde una wallet interna hacia una wallet externa.

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](https://docs.mesadepagos.com/v3/auth.md). Consulta la wallet de origen y sus assets configurados en [Wallets v3](https://docs.mesadepagos.com/v3/wallet.md).

## Endpoint

```http theme={null}
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

```json theme={null}
{
  "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. |

```bash theme={null}
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

```json theme={null}
{
  "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](https://docs.mesadepagos.com/v3/webhooks.md#payloads-de-transacciones-cripto) y la [referencia API de Payout Crypto](https://docs.mesadepagos.com/v3/api-reference/payout/payout-crypto.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.