Somente sandbox

Carteira móvel · Bangladesh

Nagad Customer API

Carteira pessoal Nagad (Bangladesh) — login com PIN + OTP por SMS com uma etapa opcional de troca de dispositivo *167#, saldo, histórico paginado e detalhe de transações, validação do destinatário, prévia de taxas, envio de dinheiro P2P e manutenção de provisionamento/renovação de credenciais.

Testar no sandbox Demonstração guiada (inglês)

12 endpointsSandbox gratuito

Sandbox · Requisição

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"
}'

Exemplo ilustrativo do sandbox. Nenhum provedor é contatado, SMS é enviado, valor é movimentado ou crédito é cobrado.

Referência da API

Conheça cada endpoint.

Métodos, rotas e regras vêm do mesmo catálogo usado pelo console. Abra um endpoint para ver seus campos.

Autenticação da carteira

POST

/login/request-otp

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

Somente sandbox

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

POST login/request-otp · Parâmetro
Parâmetro	Tipo	Regras e envio
`account`Obrigatório	string	Corpo JSON Use uma carteira autorizada. No modo real, a identidade deve estar vinculada à sua conta do site pelo login da carteira. Formato: `^01\d{9}$`
`pinCode`Obrigatório	string	Corpo JSON Sensível · nunca em URLs Formato: `^\d{4,6}$`

POST

/login/verify-ussd-otp

Submit the *167# device-change USSD code

Somente sandbox

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

POST login/verify-ussd-otp · Parâmetro
Parâmetro	Tipo	Regras e envio
`account`Obrigatório	string	Corpo JSON Use uma carteira autorizada. No modo real, a identidade deve estar vinculada à sua conta do site pelo login da carteira. Formato: `^01\d{9}$`
`ussdOtp`Obrigatório	string	Corpo JSON Sensível · nunca em URLs Formato: `^\d{4,8}$`

POST

/login/verify-otp

Verify the OTP and issue a session token

Somente sandbox

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

POST login/verify-otp · Parâmetro
Parâmetro	Tipo	Regras e envio
`account`Obrigatório	string	Corpo JSON Use uma carteira autorizada. No modo real, a identidade deve estar vinculada à sua conta do site pelo login da carteira. Formato: `^01\d{9}$`
`otp`Obrigatório	string	Corpo JSON Sensível · nunca em URLs Formato: `^\d{4,8}$`
`uid`Opcional	string	Corpo JSON Formato: `^[A-Za-z0-9_-]{1,64}$`

Conta e atividade

GET

/balance

Wallet balance

Somente sandbox

/api/sandbox/nagad-customer/balance

GET balance · Parâmetro
Parâmetro	Tipo	Regras e envio
`token`Obrigatório	string	Enviar em X-OBG-Token Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs. Sensível · nunca em URLs Formato: `^[A-Za-z0-9._~+/=-]{8,512}$`

GET

/transaction-history

Paged transaction history

Somente sandbox

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

GET transaction-history · Parâmetro
Parâmetro	Tipo	Regras e envio
`token`Obrigatório	string	Enviar em X-OBG-Token Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs. Sensível · nunca em URLs Formato: `^[A-Za-z0-9._~+/=-]{8,512}$`
`page`Opcional	integer	Parâmetro de consulta Intervalo: 0 … 1000

GET

/transaction-detail

Single transaction detail

Somente sandbox

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

GET transaction-detail · Parâmetro
Parâmetro	Tipo	Regras e envio
`token`Obrigatório	string	Enviar em X-OBG-Token Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs. Sensível · nunca em URLs Formato: `^[A-Za-z0-9._~+/=-]{8,512}$`
`txnId`Obrigatório	string	Parâmetro de consulta Formato: `^[A-Za-z0-9]{4,32}$`
`approvalDate`Obrigatório	string	Parâmetro de consulta Formato: `^\d{8}$`

Transferências

GET

/validate-account

Check that a recipient is a registered wallet

Somente sandbox

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

GET validate-account · Parâmetro
Parâmetro	Tipo	Regras e envio
`token`Obrigatório	string	Enviar em X-OBG-Token Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs. Sensível · nunca em URLs Formato: `^[A-Za-z0-9._~+/=-]{8,512}$`
`destMobile`Obrigatório	string	Parâmetro de consulta Formato: `^01\d{9}$`

GET

/fee-commission

Preview fee, commission and net amount for a transfer

Somente sandbox

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

GET fee-commission · Parâmetro
Parâmetro	Tipo	Regras e envio
`token`Obrigatório	string	Enviar em X-OBG-Token Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs. Sensível · nunca em URLs Formato: `^[A-Za-z0-9._~+/=-]{8,512}$`
`destMobile`Obrigatório	string	Parâmetro de consulta Formato: `^01\d{9}$`
`amount`Obrigatório	decimal	Parâmetro de consulta Intervalo: 1 … ∞ Casas decimais: 2
`txType`Opcional	string	Parâmetro de consulta Formato: `^[A-Z_]{2,32}$`

POST

/p2p

P2P send-money to another Nagad wallet

Somente sandbox

/api/sandbox/nagad-customer/p2p

