Open Banking Gateway
仅沙箱

零售银行 · 越南

ACB ONE API

亚洲商业银行（越南）—— 用户名/密码登录、资料、余额与交易。

在沙箱中试用
5 个端点免费沙箱

沙箱 · 请求

curl · POST /login
curl -X POST 'https://www.openbankinggateway.com/api/sandbox/acb/login' \
  -H 'Content-Type: application/json' \
  --data '{
  "phone": "0399123456",
  "password": "sandbox123"
}'

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

API 参考文档

清楚了解可调用的接口。

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

发现

GET
/check-user

Check whether a username exists

仅沙箱

/api/sandbox/acb/check-user

GET check-user · 参数
参数类型规则与传递方式
phone必填string

查询参数

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

  • 格式: ^0\d{9,10}$

钱包认证

POST
/login

Log in with username and password

仅沙箱

/api/sandbox/acb/login

POST login · 参数
参数类型规则与传递方式
phone必填string

JSON 请求体

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

  • 格式: ^0\d{9,10}$
password必填string

JSON 请求体

敏感字段 · 请勿放入 URL

  • 长度: 1 … 128

账户与活动

GET
/profile

User profile

仅沙箱

/api/sandbox/acb/profile

GET profile · 参数
参数类型规则与传递方式
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
/balance

Account balance

仅沙箱

/api/sandbox/acb/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

Transaction history with pagination

仅沙箱

/api/sandbox/acb/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}$
pageNum必填integer

查询参数

  • 范围: 1 … 1000
pageSize必填integer

查询参数

  • 范围: 1 … 100

端点标识和服务商专用描述保留英文，以对应 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/acb/login' \
  -H 'Content-Type: application/json' \
  --data '{
  "phone": "0399123456",
  "password": "sandbox123"
}'

仅沙箱

实时访问尚未开通

请联系我们开通权限

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

通过 Telegram 联系我们联系页面

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

开始前，你可能想了解。

沙箱会使用真实账户吗？

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

所有 API 都能真实调用吗？

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

什么时候会扣除积分？

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

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

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

继续探索。