Open Banking Gateway
仅沙箱

代理钱包 · 孟加拉国

Nagad Uddokta API

Nagad Uddokta 代理/分销商钱包（孟加拉国）—— PIN + 短信 OTP 登录（含可选的 *167# 换设备步骤）、余额、交易历史与详情、账户/手续费查询、代理 Cash-In，以及沿分销树上下的 B2B 转账。

在沙箱中试用分步演示（英文）
12 个端点免费沙箱

沙箱 · 请求

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

沙箱示例：不联系服务商、不发送短信、不转移资金、不扣除积分。

API 参考文档

清楚了解可调用的接口。

请求方法、路径和参数规则与控制台使用同一份目录。展开端点即可查看请求字段。

钱包认证

POST
/login/request-otp

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

仅沙箱

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

POST login/request-otp · 参数
参数类型规则与传递方式
account必填string

JSON 请求体

请使用你有权访问的钱包。真实钱包身份须通过钱包登录关联到你的网站账户。

  • 格式: ^01\d{9}$
pinCode必填string

JSON 请求体

敏感字段 · 请勿放入 URL

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

Submit the *167# device-change USSD code

仅沙箱

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

POST login/verify-ussd-otp · 参数
参数类型规则与传递方式
account必填string

JSON 请求体

请使用你有权访问的钱包。真实钱包身份须通过钱包登录关联到你的网站账户。

  • 格式: ^01\d{9}$
ussdOtp必填string

JSON 请求体

敏感字段 · 请勿放入 URL

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

Verify the OTP and issue a session token

仅沙箱

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

POST login/verify-otp · 参数
参数类型规则与传递方式
account必填string

JSON 请求体

请使用你有权访问的钱包。真实钱包身份须通过钱包登录关联到你的网站账户。

  • 格式: ^01\d{9}$
otp必填string

JSON 请求体

敏感字段 · 请勿放入 URL

  • 格式: ^\d{4,8}$
uid可选string

JSON 请求体

  • 格式: ^[A-Za-z0-9_-]{1,64}$
POST
/login/verify-otp-sms

Verify the login from the raw SMS text

仅沙箱

/api/sandbox/nagad-uddokta/login/verify-otp-sms

POST login/verify-otp-sms · 参数
参数类型规则与传递方式
account必填string

JSON 请求体

请使用你有权访问的钱包。真实钱包身份须通过钱包登录关联到你的网站账户。

  • 格式: ^01\d{9}$
smsText必填string

JSON 请求体

敏感字段 · 请勿放入 URL

  • 长度: 1 … 500

账户与活动

GET
/balance

Wallet balance and commission

仅沙箱

/api/sandbox/nagad-uddokta/balance

GET balance · 参数
参数类型规则与传递方式
token必填string

通过 X-OBG-Token 发送

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

敏感字段 · 请勿放入 URL

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

Paged transaction history

仅沙箱

/api/sandbox/nagad-uddokta/transaction-history

GET transaction-history · 参数
参数类型规则与传递方式
token必填string

通过 X-OBG-Token 发送

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

敏感字段 · 请勿放入 URL

  • 格式: ^[A-Za-z0-9._~+/=-]{8,512}$
page可选integer

查询参数

  • 范围: 1 … 1000
GET
/transaction-detail

Single transaction detail

仅沙箱

/api/sandbox/nagad-uddokta/transaction-detail

GET transaction-detail · 参数
参数类型规则与传递方式
token必填string

通过 X-OBG-Token 发送

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

敏感字段 · 请勿放入 URL

  • 格式: ^[A-Za-z0-9._~+/=-]{8,512}$
txnId必填string

查询参数

  • 格式: ^[A-Za-z0-9]{4,32}$
approvalDate必填string

查询参数

  • 格式: ^\d{8}$

转账

GET
/validate-account

Check that a destination is a registered wallet

仅沙箱

/api/sandbox/nagad-uddokta/validate-account

GET validate-account · 参数
参数类型规则与传递方式
token必填string

通过 X-OBG-Token 发送

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

敏感字段 · 请勿放入 URL

  • 格式: ^[A-Za-z0-9._~+/=-]{8,512}$
destMobile必填string

查询参数

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

Preview fee, commission and net amount for a cash-in

仅沙箱

/api/sandbox/nagad-uddokta/fee-commission

GET fee-commission · 参数
参数类型规则与传递方式
token必填string

通过 X-OBG-Token 发送

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

敏感字段 · 请勿放入 URL

  • 格式: ^[A-Za-z0-9._~+/=-]{8,512}$
destMobile必填string

