代付收款人证件类型
暂无指定
代付账户类型
值 | 说明 |
---|---|
3 | 银行账户 |
代付银行列表
TIP
银行支持列表以生产环境实际支持情况为准,建议您在进入生产环境前,调用我们的银行列表查询接口来确认生产银行支持情况。
bank_id | bank_code | bank_name |
---|---|---|
1 | BAAC | ธนาคารเพื่อการเกษตรและสหกรณ์ |
2 | BAY | บมจ.ธนาคารกรุงศรีอยุธยา |
3 | BBL | บมจ.ธนาคารกรุงเทพ |
4 | CIMB | ธ. ซีไอเอ็มบี ไทย จำกัด (มหาชน) |
5 | CITI | ธนาคารซิตี้แบงค์ |
6 | GHB | ธนาคารอาคารสงเคราะห์ |
7 | GSB | ธนาคารออมสิน |
8 | HSBC | ธนาคารฮ่องกงและเซียงไฮ้ |
9 | ICBC | ธนาคารไอซีบีซี(ไทย) จำกัด (มหาชน) |
10 | IBANK | ธนาคารอิสลามแห่งประเทศไทย |
11 | KBANK | บมจ.ธนาคารกสิกรไทย |
12 | KKP | KK*ธนาคารเกียรตินาคิน จำกัด (มหาชน) |
13 | LHBANK | ธนาคารแลนด์ แอนด์ เฮ้าส์ จำกัด (มหาชน) |
14 | MHCB | ธนาคารมิซูโฮ คอร์ปอเรต จำกัด |
15 | SCB | บมจ.ธนาคารไทยพาณิชย์ |
16 | SCBT | บมจ.ธนาคารสแตนดาร์ชาร์เตอร์นครธน |
17 | SMBC | ธนาคารซูมิโตโม มิตซุย แบงกิ้ง คอร์ปอเรชั่น |
18 | TBANK | ธ. ธนชาต จำกัด (มหาชน) |
19 | TCRB | TCRB*ธนาคาร ไทยเครดิต เพื่อรายย่อย จำกัด (มหาชน) |
20 | TISCO | บมจ.ธนาคารทิสโก้ |
21 | TTB | ธนาคารทหารไทยธนชาต |
22 | UOB | บมจ.ธนาคาร ยู โอ บี |
23 | AIG | AIG*ธนาคาร เอไอจี เพื่อรายย่อย จำกัด (มหาชน) |
24 | BOA | ธนาคารแห่งอเมริกาฯ |
25 | BNP | ธนาคารบีเอ็นพี พารีบาส์ กรุงเทพ ฯ |
26 | BOC | ธนาคารแห่งประเทศจีน |
27 | BTMU | ธนาคารโตเกียวมิตซูบิชิ |
28 | ABI | ธนาคารเครดิต อะกริกอล อินโดสุเอซ |
29 | DEUTB | ธนาคารดอยช์แบงก์ |
30 | EXIMB | ธนาคารเพื่อการส่งออกและการนำเข้าแห่งประเทศไทย |
31 | IOB | IOB*อินเดียนโอเวอร์ซีส์ |
32 | JPMCB | ธนาคารเจพีมอร์แกน เชส สาขากรุงเทพ ฯ |
33 | MICB | ธนาคารเมกะสากลพาณิชย์ |
34 | OCBC | ธนาคารโอเวอร์ซี - ไชนีสแบงกิ้ง คอร์ปอเรชั่น จำกัด |
35 | ABN | ธนาคารเอบีเอ็น แอมโร เอ็น.วี. |
36 | RHB | ธนาคาร อาร์ เอช บี จำกัด |
37 | SMEB | SME BANK*ธนาคาร พัฒนาวิสาหกิจขนาดกลางและขนาดย่อมแห่งประเทศไทย |
38 | KTB | ธนาคารกรุงไทย |
39 | ANZ | ธนาคารเอเอ็นแซด (ไทย) จำกัด (มหาชน) |
40 | TMB | ธนาคารทหารไทยธนชาต |
代付订单状态枚举
值 | 说明 | 备注 |
---|---|---|
PROCESSING | 处理中 | |
WAITING | 路由中 | |
PAYING | 支付中 | |
SUCCESS | 成功 | 订单终态 |
FAIL | 失败 | 订单终态 |
CANCEL | 驳回/取消 | 订单终态 |
TIP
注意,在处理来自Cashy的回调或者查询结果时,应对订单状态进行精确地判断。只有终态结果才能认为代付订单明确成功/失败。
代付订单状态描述
值 | 说明 |
---|---|
CHANNEL_IB_TRY_AGAIN_LATER | 渠道异常,可稍后重试 |
CHANNEL_NETWORK_FLUCTUATION | 渠道网络波动,请确认账号无误后重试 |
UPSTREAM_CHANNEL_EXCEPTION | 上游渠道异常,请稍后重试 |
BANK_ACCOUNT_INVALID | 收款银行账号无效 |
TEMPORARILY_UNABLE_PROCESS_FOR_THIS_BANK | 暂时不能处理此银行的交易 (请检查收款账号是否正确,检查收款账号和收款银行是否匹配,如果均无误,可以发起重试) |
UNKNOWN_ERROR | 未知错误 |
代收PayType枚举
值 | 说明 |
---|---|
411 | BANK 转账 |
412 | PromptPay 转账 |
413 | Truemoney 钱包 |
414 | Truemoney 支付页 |
重要提醒1
目前PromptPay方式代收,生成二维码有效期为五分钟,请通知用户在五分钟内支付,超过五分钟后的订单需要银行手动上账处理,届时需要提供用户支付凭证才能对应订单进行上账。
重要提醒2
目前银行转账方式代收采用卡收,当对应银行卡冻结下线后,请通知用户不要保存卡号支付,需要通过app获取新的卡号,下线之后转入的金额概不负责。
代收订单状态枚举
值 | 说明 | 备注 |
---|---|---|
PAYING | 支付中 | |
SUCCESS | 成功 | 订单终态 |
FAIL | 失败 | 订单终态 |
TIP
注意,在处理来自Cashy的回调或者查询结果时,应对订单状态进行精确地判断。只有终态结果才能认为代收订单明确成功。
常见报错信息
值 | 含义 | 覆盖国家 |
---|---|---|
Permission_denied | 请求地址未授权(请求地址错误,检查下请求地址是否正确) | 全部 |
System_error | 系统错误 | 全部 |
System_busy | 系统繁忙(重试) | 全部 |
System_Maintenance | 系统维护(重试) | 全部 |
MerchantId_is_null | 商户Id为空 | 全部 |
Sign_verify_error | 商户签名验证错误 | 全部 |
RequestMethod_not_post | 不是POST请求 | 全部 |
RequestContentType_not_json | 不是application/json请求 | 全部 |
RequestBody_is_null | 请求体为空 | 全部 |
MerchantId_not_Number | 商户Id非数字 | 全部 |
MerchantId_is_error | 商户Id错误 | 全部 |
Request_ip_notWhiteList | 请求ip非白名单 | 全部 |
Params_jsonFormat_error | 请求体json格式错误 | 全部 |
Params_xxx_Required | 某参数未传递,请检查是否漏传。 | 全部 |
Params_xxx_error | 某参数错误,请检查参数是否合法。 | 全部 |
Params_accountNo_Format_isIncorrect | 银行账号格式不正确(银行卡号长度与银行不匹配) | 部分国家 |
Merchant_amount_notEnough | 商户余额不足 | 全部 |
Merchant_not_enabled | 商户未启用 | 全部 |
Merchant_not_exist | 商户不存在 | 全部 |
Params_order_notExist | 该平台订单号不存在 | 全部 |
Params_mchOrderNo_notExist | 该商户订单号不存在 | 全部 |
Params_mchOrderNo_repeat | 商户订单号重复 | 全部 |
Params_email_format_invalid | 邮箱格式错误 | 全部 |
Params_bankId_Disable | 此银行暂时不可用 | 全部 |
Params_IdCard_format_invalid | 证件号格式错误 | 全部 |
Params_idCard_Format_incorrect | 证件号格式错误 | 部分国家 |
Channel_Maintenance_time | 通道维护中 ,测试环境可联系技术支持 | 全部 |
Tran_risk_intercept | 交易风控拦截 ,检查金额是否满足限制条件 | 全部 |
COLLECTION_ACCOUNT_DAY_LIMIT | 收款卡号达到日限制上限次数 | 全部 |
COLLECTION_NAME_DAY_LIMIT | 收款姓名达到日限制上限次数 | 全部 |
LIMIT_MIN_AMOUNT | 订单金额低于最小金额限制 | 全部 |
LIMIT_MAX_AMOUNT | 订单金额高于最大金额限制 | 全部 |
BLACK_LIST_USER_LIMIT | 用户属于黑名单限制 | 全部 |
Params_realName_not_contain_Chinese | 账户名字不允许包含中文 | 全部 |
Params_accountName_not_contain_Chinese | 账户名字不允许包含中文 | 全部 |
Params_accountNo_Clabe_Invalidate | Clabe无效 | 墨西哥 |
Params_email_format_invalid | 邮箱格式无效 | 墨西哥 |
Params_email_length_exceeds<64>characters | 邮箱长度超过了64位(应当保证邮箱长度低于64位) | 全部 |
Params_accountName_Maximum<40>characters | 代付(受益人)收款人姓名过长 | 部分国家,MX为40 |
Params_idType_Exists_idCard_CPF_Invalidate | CPF证件号格式无效 | 巴西 |