Ir al contenido
Global66 Developers

Introducción

La API Transaccional de Global66 te permite iniciar, validar y ejecutar pagos B2B entre países desde tu propia plataforma. Esta sección reúne todo lo que necesitas para diseñar la integración, probarla en ambiente de pruebas y llevarla a producción con confianza.

Crea una transacción

Si integras por primera vez, usa v2.

Terminal

Usa esta versión en integraciones nuevas.

Eliges la cuenta de origen con walletId. 

curl --location 'https://api.global66.com/business-api/b2b/transactions/payments' \
  --header 'Authorization: <token>' \
  --header 'X-Api-Version: 2' \
  --form 'request=
{
  "externalReferenceId": "rem-bt-2026-0166",
  "transactionType": "REMITTANCE",
  "walletId": 2000177642,
  "amount": 300000,
  "way": "ORIGIN",
  "description": "Remesa a México",
  "paymentType": "WIRE_TRANSFER",
  "purposeCode": [{ "purposeCode": 64, "amount": 100.00 }],
  "beneficiary": {
    "operationType": "BANK_TRANSFER",
    "destinationCurrency": "MXN",
    "beneficiaryName": "Juan",
    "beneficiaryLastName": "Pérez",
    "typeBeneficiary": "INDIVIDUAL",
    "email": "beneficiary@example.com",
    "countryCode": "MX",
    "accountType": "SAVING",
    "bankId": 2427,
    "accountNumber": "002910001234567891",
    "documentNumber": "232323234",
    "documentType": "RUT"
  }
};type=application/json'

Camino rápido de integración

  1. Consigue tus credenciales

    Ingresa a la plataforma Empresas de Global66 y abre Integraciones API. Crea una nueva credencial, asígnale un nombre descriptivo y registra las IPs de egreso desde las que tu servidor llamará a la API. Solo se aceptan direcciones IPv4 válidas y puedes registrar hasta 20 IPs por credencial. Confirma la creación con el código OTP, y luego copia o descarga el clientId y el clientSecret. Consulta los detalles de credenciales.

  2. Obtén un token de acceso

    En producción, usa https://api.global66.com/business-api como URL base. Envía tu clientId y clientSecret a POST /b2b/auth para recibir un token y un refreshToken.

    Copiar código

    Cuando el token expire, renueva la sesión con POST /b2b/auth/refresh enviando el refreshToken, sin reenviar el clientSecret. El token se usa en las operaciones autenticadas. Más detalles en autenticación.

  3. Elige la ruta de pago

    Revisa Destinos para conocer los corredores disponibles (USD/COP, USD/MXN, EUR/ES, etc.), los métodos de pago aceptados y los montos mínimos y máximos.

  4. Arma y revisa el request

    Usa el Arma tu request para armar el JSON con los campos, sub-tipos de beneficiario y ejemplos por corredor, y consulta la pestaña Esquema de Esquemas y ejemplos para verificar que la estructura cumple con el contrato.

  5. Ejecuta la transacción

    Con el payload validado, llama a POST https://api.global66.com/business-api/b2b/transactions/payments para registrar la transacción. Usa el token recibido en el header Authorization.

    Elige la versión del API y copia el request desde Crea una transacción.

    La especificación completa y los ejemplos están en Esquemas y ejemplos; el editor interactivo para probar el payload está en Try It.

  6. Maneja errores y reintentos

    Antes de salir a producción, lee la guía de errores y reintentos para entender los códigos HTTP, la validación de negocio y la regla de idempotencia con externalReferenceId.

Recursos clave

Credenciales Estados, lista de IPs y soporte.
Autenticación Obtén y refresca tokens con /b2b/auth.
Destinos Catálogo de rutas, monedas y tipos de pago.
Arma tu request Genera el JSON y revisa la estructura con el helper de request.
Esquemas y ejemplos Esquema dinámico y ejemplos por corredor.
Try It Editor interactivo para probar el payload de validación.
Errores y reintentos Códigos HTTP, validación de negocio e idempotencia.

Soporte

Si necesitas ayuda para investigar un estado inesperado o una petición fallida, escríbenos a soporte.tech@global66.com indicando el clientId y un ejemplo de la petición fallida (timestamp, request id, status HTTP).