Documentación › API v3 › Introducción

Pagotronic API

La API REST de Pagotronic permite integrar de forma segura y escalable servicios de transferencias internacionales, cotizaciones en tiempo real, gestión de beneficiarios y envío global de fondos.
La plataforma opera mediante solicitudes JSON sobre HTTPS, utilizando autenticación basada en tokens JWT y respuestas estandarizadas para facilitar una integración rápida, confiable y consistente con aplicaciones web, móviles y sistemas empresariales.

⚡

Tiempo real

Procesamiento 24/7 incluyendo fines de semana y feriados.

🌎

50+ países

Cobertura global con conexión directa a redes locales como FedNow.

🛡️

Compliance

Screening AML automático en cada transacción.

🎨

White-label

Personaliza la experiencia bajo tu propia marca.

Entornos

Dos entornos aislados. Valida tu integración en sandbox antes de promover a producción.

Sandbox

https://dev.pagotronic.com/api/v3/

Producción

https://secure.pagotronic.com/api/v3/

Flujo de integración

Secuencia recomendada para enviar dinero a través de la API:

Auth

/auth

Countries

/countries

Banks

/banks

Fields

/fields

Beneficiary

/manage_beneficiary

Quote

/quotes

Send

/send_money

Autenticación

Todos los endpoints (excepto /auth) requieren un token JWT en el header Authorization. El token lo obtienes desde /auth y debe incluirse con el prefijo Bearer.

Header	Descripción
Authorizationreq	`Bearer eyJhbGciOiJIUzI1NiIs...` — token devuelto por `/auth` en el campo `reg`.
Content-Typereq	`application/json`

Códigos de respuesta

Todas las respuestas devuelven la misma estructura: cod / msj / reg / tot.

000 — Operación exitosa

001 — Credenciales inválidas

002 — Token expirado

003 — Parámetros incompletos

004 — Error de validación

500 — Error interno

Auth

Obtiene el token JWT necesario para consumir todos los demás endpoints. Las credenciales (code, key, email, password) son entregadas por Pagotronic al activar tu cuenta de sandbox.

POST/api/v3/auth

Request body

Parámetro	Descripción
codereqstring	Código del servicio. Ej: `"remesas"`.
keyreqstring	API Key entregada por Pagotronic.
languagereqstring	`"en"` o `"es"`.
emailreqstring	Email del usuario registrado.
passwordreqstring	Contraseña del usuario.

ℹ️

El token devuelto en reg tiene vigencia limitada. Renuévalo cuando recibas cod: "002".

cURL

JSON

RequestPOST /auth

{
  "code": "remesas",
  "key": "aed133fb604b113906febfa...",
  "language": "en",
  "email": "USUARIO@EJEMPLO.COM",
  "password": "Clave01*"
}

Response · 200

{
  "cod": "000",
  "msj": "Successful login!",
  "reg": "eyJhbGciOiJIUzI1NiIs...",
  "tot": null
}

Countries

Devuelve el catálogo de países habilitados para envío de dinero. Usa los códigos ISO devueltos como entrada de los siguientes endpoints (banks, fields, manage_beneficiary).

POST/api/v3/countries

Request body

Parámetro	Descripción
languagereqstring	`"en"` o `"es"`.

JSON

RequestPOST /countries

{
  "language": "en"
}

Response · 200

{
  "cod": "000",
  "msj": "OK",
  "reg": [
    { "iso": "USA", "name": "United States" },
    { "iso": "COL", "name": "Colombia" },
    { "iso": "VEN", "name": "Venezuela" },
    { "iso": "CHL", "name": "Chile" }
  ],
  "tot": 4
}

Banks

Lista los bancos disponibles para un país específico. El id del banco será requerido al crear un beneficiario en países donde aplique transferencia bancaria tradicional.

POST/api/v3/banks

Request body

Parámetro	Descripción
countryreqstring	Código ISO del país. Ej: `"COL"`, `"VEN"`, `"USA"`.
languagereqstring	`"en"` o `"es"`.

JSON

RequestPOST /banks

