Empieza con seguridad. Conecta con intención.

Elige la integración y revisa su disponibilidad. Todas tienen sandbox con datos simulados; solo hay endpoints reales cuando el catálogo lo indica. Las rutas API no se traducen.

URL base del sandbox

https://www.openbankinggateway.com/api/sandbox

URL base real

https://www.openbankinggateway.com/api/v1

La consola usa rutas relativas /api/sandbox del mismo origen. El servicio anónimo no necesita Google, clave API, cuenta de monedero ni créditos. No es un proxy de navegador entre orígenes: ejecuta los ejemplos en este sitio o usa un cliente HTTP de servidor.

Usa solo las identidades y credenciales de prueba de las páginas y la consola. Las transferencias son simuladas, no se envían SMS y sus tokens no sirven en modo real.

const response = await fetch('/api/sandbox/bkash-agent/login/request-otp', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    account: '01700000001',
    phoneOperator: 'Grameenphone'
  })
});
const result = await response.json();

curl -X POST 'https://www.openbankinggateway.com/api/sandbox/bkash-agent/login/request-otp' \
  -H 'Content-Type: application/json' \
  --data '{
  "account": "01700000001",
  "phoneOperator": "Grameenphone"
}'

Para solicitudes reales entre servidores, accede al sitio, crea una clave en Panel → Claves API y envíala en x-api-key. Nunca la expongas en JavaScript del navegador, URLs o repositorios públicos. Solo funcionan las integraciones reales compatibles.

curl 'https://www.openbankinggateway.com/api/v1/bkash-agent/balance?account=<YOUR_WALLET_NUMBER>' \
  -H "x-api-key: $OBG_API_KEY" \
  -H "X-OBG-Token: $WALLET_TOKEN"

Google autentica tu cuenta de Open Banking Gateway y da acceso a créditos, claves y cobro. No te conecta a bKash ni a otro monedero. Completa el flujo del monedero por separado con una cuenta autorizada.

Las sesiones reales de bKash se vinculan a tu cuenta del sitio tras acceder al monedero. Otro usuario no puede apropiarse de ese vínculo. Guarda el token de forma segura y vuelve a autenticarte al caducar.

1. 1POST /login/request-otp
2. 2POST /login/verify-otp

curl -X POST 'https://www.openbankinggateway.com/api/v1/bkash-agent/login/verify-otp' \
  -H "x-api-key: $OBG_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "account": "<YOUR_WALLET_NUMBER>",
    "pin": "<WALLET_PIN>",
    "otp": "<SMS_OTP>",
    "otpHash": "<SMS_HASH>"
  }'

Envía el token del monedero en X-OBG-Token. Envía PIN, contraseñas, OTP y otpHash en el cuerpo JSON de los POST con Content-Type: application/json. Existe compatibilidad por consulta, pero las URLs pueden filtrar secretos en historial, capturas, referencias o registros: evítala en nuevas integraciones.

Cada llamada real exitosa cuesta 1 crédito. Los fallos, incluidos los del proveedor, son gratis; el sandbox nunca consume créditos. Puede haber una retención temporal de 1 crédito mientras se procesa la llamada, que después se cobra o libera.

Tu primer acceso con Google concede 1.000 créditos una sola vez. Compra 10.000 por 10 USD, 50.000 por 50 USD o 100.000 por 100 USD. No caducan. Comprar créditos no habilita APIs solo sandbox.

Las respuestas usan {code, data}. El código de la plataforma, el estado HTTP y el estado interno del proveedor describen capas distintas: HTTP 200 o code 200 no prueban por sí solos el éxito de una operación. Revisa los campos específicos del proveedor. Un fallo interno del proveedor no se cobra, aunque el code externo sea 200. Una estructura de respuesta del proveedor no reconocida devuelve HTTP 502 con UPSTREAM_BAD_RESPONSE y es gratuita. No se garantiza un campo adicional de respuesta sin procesar.

{
  "code": 400,
  "data": {
    "error": "One or more parameters are missing or invalid.",
    "errorCode": "INVALID_PARAMS",
    "requestId": "<request-id>"
  }
}

X-Request-Id identifica la solicitud. Cuando la liquidación está confirmada, X-Credits-Charged es 1 para una llamada real exitosa cobrada y 0 para fallos o sandbox. X-OBG-Settlement: unknown indica que el resultado del cobro no está resuelto: X-Credits-Charged: 0 no demuestra que no se haya descontado un crédito. Guarda el ID, no credenciales, para diagnosticar problemas.

Los endpoints que mueven dinero requieren una Idempotency-Key única por operación. Mantén la misma clave al resolverla; no generes otra para repetir una transferencia incierta. La plataforma no reintenta automáticamente al proveedor.

Idempotency-Key: <original-operation-id>
X-Request-Id: <gateway-request-id>
X-Credits-Charged: 0
X-OBG-Settlement: unknown

El sandbox permite 60 solicitudes por minuto e IP. También hay límites reales y de cuenta. Ante 429, respeta Retry-After. Las lecturas tienen 25 segundos; accesos, escrituras y operaciones de dinero, hasta 45 segundos.

Cada página tiene los endpoints exactos, reglas y consola con sandbox por defecto. La disponibilidad depende del catálogo, no de comprar créditos.

• EasyPaisa (Phoenix)Pakistán
  Solo sandbox
• ACB ONEVietnam
  Solo sandbox
• slice BusinessIndia
  Solo sandbox
• bKash AgentBangladés
  Acceso real disponible
• Nagad UddoktaBangladés
  Solo sandbox
• Nagad CustomerBangladés
  Solo sandbox