Open Banking Gateway
Solo sandbox

Monedero móvil · Bangladés

Nagad Customer API

Monedero personal Nagad (Bangladés) — login con PIN + OTP por SMS con un paso opcional de cambio de dispositivo *167#, saldo, historial paginado y detalle de transacciones, validación del destinatario, vista previa de comisiones, envío de dinero P2P y mantenimiento de aprovisionamiento/renovación de credenciales.

12 endpointsSandbox gratuito

Sandbox · Solicitud

curl · POST /login/request-otp
curl -X POST 'https://www.openbankinggateway.com/api/sandbox/nagad-customer/login/request-otp' \
  -H 'Content-Type: application/json' \
  --data '{
  "account": "01900000002",
  "pinCode": "1234"
}'

Ejemplo ilustrativo del sandbox. No se contacta al proveedor, se envían SMS, se mueven fondos ni se cobran créditos.

Referencia de la API

Conoce cada endpoint.

Los métodos, rutas y reglas provienen del mismo catálogo que usa la consola. Abre un endpoint para ver sus campos.

Autenticación del monedero

POST
/login/request-otp

Send the SMS OTP or signal the *167# device-change step

Solo sandbox

/api/sandbox/nagad-customer/login/request-otp

POST login/request-otp · Parámetro
ParámetroTipoReglas y envío
accountObligatoriostring

Cuerpo JSON

Usa un monedero autorizado. En modo real, su identidad debe vincularse a tu cuenta del sitio mediante el acceso al monedero.

  • Formato: ^01\d{9}$
pinCodeObligatoriostring

Cuerpo JSON

Sensible · nunca en URLs

  • Formato: ^\d{4,6}$
POST
/login/verify-ussd-otp

Submit the *167# device-change USSD code

Solo sandbox

/api/sandbox/nagad-customer/login/verify-ussd-otp

POST login/verify-ussd-otp · Parámetro
ParámetroTipoReglas y envío
accountObligatoriostring

Cuerpo JSON

Usa un monedero autorizado. En modo real, su identidad debe vincularse a tu cuenta del sitio mediante el acceso al monedero.

  • Formato: ^01\d{9}$
ussdOtpObligatoriostring

Cuerpo JSON

Sensible · nunca en URLs

  • Formato: ^\d{4,8}$
POST
/login/verify-otp

Verify the OTP and issue a session token

Solo sandbox

/api/sandbox/nagad-customer/login/verify-otp

POST login/verify-otp · Parámetro
ParámetroTipoReglas y envío
accountObligatoriostring

Cuerpo JSON

Usa un monedero autorizado. En modo real, su identidad debe vincularse a tu cuenta del sitio mediante el acceso al monedero.

  • Formato: ^01\d{9}$
otpObligatoriostring

Cuerpo JSON

Sensible · nunca en URLs

  • Formato: ^\d{4,8}$
uidOpcionalstring

Cuerpo JSON

  • Formato: ^[A-Za-z0-9_-]{1,64}$

Cuenta y actividad

GET
/balance

Wallet balance

Solo sandbox

/api/sandbox/nagad-customer/balance

GET balance · Parámetro
ParámetroTipoReglas y envío
tokenObligatoriostring

Enviar en X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

Sensible · nunca en URLs

  • Formato: ^[A-Za-z0-9._~+/=-]{8,512}$
GET
/transaction-history

Paged transaction history

Solo sandbox

/api/sandbox/nagad-customer/transaction-history

GET transaction-history · Parámetro
ParámetroTipoReglas y envío
tokenObligatoriostring

Enviar en X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

Sensible · nunca en URLs

  • Formato: ^[A-Za-z0-9._~+/=-]{8,512}$
pageOpcionalinteger

Parámetro de consulta

  • Rango: 0 … 1000
GET
/transaction-detail

Single transaction detail

Solo sandbox

/api/sandbox/nagad-customer/transaction-detail

GET transaction-detail · Parámetro
ParámetroTipoReglas y envío
tokenObligatoriostring

Enviar en X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

Sensible · nunca en URLs

  • Formato: ^[A-Za-z0-9._~+/=-]{8,512}$
txnIdObligatoriostring

Parámetro de consulta

  • Formato: ^[A-Za-z0-9]{4,32}$
approvalDateObligatoriostring

Parámetro de consulta

  • Formato: ^\d{8}$

Transferencias

GET
/validate-account

Check that a recipient is a registered wallet

Solo sandbox

/api/sandbox/nagad-customer/validate-account

GET validate-account · Parámetro
ParámetroTipoReglas y envío
tokenObligatoriostring

Enviar en X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

Sensible · nunca en URLs

  • Formato: ^[A-Za-z0-9._~+/=-]{8,512}$
destMobileObligatoriostring

Parámetro de consulta

  • Formato: ^01\d{9}$
GET
/fee-commission

Preview fee, commission and net amount for a transfer

Solo sandbox

/api/sandbox/nagad-customer/fee-commission

GET fee-commission · Parámetro
ParámetroTipoReglas y envío
tokenObligatoriostring

Enviar en X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

Sensible · nunca en URLs

  • Formato: ^[A-Za-z0-9._~+/=-]{8,512}$
destMobileObligatoriostring

Parámetro de consulta

  • Formato: ^01\d{9}$
amountObligatoriodecimal

