查询收款方式
查询你已开通的法币,以及每个法币出款时支持的收款方式和要填的信息。创建出金订单前用它确定 paymentMethod 和要传的字段。
POST
/api/open/order/getPaymentMethods完整地址 = 接口地址 + 这个路径。接口地址在商户后台「开发者 → API 与回调」查看。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
merchantNo | string | 是 | 商户号 |
currencyType | string | 否 | 只查这一个法币;不传返回全部已开通的法币 |
返回
| 字段 | 类型 | 说明 |
|---|---|---|
currencies[].currency | string | 法币代码 |
currencies[].symbol | string | 货币符号 |
currencies[].decimals | int | 金额小数位 |
currencies[].methods[].paymentMethod | int | 收款方式编号,出金时传给 paymentMethod |
currencies[].methods[].name | string | 收款方式名称(英文) |
currencies[].methods[].kind | string | 类型:bank 银行转账、wallet 电子钱包、qrcode 扫码 |
currencies[].methods[].fields[] | array | 要填的信息 |
fields[].key | string | 字段标识 |
fields[].apiParam | string | 对应创建出金订单的参数名;为空表示这项不能通过接口传 |
fields[].label | string | 字段名称(英文) |
fields[].required | bool | 是否必填 |
fields[].pattern | string | 格式要求(正则表达式),为空表示不限 |
fields[].hint | string | 填写提示 |
currencies[].methods[].banks[] | array | 可选的银行(name、code),有的话 bankName 请从中选 |
json
{
"code": 0,
"message": "success",
"data": {
"currencies": [
{
"currency": "THB",
"symbol": "฿",
"decimals": 2,
"methods": [
{
"paymentMethod": 1,
"name": "Bank transfer",
"kind": "bank",
"fields": [
{ "key": "owner", "apiParam": "bankAccountName", "label": "Account name", "required": true, "pattern": "", "hint": "" },
{ "key": "account", "apiParam": "bankAccountNumber", "label": "Account number", "required": true, "pattern": "^[0-9]{10,12}$", "hint": "" }
],
"banks": [ { "name": "Kasikornbank", "code": "KBANK" } ]
}
]
}
]
}
}上面只是格式示例,实际的收款方式、字段和银行以接口返回为准。
常见错误
40010、40017。