印尼

请求

账号校验 API 用于校验银行卡或电子钱包账号是否有效，并返回账户姓名。本页为 印度尼西亚（国家码 id）说明。

• 同步接口：一次请求返回最终结果，无异步回调。
• 仅生产环境：请使用生产域名与商户号调用。
• 订单号唯一：相同 mchNo + orderNum 重复提交返回错误，不重复校验。
• 签名规则：与 代付下单 一致，参见 签名生成。

请求路径

域名：推荐使用统一域名 openapi.toppayment.com（路径不变）；原国别域名（如 global-id-openapi.toppayment.com）仍可用。

地址
https://openapi.toppayment.com/id/disbursement/bankVerify

bankCode / bankName 与代付一致，见 地区支付说明 — 印尼 — 代付银行编码。

请求头

字段	必填	类型	描述
Content-Type	M	String	固定值：application/json

请求体

字段	必填	类型	描述
mchNo	M	String(32)	商户编号
orderNum	M	String(64)	商户订单号，须唯一
bankCode	M	String(32)	银行/钱包产品编码，与代付 bankCode 相同
bankCard	M	String(64)	银行卡号或钱包账号
timestamp	M	String(13位数字)	毫秒时间戳
sign	M	String	RSA 签名，参见 签名生成
countryCode	O	String(16)	国家码

请求体示例

Content-Type: application/json

{
    "mchNo": "{{mchNo}}",
    "orderNum": "VERIFY202606150001",
    "bankCode": "014",
    "bankCard": "1234567890",
    "timestamp": "1717300000000",
    "sign": "按签名规则生成后替换"
}

{
    "mchNo": "{{mchNo}}",
    "orderNum": "VERIFY202606150002",
    "bankCode": "10001",
    "bankCard": "081234567890",
    "timestamp": "1717300000000",
    "sign": "按签名规则生成后替换"
}

响应

HTTP 响应

字段	必填	类型	描述
Content-Type	M	String	固定值：application/json

响应字段

字段	必填	类型	描述
success	M	Boolean	请求是否成功受理
code	M	String	9999：成功；其他见 异常码
msg	O	String	英文提示信息
timeStamp	M	Number	响应时间戳（毫秒）
data	O	Object	业务数据；失败时可能为空
orderNum	M	String	商户订单号
platOrderNum	M	String	平台订单号
accountName	O	String	校验成功时返回账户姓名（不脱敏）
status	M	Integer	订单状态，见下表
verifyResult	O	Integer	验证结果，见下表

status（订单状态）

值	含义
0	处理中
1	处理成功
2	处理失败
3	请求失败

verifyResult（验证结果）

值	含义	对应 status
1	账号验证成功	1
2	账号验证失败（账号无效或与户名不匹配等）	1
3	请求失败	3

{
    "success": true,
    "code": "9999",
    "msg": null,
    "timeStamp": 1717300000123,
    "data": {
        "orderNum": "VERIFY202606150001",
        "platOrderNum": "V20260615XXXX",
        "accountName": "JOHN DOE",
        "status": 1,
        "verifyResult": 1
    }
}

{
    "success": true,
    "code": "9999",
    "timeStamp": 1717300000456,
    "data": {
        "orderNum": "VERIFY202606150001",
        "platOrderNum": "V20260615XXXX",
        "accountName": null,
        "status": 1,
        "verifyResult": 2
    }
}

{
    "success": true,
    "code": "9999",
    "timeStamp": 1717300000789,
    "data": {
        "orderNum": "VERIFY202606150001",
        "platOrderNum": "V20260615XXXX",
        "accountName": null,
        "status": 3,
        "verifyResult": 3
    }
}

{
    "success": false,
    "code": "0003",
    "msg": "mch no channel available!",
    "timeStamp": 1717300000789,
    "data": null
}