查询参数

  • 格式: ^01\d{9}$
amount必填decimal

查询参数

  • 范围: 1 … ∞
  • 小数位数: 2
txType可选string

查询参数

  • 格式: ^[A-Z_]{2,32}$
POST
/cash-in

Cash-In to a customer wallet

仅沙箱

/api/sandbox/nagad-uddokta/cash-in

仅沙箱模拟，不转移真实资金。此集成未开通真实转账。

POST cash-in · 参数
参数类型规则与传递方式
token必填string

通过 X-OBG-Token 发送

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

敏感字段 · 请勿放入 URL

  • 格式: ^[A-Za-z0-9._~+/=-]{8,512}$
destAccountNo必填string

JSON 请求体

  • 格式: ^01\d{9}$
amount可选decimal

JSON 请求体

  • 范围: 1 … ∞
  • 小数位数: 2
POST
/b2b-to-child

B2B transfer down to a child agent

仅沙箱

/api/sandbox/nagad-uddokta/b2b-to-child

仅沙箱模拟，不转移真实资金。此集成未开通真实转账。

POST b2b-to-child · 参数
参数类型规则与传递方式
token必填string

通过 X-OBG-Token 发送

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

敏感字段 · 请勿放入 URL

  • 格式: ^[A-Za-z0-9._~+/=-]{8,512}$
destAccountNo必填string

JSON 请求体

  • 格式: ^01\d{9}$
amount必填decimal

JSON 请求体

  • 范围: 1 … ∞
  • 小数位数: 2
POST
/b2b-to-parent

B2B transfer up to the parent distributor

仅沙箱

/api/sandbox/nagad-uddokta/b2b-to-parent

仅沙箱模拟，不转移真实资金。此集成未开通真实转账。

POST b2b-to-parent · 参数
参数类型规则与传递方式
token必填string

通过 X-OBG-Token 发送

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

敏感字段 · 请勿放入 URL

  • 格式: ^[A-Za-z0-9._~+/=-]{8,512}$
amount必填decimal

JSON 请求体

  • 范围: 1 … ∞
  • 小数位数: 2

端点标识和服务商专用描述保留英文，以对应 API 协议。

在沙箱中试用

发起一个可检查的请求。

控制台默认进入沙箱，请仅使用公开测试值。切换到真实模式会改变请求目标，并可能使用真实账户和资金。

沙箱

将探索测试、账户权限和计费清晰分开。

从第一次请求到真实连接。

  1. 无需登录，先行探索

    选择 API，使用文档中的测试值调用沙箱。模拟响应不会转移资金，也不会联系银行。

  2. 创建网关账户

    使用 Google 登录，获得 1,000 欢迎积分并创建 API 密钥。这只登录网站，不会登录钱包。

  3. 准备好后再连接

    对于已支持的真实 API，请单独完成钱包登录。真实请求成功扣 1 积分，失败不扣费。

1,000 欢迎积分 · 无需银行卡

轻松起步，费用清晰。

10 美元购买 10,000 积分。真实请求成功扣 1 积分，失败和沙箱调用不扣费。购买积分不会解锁仅沙箱的接口。

购买 10,000 积分

集成指南

把接口接入你的代码。

沙箱示例使用公开模拟值。真实调用示例使用占位符：请将凭据保存在服务器端，不要提交到代码仓库。

沙箱

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

仅沙箱

实时访问尚未开通

请联系我们开通权限

Nagad Uddokta 的实时调用需按客户单独开通。沙盒模式免费，且无需登录。

通过 Telegram 联系我们联系页面

在第一次请求前，明确边界。

开始前，你可能想了解。

沙箱会使用真实账户吗？

不会。沙箱使用固定模拟响应和公开测试凭据，不会联系金融服务商、发送验证码或转移资金。

所有 API 都能真实调用吗？

不能。只有标注支持真实调用的接口具有真实上游。其他接口仅支持沙箱，在真实模式下返回 LIVE_ACCESS_NOT_ENABLED。如需开通，请联系我们。

什么时候会扣除积分？

每次成功的真实调用扣 1 积分，失败调用和沙箱调用免费。请查看 X-Credits-Charged，不要仅凭 HTTP 状态判断扣费。如果出现 X-OBG-Settlement: unknown，表示计费结果尚未确定：X-Credits-Charged: 0 不能证明没有扣款。请先查询用量并核对结果，再考虑重试。

Google 登录会连接我的钱包吗？

不会。Google 登录管理网站账户、积分和 API 密钥。钱包登录是独立且明确的流程，仅可用于已支持的接口和你有权使用的账户。

继续探索。