{
  "country": "COL",
  "language": "es"
}

Response · 200

{
  "cod": "000",
  "reg": [
    { "id": "19", "name": "Bancolombia" },
    { "id": "23", "name": "Banco Bogotá" },
    { "id": "31", "name": "Davivienda" }
  ]
}

Fields

Devuelve los campos requeridos para registrar un beneficiario, en función del país de destino, banco y tipo de transacción. Renderiza dinámicamente este formulario en tu UI — los campos pueden cambiar sin previo aviso.

POST/api/v3/fields

Request body

Parámetro	Descripción
countryreqstring	Código ISO del país. Ej: `"VEN"`, `"USA"`, `"CHL"`.
bankreqstring	ID del banco. Vacío `""` si no aplica (ej. transacciones FedNow USA).
languagereqstring	`"en"` o `"es"`.
transferTypeopcstring	Tipo de transferencia. Ej: `"Transferencia bancaria"`.
transactionTypeopcstring	Tipo de transacción. Ej: `"FED_NOW"` (USA).

Venezuela

USA · FedNow

RequestPOST /fields

{
  "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 de /fields. Cada beneficiario se identifica con un id que se reutiliza al crear envíos.

POST/api/v3/manage_beneficiary

Request body

Parámetro	Descripción
bankreqstring	ID del banco. Vacío `""` si no aplica.
targetCountryreqstring	Código ISO del país destino.
transactionTypeopcstring	Tipo de transacción. Ej: `"FED_NOW"`.
nicknamereqstring	Alias para identificar al beneficiario.
languagereqstring	`"en"` o `"es"`.
fieldsreqarray	Array de objetos `{name, value}` según los devueltos por `/fields`.

Body

RequestPOST /manage_beneficiary

{
  "bank": "",
  "targetCountry": "USA",
  "transactionType": "FED_NOW",
  "nickname": "fednow2",
  "language": "es",
  "fields": [
    { "name": "beneficiary_first_name",
      "value": "Enrique" },
    { "name": "beneficiary_last_name",
      "value": "Larez" },
    { "name": "beneficiary_email",
      "value": "user@example.com" },
    { "name": "beneficiary_address",
      "value": "174th st" },
    { "name": "beneficiary_document_type",
      "value": "DNI" },
    { "name": "beneficiary_document_number",
      "value": "734682736872" },
    { "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. Solo necesitas enviar los campos que deseas modificar.

PATCH/api/v3/manage_beneficiary

Request body

Parámetro	Descripción
idreqstring	ID del beneficiario a actualizar.
languagereqstring	`"en"` o `"es"`.
fieldsreqarray	Array de objetos `{name, value, label}` con los campos a actualizar.

Body

RequestPATCH /manage_beneficiary

{
  "id": "1246",
  "language": "es",
  "fields": [
    { "name": "beneficiary_first_name",
      "value": "PEDRO",
      "label": null },
    { "name": "beneficiary_last_name",
      "value": "VIVAS",
      "label": null },
    { "name": "beneficiary_email",
      "value": "PRUEBAS@EJEMPLO.COM",
      "label": null },
    { "name": "beneficiary_address",
      "value": "COLOMBIA",
      "label": null },
    { "name": "city",
      "value": "BOGOTA",
      "label": null },
    { "name": "phone",
      "value": "04122963999",
      "label": null }
  ]
}

Beneficiaries

Consulta los beneficiarios registrados. Envía id vacío para listar todos, o un ID específico para obtener el detalle de uno.

POST/api/v3/beneficiaries

Request body

Parámetro	Descripción
idreqstring	ID del beneficiario. Vacío `""` para listar todos.
languagereqstring	`"en"` o `"es"`.

Por ID

Listar todos

RequestPOST /beneficiaries

{
  "id": "1170",
  "language": "es"
}

Request — Listar todos

{
  "id": "",
  "language": "es"
}

Quotes

Obtiene una cotización del tipo de cambio para un envío. La respuesta incluye un quoteid (UUID) que debes pasar al endpoint /send_money.

POST/api/v3/quotes

Request body

Parámetro	Descripción
targetCountryreqstring	Código ISO del país destino.
targetCurrencyreqstring	Moneda destino ISO. Ej: `"USD"`, `"CLP"`.
quoteAmountreqnumber	Monto a enviar en USD.
languagereqstring	`"en"` o `"es"`.

ℹ️

El id tiene vigencia limitada. Si expira, solicita una nueva cotización antes de enviar.

JSON

RequestPOST /quotes

{
  "targetCountry": "USA",
  "targetCurrency": "USD",
  "quoteAmount": 60,
  "language": "es"
}

Response · 200

{
  "cod": "000",
   "msj": "",
  "reg": {
    "id": "e5f9f7d8-d521-4858-98e4-ef114d2a8bbd",
    "createdAt": 2025-05-01T12:51:10,112Z,
    "expiresAt": 2025-05-01T12:51:10,114Z,
    "sourceCurrency": USD,
    "targetCurrency": USD,
    "targetCountry": "USA"
    "amount": "60"
    "fxRate": "1"
  }
}

Send Money

Ejecuta el envío usando una cotización vigente y un beneficiario registrado. Devuelve un paymentid (UUID) usado para consultar el estado en /transactions .Los motivos estan listados en el método de fields.

POST/api/v3/send_money

Request body

Parámetro	Descripción
countryreqstring	País destino. Ej: `"USA"`.
languagereqstring	`"en"` o `"es"`.
quoteidreqstring	UUID de la cotización obtenida de `/quotes`.
idbeneficiaryreqstring	ID del beneficiario registrado.
purposereqstring	Código de propósito del envío. Ej: `"EPREMT"`.
purpose_comentaryreqstring	Comentario descriptivo del envío.

⚠️

Una vez ejecutado el envío no puede ser cancelado. Se debe confirmar monto y los datos del beneficiario antes de llamar este endpoint.

JSON

FedNow

RequestPOST /send_money

{
  "country": "USA",
  "language": "en",
  "quoteid": "34285889-d285-4900-a9f2-f1be46ab770c",
  "idbeneficiary": "1170",
  "purpose": "EPREMT",
  "purpose_comentary": "Envío de prueba"
}

Response · 200

{
  "cod": "000",
  "msj": "Payment processed",
  "reg": {
    "paymentid": "cb7d44c0-e388-44f7-b016-643a752bb680",
    "status": "pending"
  }
}

Transactions

Consulta el estado y los detalles de una transacción específica usando el paymentid devuelto por /send_money.

POST/api/v3/transactions

Request body

Parámetro	Descripción
paymentidreqstring	UUID del pago retornado por `/send_money`.
languagereqstring	`"en"` o `"es"`.

JSON

RequestPOST /transactions

{
  "paymentid": "cb7d44c0-e388-44f7-b016-643a752bb680",
  "language": "en"
}

Response · 200

{
  "cod": "000",
  "reg": {
    "paymentid": "cb7d44c0-e388-44f7-b016-643a752bb680",
    "status": "completed",
    "amount": 60,
    "currency": "USD",
    "beneficiary": "Enrique Larez",
    "createdAt": "2026-04-12T13:46:28Z",
    "completedAt": "2026-04-12T13:46:31Z"
  }
}

Soporte técnico

¿Necesitas ayuda con la integración? Nuestro equipo técnico responde en menos de 24 horas.

📧

Email

info@pagotronic.com
Respuesta <24h

💬

+1 (305) 570-6436
Lun–Vie 9am–6pm EST

🚀

Solicitar acceso

Credenciales sandbox
Activación en 1 día hábil

Pagotronic API

Tiempo real

50+ países

Compliance

White-label

Entornos

Flujo de integración

Autenticación

Códigos de respuesta

Auth

Request body

Countries

Request body

Banks

Request body

Fields

Request body

Manage Beneficiary

Request body

Update Beneficiary

Request body

Beneficiaries

Request body

Quotes

Request body

Send Money

Request body

Transactions

Request body

Soporte técnico

Email

WhatsApp

Solicitar acceso