Parámetro de consulta

  • Rango: 1 … ∞
  • Decimales: 2
txTypeOpcionalstring

Parámetro de consulta

  • Formato: ^[A-Z_]{2,32}$
POST
/p2p

P2P send-money to another Nagad wallet

Solo sandbox

/api/sandbox/nagad-customer/p2p

Solo simulación del sandbox. No se mueve dinero real; esta integración no tiene transferencias reales habilitadas.

POST p2p · Parámetro
ParámetroTipoReglas y envío
tokenObligatoriostring

Enviar en X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

Sensible · nunca en URLs

  • Formato: ^[A-Za-z0-9._~+/=-]{8,512}$
destAccountNoObligatoriostring

Cuerpo JSON

  • Formato: ^01\d{9}$
amountObligatoriodecimal

Cuerpo JSON

  • Rango: 1 … ∞
  • Decimales: 2
userRefMessageOpcionalstring

Cuerpo JSON

  • Longitud: 0 … 64

Mantenimiento de sesión

POST
/refresh-card-data

Provision or refresh P2P payment credentials

Solo sandbox

/api/sandbox/nagad-customer/refresh-card-data

POST refresh-card-data · Parámetro
ParámetroTipoReglas y envío
tokenObligatoriostring

Enviar en X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

Sensible · nunca en URLs

  • Formato: ^[A-Za-z0-9._~+/=-]{8,512}$
POST
/replenish-card

Refresh the transaction credential quota

Solo sandbox

/api/sandbox/nagad-customer/replenish-card

POST replenish-card · Parámetro
ParámetroTipoReglas y envío
tokenObligatoriostring

Enviar en X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

Sensible · nunca en URLs

  • Formato: ^[A-Za-z0-9._~+/=-]{8,512}$
POST
/reinitialize-wallet

Re-provision an existing session for P2P

Solo sandbox

/api/sandbox/nagad-customer/reinitialize-wallet

POST reinitialize-wallet · Parámetro
ParámetroTipoReglas y envío
tokenObligatoriostring

Enviar en X-OBG-Token

Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs.

Sensible · nunca en URLs

  • Formato: ^[A-Za-z0-9._~+/=-]{8,512}$

Los identificadores y las descripciones específicas del proveedor se mantienen en inglés para coincidir con el contrato.

Probar en sandbox

Una solicitud que puedes examinar.

La consola empieza en sandbox. Usa solo los datos de prueba. Cambiar a Real modifica el destino y puede usar cuentas y fondos reales.

Sandbox

Separa las pruebas, el acceso a cuentas y la facturación.

De la primera solicitud a la conexión real.

  1. Explora sin iniciar sesión

    Elige una API y usa sus datos de prueba. Las respuestas simuladas no mueven dinero ni contactan con un banco.

  2. Crea tu cuenta de la plataforma

    Accede con Google, recibe 1.000 créditos y crea una clave API. Esto inicia sesión en el sitio, no en un monedero.

  3. Conecta cuando estés listo

    En las APIs con acceso real, completa el acceso al monedero por separado. Cada solicitud real exitosa cuesta un crédito; los fallos, ninguno.

1.000 créditos de bienvenida · sin tarjeta

Empieza poco. Coste claro.

10 USD compran 10.000 créditos. Una solicitud real exitosa usa uno; los fallos y el sandbox no consumen créditos. Comprar créditos no habilita integraciones solo sandbox.

Comprar 10.000 créditos

Guía de integración

Llévalo a tu código.

Los ejemplos de sandbox usan datos públicos. Los ejemplos reales usan marcadores: guarda las credenciales en tu servidor, nunca en el repositorio.

Sandbox

curl · POST
curl -X POST 'https://www.openbankinggateway.com/api/sandbox/nagad-customer/login/request-otp' \
  -H 'Content-Type: application/json' \
  --data '{
  "account": "01900000002",
  "pinCode": "1234"
}'

Solo sandbox

Acceso en vivo no habilitado

Contáctanos para habilitar el acceso

Las llamadas en vivo a Nagad Customer se habilitan por cliente. El modo Sandbox sigue siendo gratuito y no requiere iniciar sesión.

Límites claros antes de la primera solicitud.

Lo que conviene saber.

¿El sandbox usa cuentas reales?

No. Usa respuestas simuladas y credenciales públicas de prueba. No contacta proveedores financieros, envía códigos OTP ni mueve fondos.

¿Todas las APIs permiten solicitudes reales?

No. Solo las integraciones marcadas con acceso real tienen un proveedor conectado. Las demás son solo sandbox y devuelven LIVE_ACCESS_NOT_ENABLED en modo real. Contáctanos para consultar el acceso.

¿Cuándo se cobra un crédito?

Se cobra un crédito por llamada real exitosa. Los fallos y el sandbox son gratuitos. Consulta X-Credits-Charged, no solo el estado HTTP. Si aparece X-OBG-Settlement: unknown, el cobro no está resuelto: X-Credits-Charged: 0 no demuestra que no se haya descontado un crédito. Consulta el historial de uso y concilia antes de reintentar.

¿Acceder con Google conecta mi monedero?

No. Google gestiona tu cuenta del sitio, créditos y claves API. El acceso al monedero es un flujo separado para una integración compatible y una cuenta que tengas autorización para usar.

Sigue explorando.