Somente simulação do sandbox. Nenhum dinheiro real é movimentado; transferências reais não estão habilitadas para esta integração.

POST p2p · Parâmetro
Parâmetro	Tipo	Regras e envio
`token`Obrigatório	string	Enviar em X-OBG-Token Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs. Sensível · nunca em URLs Formato: `^[A-Za-z0-9._~+/=-]{8,512}$`
`destAccountNo`Obrigatório	string	Corpo JSON Formato: `^01\d{9}$`
`amount`Obrigatório	decimal	Corpo JSON Intervalo: 1 … ∞ Casas decimais: 2
`userRefMessage`Opcional	string	Corpo JSON Comprimento: 0 … 64

Manutenção de sessão

POST

/refresh-card-data

Provision or refresh P2P payment credentials

Somente sandbox

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

POST refresh-card-data · Parâmetro
Parâmetro	Tipo	Regras e envio
`token`Obrigatório	string	Enviar em X-OBG-Token Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs. Sensível · nunca em URLs Formato: `^[A-Za-z0-9._~+/=-]{8,512}$`

POST

/replenish-card

Refresh the transaction credential quota

Somente sandbox

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

POST replenish-card · Parâmetro
Parâmetro	Tipo	Regras e envio
`token`Obrigatório	string	Enviar em X-OBG-Token Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs. Sensível · nunca em URLs Formato: `^[A-Za-z0-9._~+/=-]{8,512}$`

POST

/reinitialize-wallet

Re-provision an existing session for P2P

Somente sandbox

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

POST reinitialize-wallet · Parâmetro
Parâmetro	Tipo	Regras e envio
`token`Obrigatório	string	Enviar em X-OBG-Token Session token from the login step. Prefer the X-OBG-Token header so it stays out of URLs. Sensível · nunca em URLs Formato: `^[A-Za-z0-9._~+/=-]{8,512}$`

Identificadores e descrições específicas do provedor são mantidos em inglês para corresponder ao contrato.

Testar no sandbox

Uma requisição que você pode examinar.

O console inicia no sandbox. Use apenas os valores públicos de teste. Mudar para Real altera o destino e pode usar contas e fundos reais.

Carregando…

Sandbox

Separe testes, acesso às contas e cobrança.

Da primeira requisição à conexão real.

Explore sem fazer login
Escolha uma API e use os valores de teste documentados. As simulações não movem dinheiro nem contatam bancos.
Crie sua conta na plataforma
Entre com Google, receba 1.000 créditos e crie uma chave API. Isso conecta você ao site, não a uma carteira.
Conecte quando estiver pronto
Nas APIs com acesso real, faça o login da carteira separadamente. Cada chamada real bem-sucedida custa um crédito; falhas não custam nada.

1.000 créditos de boas-vindas · sem cartão

Comece pequeno. Custo claro.

US$ 10 compram 10.000 créditos. Uma chamada real bem-sucedida usa um; falhas e sandbox não usam créditos. Comprar créditos não libera integrações somente sandbox.

Comprar 10.000 créditos

Guia de integração

Leve para o seu código.

Exemplos de sandbox usam valores públicos. Exemplos reais usam marcadores: mantenha credenciais no servidor e nunca as inclua no repositório.

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"
}'

Somente sandbox

Acesso ao vivo não habilitado

Fale conosco para liberar o acesso

As chamadas ao vivo para Nagad Customer são liberadas por cliente. O modo Sandbox continua gratuito e não exige login.

Fale com a gente no Telegram Página de contato

Limites claros antes da primeira requisição.

Algumas coisas que vale saber.

O sandbox usa contas reais?

Não. Usa respostas simuladas e credenciais públicas de teste. Não contata provedores financeiros, envia códigos OTP nem movimenta fundos.

Todas as APIs permitem chamadas reais?

Não. Apenas as integrações marcadas com acesso real têm um provedor conectado. As demais são somente sandbox e retornam LIVE_ACCESS_NOT_ENABLED no modo real. Fale conosco sobre o acesso.

Quando um crédito é cobrado?

Um crédito é cobrado por chamada real bem-sucedida. Falhas e sandbox são gratuitos. Consulte X-Credits-Charged, não apenas o status HTTP. Se houver X-OBG-Settlement: unknown, a cobrança está indefinida: X-Credits-Charged: 0 não comprova que nenhum crédito foi debitado. Consulte o histórico de uso e concilie antes de tentar novamente.

Entrar com Google conecta minha carteira?

Não. O Google gerencia sua conta do site, créditos e chaves API. O login da carteira é um fluxo separado para uma integração compatível e uma conta que você tenha autorização para usar.

Nagad Customer API

Conheça cada endpoint.

Autenticação da carteira

Conta e atividade

Transferências

Manutenção de sessão

Uma requisição que você pode examinar.

Da primeira requisição à conexão real.

Explore sem fazer login

Crie sua conta na plataforma

Conecte quando estiver pronto

Comece pequeno. Custo claro.

Leve para o seu código.

Sandbox

Somente sandbox

Algumas coisas que vale saber.

Continue explorando.

EasyPaisa (Phoenix)

ACB ONE

slice Business