代付账户类型
accountType | 说明 |
---|---|
1 | 银行账户 |
2 | 钱包账户 |
TIP
当代付收款银行为电子钱包时,accountType
需要为2
,accountNo
为电子钱包收款账号。
代付收款人证件类型
idType | 说明 |
---|---|
SSS | Social Security System 社会保障系统 |
TIN | Tax Identification Number 纳税人识别号 |
Passport | 护照 |
PhiHealth | 菲律宾卫生卡,是一种类似于健康保险卡的医疗证明。 |
Driver's license | 选民身份证 |
UMID | Unique Multi-Purpose ID |
PRC ID | 菲律宾永久居民卡 |
GSIS ID | 学历证书 |
Student's ID | 学生身份证 |
Pag-IBIG | People's Insurance Company of the Philippines |
National ID | National ID - 国家身份证 |
代付银行列表
TIP
银行支持列表以生产环境实际支持情况为准,建议您在进入生产环境前,调用我们的银行列表查询接口来确认生产银行支持情况。
bankId | bankCode | bankName | 备注 |
---|---|---|---|
1 | BDO | Banco de Oro | |
2 | AUB | Asia United Bank | |
3 | BPI | Bank of the Philippine Islands | |
4 | UBP | Union Bank Of The Philippines | |
5 | CBC | China Banking Corporation(China Bank) | |
6 | LBP | Land Bank of the Philippines | |
7 | BOC | Bank Of Commerce | |
8 | EQB | Equicom Savings Bank | |
9 | PNB | Philippine National Bank | |
10 | PTC | Philippine Trust Company | |
11 | PVB | Philippine Veterans Bank | |
12 | UCPB | United Coconut Planters Bank (UCPB) | |
13 | IBI | ISLA Bank | |
14 | MET | Metrobank | |
15 | MSB | Malayan Bank | |
16 | ONB | One Network Bank | |
17 | PAR | Partner Rural Bank(Cotabato) Inc. | |
18 | PBB | Philippine Business Bank | |
19 | PNS | PNB Savings Bank | |
20 | PSB | Philippine Savings Bank | |
21 | QRB | Quezon Capital Rural Bank | |
22 | SBC | Security Bank | |
23 | SSB | Sun Savings Bank | |
24 | BMB | Bangko Mabuhay | |
25 | CSB | Citystate Savings Bank | |
26 | DBI | Dungganon Bank | |
27 | EWR | East West Rural Bank (Green Bank) | |
28 | WDB | Wealth Development Bank | |
29 | RCBC | Rizal Commercial Banking Corp. (RCBC) | |
30 | RSB | Robinsons Bank | |
31 | CRD | CARD Bank | |
32 | CTBC | Ctbc Bank (Philippines) Corp. | |
33 | EWB | East West Banking Corporation | |
34 | SBA | Sterling Bank Of Asia | |
35 | CBS | China Bank Savings, Inc | |
36 | DBP | Development Bank of the Philippines | |
37 | JPM | JP Morgan Chase Bank, N.A. | |
38 | BPIDB | BPI Direct BanKO, Inc., A Savings Bank | |
39 | RSBI | Rcbc Savings Bank Inc. | |
40 | CEBRUR | Cebuana Lhuillier Rural Bank, Inc. | |
41 | PRB | Producers Bank | |
42 | QCB | Queen City Development Bank, Inc. | |
43 | ING | ING Bank N.V. | |
44 | SPY | Starpay Corporation | |
45 | YUANSB | Yuanta Savings Bank | |
46 | UCBSB | UCBP Savings bank | |
47 | BRB | Binangonan Rural Bank (BRBDigital) | |
48 | ABP | AllBank Inc. | |
49 | RBG | RURAL BANK OF GUINOBATAN, INC. | |
50 | CMG | CAMALIG BANK | |
51 | MBP | Maybank Philippines | |
52 | PBCOM | Philippine Bank of Communications | |
53 | CIMB | CIMB Bank Philippines, Inc. | |
101 | GCASH | GCASH Wallet | 电子钱包 |
102 | PAYMAYA | PAYMAYA Wallet | 电子钱包 |
103 | GRABPAY | GRABPAY Wallet | 电子钱包 |
104 | SHOPEE | SHOPEE Wallet | 电子钱包 |
105 | COINS | COINS Wallet | 电子钱包 |
106 | OMNIPAY | OMNIPAY Wallet | 电子钱包 |
TIP
当收款银行为电子钱包时,accountType
需要为2
,accountNo
为电子钱包收款账号。
代付订单状态枚举
值 | 说明 | 备注 |
---|---|---|
PROCESSING | 处理中 | |
WAITING | 路由中 | |
PAYING | 支付中 | |
SUCCESS | 成功 | 订单终态 |
FAIL | 失败 | 订单终态 |
CANCEL | 驳回/取消 | 订单终态 |
TIP
注意,在处理来自Cashy的回调或者查询结果时,应对订单状态进行精确地判断。只有终态结果才能认为代付订单明确成功/失败。
代付订单状态描述
值 | 说明 |
---|---|
CHANNEL_SYSTEM_BUSY | 上游渠道繁忙 |
BENEFICIARY_BANK_ACCOUNT_ERROR | 收款银行账户异常 |
EXCEEDED_BENEFICIARY_ACCOUNT_AMOUNT_LIMIT | 超过账户收款金额限制 |
CHANNEL_EXCEPTION | 上游渠道异常 |
PAYMENT_REJECTED_BY_CHANNEL | 付款交易被渠道拒绝 |
UNKNOWN_ERROR | 未知错误 |
CHANNEL_IB_TRY_AGAIN_LATER | 渠道异常,可稍后重试 |
代收付款人证件类型
idType | 说明 |
---|---|
SSS | Social Security System 社会保障系统 |
TIN | Tax Identification Number 纳税人识别号 |
Passport | 护照 |
PhiHealth | 菲律宾卫生卡,是一种类似于健康保险卡的医疗证明。 |
Driver's license | 选民身份证 |
UMID | Unique Multi-Purpose ID |
PRC ID | 菲律宾永久居民卡 |
GSIS ID | 学历证书 |
Student's ID | 学生身份证 |
Pag-IBIG | People's Insurance Company of the Philippines |
National ID | 国家身份证 |
代收PayType枚举
payType | 说明 | 状态 | 产品说明 | 备注 |
---|---|---|---|---|
401 | QRPH_STATIC | 启用 | QRPh静态二维码 | 不限制金额,可多次支付 |
402 | QRPH_DYNAMIC | 启用 | QRPh动态二维码 | 限制金额,单次支付 |
403 | BANK_TRANSFER_INSTA | 启用 | INSTA银行虚拟账户 | 不限制金额, 可多次支付(5w以下) |
404 | BANK_TRANSFER_PESONET | 启用 | PESONET银行虚拟账户 | 不限制金额, 可多次支付,(5w以上) |
410 | RefNo (Bill Payment) | 启用 | 还款码 (Bill Payment) | 不限制金额,可多次支付,支持多种还款途径 |
431 | GCASH_WEB_ONLINE | 启用 | Gcash电子钱包在线支付 | 限制金额,单次支付 |
432 | PAYMAYA_WEB_ONLINE | 启用 | Paymaya电子钱包在线支付 | 限制金额,单次支付 |
433 | COINS_WEB_ONLINE | 启用 | Coins电子钱包在线支付 | 限制金额,单次支付 |
434 | GRABPAY_WEB_ONLINE | 启用 | GrabPay电子钱包在线支付 | 限制金额,单次支付 |
435 | BPIA_WEB_ONLINE | 启用 | BPIA 网银在线支付 | 限制金额,单次支付 |
436 | UBPB_WEB_ONLINE | 启用 | UBPB 网银在线支付 | 限制金额,单次支付 |
代收订单状态枚举
值 | 说明 | 备注 |
---|---|---|
PAYING | 支付中 | |
SUCCESS | 成功 | 订单终态 |
FAIL | 失败 | 订单终态 |
TIP
注意,在处理来自Cashy的回调或者查询结果时,应对订单状态进行精确地判断。只有终态结果才能认为代收订单明确成功。
收银台代收订单状态枚举
值 | 说明 |
---|---|
PAYING | 支付中 |
SUCCESS | 成功 |
常见报错信息
值 | 含义 | 覆盖国家 |
---|---|---|
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证件号格式无效 | 巴西 |