v3.0 — Abril 2026
Pagotronic API
Documentation
API REST para integrar servicios de transferencia de dinero, cotizaciones, gestión de beneficiarios y envío de fondos a nivel global.
🌐URLs Base
Dos entornos disponibles. Sandbox para desarrollo, Producción para operaciones reales.
Sandboxhttps://dev.pagotronic.com/api/v3/
Producciónhttps://secure.pagotronic.com/api/v3/
🔄Flujo de integración
El flujo completo para enviar dinero a través de la API.
1
Auth
/auth
2
Countries
/countries
3
Banks
/banks
4
Fields
/fields
5
Beneficiary
/manage_beneficiary
6
Quote
/quotes
7
Send
/send_money
⚠️Códigos de respuesta
Estructura estándar: cod / msj / reg / tot
000Operación exitosa
001Credenciales inválidas
002Token expirado
003Parámetros incompletos
004Error de validación
500Error interno
🔑Auth
Obtiene el token JWT necesario para consumir todos los demás endpoints. Credenciales proporcionadas por Pagotronic.
POST/api/v3/authAutenticación
Request
| Parámetro | Tipo | Descripción |
|---|---|---|
| codereq | string | Código del servicio: "remesas" |
| keyreq | string | API Key proporcionada por Pagotronic |
| languagereq | string | "en" o "es" |
| emailreq | string | Email del usuario registrado |
| passwordreq | string | Contraseña del usuario |
Request
{
"code": "remesas",
"key": "aed133fb604b113906febfa...",
"language": "en",
"email": "USUARIO@EJEMPLO.COM",
"password": "Clave01*"
}Response — 000
{
"cod": "000",
"msj": "Successful login!",
"reg": "eyJhbGciOiJIUzI1NiIs...",
"tot": null
}ℹ️
reg contiene el token JWT. Inclúyelo en el header Authorization: Bearer {token} en todas las peticiones.🌍Countries
Obtiene la lista de países disponibles para envío de dinero.
POST/api/v3/countriesPaíses disponibles
| Parámetro | Tipo | Descripción |
|---|---|---|
| languagereq | string | "en" o "es" |
Request
{
"language": "en"
}🏦Banks
Obtiene la lista de bancos disponibles para un país específico.
POST/api/v3/banksBancos por país
| Parámetro | Tipo | Descripción |
|---|---|---|
| countryreq | string | Código ISO del país. Ej: "COL", "VEN", "USA" |
| languagereq | string | "en" o "es" |
Request
{
"country": "COL",
"language": "es"
}📝Fields
Obtiene los campos requeridos para registrar un beneficiario según país, banco y tipo de transacción.
POST/api/v3/fieldsCampos dinámicos
| Parámetro | Tipo | Descripción |
|---|---|---|
| countryreq | string | Código ISO del país. Ej: "VEN", "USA", "CHL" |
| bankreq | string | ID del banco (del endpoint banks). Vacío "" si no aplica. |
| languagereq | string | "en" o "es" |
| transferTypeopc | string | Tipo de transferencia. Ej: "Transferencia bancaria" |
| transactionTypeopc | string | Tipo de transacción. Ej: "FED_NOW" (para USA) |
Request — Venezuela
{
"country": "VEN",
"bank": "19",
"language": "es"
}Request — USA (FedNow)
{
"country": "USA",
"bank": "",
"transactionType": "FED_NOW",
"language": "es"
}👤Manage Beneficiary
Registra un nuevo beneficiario con los campos obtenidos del endpoint /fields.
POST/api/v3/manage_beneficiaryCrear beneficiario
| Parámetro | Tipo | Descripción |
|---|---|---|
| bankreq | string | ID del banco. Vacío "" si no aplica. |
| targetCountryreq | string | Código ISO del país destino. Ej: "USA" |
| transactionTypeopc | string | Tipo de transacción. Ej: "FED_NOW" |
| nicknamereq | string | Alias para identificar al beneficiario |
| languagereq | string | "en" o "es" |
| fieldsreq | array | Array de objetos {name, value} según /fields |
Request
{
"bank": "",
"targetCountry": "USA",
"transactionType": "FED_NOW",
"nickname": "beneficiario1",
"language": "es",
"fields": [
{ "name": "beneficiary_first_name", "value": "Juan" },
{ "name": "beneficiary_last_name", "value": "Pérez" },
{ "name": "beneficiary_email", "value": "juan@ejemplo.com" },
{ "name": "beneficiary_address", "value": "174th st" },
{ "name": "beneficiary_document_type", "value": "DNI" },
{ "name": "beneficiary_document_number", "value": "123456789" },
{ "name": "account_type_bank", "value": "Checking" },
{ "name": "account_bank", "value": "362364563521" },
{ "name": "routing_number", "value": "063100277" }
]
}✏️Update Beneficiary
Actualiza los datos de un beneficiario existente.
PATCH/api/v3/manage_beneficiaryActualizar beneficiario
| Parámetro | Tipo | Descripción |
|---|---|---|
| idreq | string | ID del beneficiario a actualizar |
| languagereq | string | "en" o "es" |
| fieldsreq | array | Array de {name, value, label} con los campos a actualizar |
Request
{
"id": "1246",
"language": "es",
"fields": [
{ "name": "beneficiary_first_name", "value": "PEDRO", "label": null },
{ "name": "beneficiary_last_name", "value": "VIVAS", "label": null },
{ "name": "account_bank", "value": "888888888899", "label": null }
]
}👥Beneficiaries
Lista los beneficiarios registrados. Envía id vacío para obtener todos, o con un ID específico para consultar uno.
POST/api/v3/beneficiariesListar / Consultar
| Parámetro | Tipo | Descripción |
|---|---|---|
| idreq | string | ID del beneficiario. Vacío "" para listar todos. |
| languagereq | string | "en" o "es" |
Request — Listar todos
{
"id": "",
"language": "es"
}Request — Uno específico
{
"id": "1170",
"language": "es"
}💱Quotes
Obtiene una cotización de tipo de cambio y comisiones para un envío.
POST/api/v3/quotesCotización
| Parámetro | Tipo | Descripción |
|---|---|---|
| targetCountryreq | string | Código ISO del país destino. Ej: "USA", "CHL" |
| targetCurrencyreq | string | Moneda destino ISO. Ej: "USD", "CLP" |
| quoteAmountreq | number | Monto a enviar en USD |
| languagereq | string | "en" o "es" |
Request
{
"targetCountry": "USA",
"targetCurrency": "USD",
"quoteAmount": 60,
"language": "es"
}ℹ️
La respuesta incluye un
quoteid (UUID) que debes usar en el endpoint /send_money.💸Send Money
Ejecuta el envío de dinero usando una cotización vigente y un beneficiario registrado.
POST/api/v3/send_moneyEnviar dinero
| Parámetro | Tipo | Descripción |
|---|---|---|
| countryreq | string | País destino. Ej: "USA" |
| languagereq | string | "en" o "es" |
| quoteidreq | string | UUID de la cotización obtenida de /quotes |
| idbeneficiaryreq | string | ID del beneficiario registrado |
| purposereq | string | Propósito del envío. Ej: "EPREMT" |
| purpose_comentaryreq | string | Comentario descriptivo del envío |
Request
{
"country": "USA",
"language": "en",
"quoteid": "34285889-d285-4900-a9f2-f1be46ab770c",
"idbeneficiary": "1170",
"purpose": "EPREMT",
"purpose_comentary": "Envío de prueba"
}⚠️
El
quoteid tiene vigencia limitada. Si expira, debes solicitar una nueva cotización antes de enviar.📊Transactions
Consulta el estado y detalles de una transacción específica.
POST/api/v3/transactionsConsultar transacción
| Parámetro | Tipo | Descripción |
|---|---|---|
| paymentidreq | string | UUID del pago retornado por /send_money |
| languagereq | string | "en" o "es" |
Request
{
"paymentid": "cb7d44c0-e388-44f7-b016-643a752bb680",
"language": "en"
}🎧Soporte técnico
¿Necesitas ayuda con la integración?