Wire outs
Conoce cómo realizar una operación de wire out de forma segura
Esta guía describe cómo crear un wire out internacional en USD y consultar su estado durante el procesamiento.
Genera un wire out
A través de nuestro endpoint para wire out, podrás solicitar una transferencia internacional en USD desde tu cuenta interna hacia un beneficiario previamente registrado en ProntoPaga.
Al enviar la solicitud con los datos requeridos, recibirás inmediatamente un identificador único del wire out y un estado inicial de procesamiento, lo que te permite iniciar la remesa de fondos de manera segura y realizar el seguimiento de su resultado final.
Esta operación garantiza la trazabilidad de la solicitud y confirma que la instrucción ha sido aceptada para su procesamiento, sin implicar que la transferencia ya se haya ejecutado.
Ejemplo
A continuación, puedes ver un ejemplo del body de la solicitud.
{
"accountNumber": "12345678902345",
"amount": 1000,
"note": "WIRE OUT",
"referenceId": "574839458743652",
"settlementAccountId": "234578987654345678"
}Respuesta
Si tu solicitud se realiza correctamente, recibirás una respuesta similar a la que se muestra a continuación.
{
"accountNumber": "12345678902345",
"amount": 1000,
"currency": "USD",
"referenceId": "574839458743652",
"settlementAccountId": "234578987654345678",
"status": "in_progress",
"wireOutId": "fe0f96ff-95d4-4c18-97e3-99f72b8c7b20"
}
WebhooksConoce los detalles acerca de los webhooks para wire outs.
Detalles de un wire out
Este endpoint te permite consultar el detalle de un wire out específico que ya fue solicitado previamente mediante nuestro endpoint de generación de un wire out.
Respuesta
A continuación se muestra la respuesta que recibirás con los detalles del wire out solicitado.
{
"accountNumber": "12345678902345",
"amount": 1000,
"currency": "USD",
"referenceId": "574839458743652",
"settlementAccountId": "234578987654345678",
"status": "in_transit",
"statusMessage": "processing",
"updatedAt": "2026-04-17T05:47:25.028Z",
"wireOutId": "fe0f96ff-95d4-4c18-97e3-99f72b8c7b20"
}Detalles de un wire out por referenceId
referenceIdEste endpoint te permite consultar el detalle de un wire out específico que ya fue solicitado previamente mediante nuestro endpoint de generación de un wire out por su número de referenceId.
Respuesta
A continuación se muestra la respuesta que recibirás con los detalles del wire out consultado por referenceId.
{
"accountNumber": "12345678902345",
"amount": 1000,
"currency": "USD",
"referenceId": "574839458743652",
"settlementAccountId": "234578987654345678",
"status": "in_transit",
"statusMessage": "processing",
"updatedAt": "2026-04-17T05:47:25.028Z",
"wireOutId": "fe0f96ff-95d4-4c18-97e3-99f72b8c7b20"
}Estados
Las siguientes tablas muestran los estados de creación de un wire out y los posibles estados derivados de los endpoints de detalles de un wire out.
| Estado | Escenario |
|---|---|
received | Solicitud recibida y pendiente de revisión. |
in_transit | SWIFT asociado creado. El dinero está en camino a la cuenta del cliente. |
completed | Transferencia ejecutada y registrada. |
failed | La transferencia no pudo ejecutarse. El cliente debe reintentar el wire out. |
Respuestas
A continuación te mostramos las posibles respuestas que pueden derivarse de un wire out.
Respuestas de creación de un wire out
La siguiente tabla presenta las respuestas comunes que pueden derivarse de la creación de un wire out.
| Código | Descripción | Acción recomendada |
|---|---|---|
201 | Solicitud de wire out creada correctamente | - |
400 | Internal account not found or disabled | La cuenta interna en USD de origen no existe o está deshabilitada. |
400 | Invalid internal account currency | El wire out sale únicamente desde una cuenta interna en USD. Si no hubo FX previo, no hay saldo USD. |
400 | Invalid merchant settlement account | El settlementAccountId no existe o no está habilitado para el comercio. |
400 | Internal account hasn't enough funds to cover the refund | Saldo insuficiente en la cuenta interna del cliente. |
401 | Unauthorized | Token ausente, mal formado o expirado. Renovar con POST /auth/sign-in. |
409 | Wire out reference id already exists | referenceId duplicado. Ten en cuenta que el límite es de 15 caracteres para wire outs. |
500 | It is not possible to realize the action at this time | Operación no disponible en este momento. Reintentar; si persiste, escalar. |
504 | Endpoint request timed out | Reintenta la solicitud. Si el problema persiste, contacta al soporte de ProntoPaga. |
Respuestas de detalles de un wire out
Esta tabla muestra las respuestas que pueden derivarse de la consulta de detalle de un wire out.
| Código | Descripción | Acción recomendada |
|---|---|---|
200 | Consulta exitosa | - |
401 | Unauthorized | Token ausente, mal formado o expirado. Renovar con POST /auth/sign-in . |
404 | Wire out not found | wireOutId inexistente. Reintentar con un wireOutId válido. |
504 | Endpoint request timed out | Reintenta la solicitud. Si el problema persiste, contacta al soporte de ProntoPaga. |
Respuestas de detalles de un wire out por referenceId
referenceIdEsta tabla muestra las respuestas que pueden derivarse de la consulta de detalle de un wire out por referenceId.
| Código | Descripción | Acción recomendada |
|---|---|---|
200 | Consulta exitosa | - |
401 | Unauthorized | Token ausente, mal formado o expirado. Renovar con POST /auth/sign-in . |
404 | Wire out not found | referenceId inexistente. Reintentar con un referenceId válido. |
504 | Endpoint request timed out | Reintenta la solicitud. Si el problema persiste, contacta al soporte de ProntoPaga. |
Updated 8 days ago