代付账户类型
| 值 | 说明 |
|---|---|
3 | 银行卡 |
代付银行列表
TIP
银行支持列表以生产环境实际支持情况为准，建议您在进入生产环境前，调用我们的银行列表查询接口来确认生产银行支持情况。
| bankId | bankCode | bankName |
|---|---|---|
| 1 | 014 | BCA |
| 2 | 009 | BNI |
| 3 | 002 | BRI |
| 4 | 008 | Mandiri |
| 5 | 441 | Bukopin |
| 6 | 022 | CIMB Niaga |
| 7 | 011 | Danamon |
| 8 | 484 | Hana |
| 9 | 426 | Mega |
| 10 | 028 | OCBC NISP |
| 11 | 013 | Permata |
| 12 | 153 | Sinarmas |
| 13 | 451 | Mandiri Syariah |
| 14 | 061 | ANZ Indonesia |
| 15 | 019 | Panin |
| 16 | 950 | Commonwealth |
| 17 | 016 | Maybank |
| 18 | 023 | UOB |
| 19 | 041 | Hongkong and Shanghai Banking Corporation (HSBC) |
| 20 | 147 | Muamalat Indonesia |
| 21 | 153 | Sinarmas Syariah |
| 22 | 422 | BRI Syariah |
| 23 | 521 | Bukopin Syariah |
| 24 | 031 | Citibank |
| 25 | 200 | BTN Syariah |
| 26 | 011 | Danamon Syariah |
| 27 | 037 | Artha Graha Internasional |
| 28 | 022 | CIMB Niaga Syariah |
| 29 | 536 | BCA Syariah |
| 30 | 131 | Pembangunan Daerah Maluku |
| 31 | 116 | Pembangunan Daerah Istimewa Aceh |
| 32 | 116 | Pembangunan Daerah Istimewa Aceh Syariah |
| 33 | 121 | Pembangunan Daerah Lampung |
| 34 | 542 | Artos Indonesia |
| 35 | 459 | Bisnis International |
| 36 | 145 | Nusantara Parahyangan |
| 37 | 110 | Jabar Banten |
| 38 | 425 | Jabar Banten Syariah |
| 39 | 068 | Woori Saudara |
| 40 | 122 | Pembangunan Daerah Kalimantan Selatan Syariah |
| 41 | 122 | Pembangunan Daerah Kalimantan Selatan |
| 42 | 133 | Pembangunan Daerah Bengkulu |
| 43 | 564 | Mandiri Taspen Pos |
| 44 | 466 | Andara |
| 45 | 129 | Pembangunan Daerah Bali |
| 46 | 115 | Pembangunan Daerah Jambi |
| 47 | 132 | Pembangunan Daerah Papua |
| 48 | 135 | Pembangunan Daerah Sulawesi Tenggara |
| 49 | 130 | Pembangunan Daerah Nusa Tenggara Timur |
| 50 | 126 | Pembangunan Daerah Sulawesi Selatan |
| 51 | 126 | Sulselbar Syariah |
| 52 | 127 | Pembangunan Daerah Sulawesi Utara |
| 53 | 128 | Pembangunan Daerah Nusa Tenggara Barat |
| 54 | 151 | Mestika Dharma |
| 55 | 117 | Pembangunan Daerah Sumut Syariah |
| 56 | 117 | Pembangunan Daerah Sumatera Utara |
| 57 | 118 | Pembangunan Daerah Sumatera Barat (Bank Nagari) |
| 59 | 125 | Pembangunan Daerah Kalteng |
| 60 | 120 | Pembangunan Daerah Sumsel dan Babel |
| 61 | 120 | Pembangunan Daerah Sumsel dan Babel Syariah |
| 62 | 134 | Pembangunan Daerah Sulawesi Tengah |
| 63 | 119 | Pembangunan Daerah Riau |
| 64 | 123 | Pembangunan Daerah Kalimantan Barat |
| 65 | 123 | Pembangunan Daerah Kalimantan Barat Syariah |
| 66 | 124 | Pembangunan Daerah Kalimantan Timur Syariah |
| 67 | 124 | Pembangunan Daerah Kalimantan Timur |
| 69 | 113 | Pembangunan Daerah Jateng Syariah |
| 70 | 113 | Pembangunan Daerah Jawa Tengah |
| 71 | 112 | Pembangunan Daerah DIY |
| 72 | 112 | Pembangunan Daerah DIY Syariah |
| 73 | 531 | Amar Indonesia |
| 75 | 114 | Pembangunan Daerah Jawa Timur |
| 76 | 559 | Centratama Nasional |
| 77 | 157 | Maspion Indonesia |
| 78 | 520 | Prima Master Bank |
| 79 | 114 | Pembangunan Daerah Jatim Syariah |
| 80 | 472 | Jasa Jakarta |
| 81 | 555 | Index Selindo |
| 82 | 491 | Mitraniaga |
| 83 | 503 | Nationalnobu |
| 84 | 523 | Sahabat Sampoerna |
| 85 | 028 | OCBC NISP Syariah |
| 86 | 558 | Pembangunan Daerah Banten |
| 90 | 553 | Mayora Indonesia |
| 91 | 562 | Fama International |
| 92 | 161 | Ganesha |
| 93 | 405 | Victoria Syariah |
| 94 | 485 | MNC Internasional |
| 95 | 501 | Blu |
| 96 | 548 | Multi Arta Sentosa |
| 98 | 042 | The Bank of Tokyo Mitsubishi UFJ |
| 99 | 047 | Resona Perdania |
| 100 | 050 | Standard Chartered |
| 101 | 057 | BNP Paribas Indonesia |
| 102 | 067 | Deutsche Bank AG |
| 103 | 095 | JTrust Indonesia |
| 104 | 111 | DKI Jakarta Syariah |
| 105 | 490 | Yudha Bhakti |
| 106 | 498 | SBI Indonesia |
| 107 | 513 | INA Perdana |
| 108 | 517 | Panin Syariah |
| 109 | 526 | Dinar Indonesia |
| 110 | 535 | Sea Bank |
| 111 | 566 | Victoria International |
| 112 | 945 | Agris |
| 113 | 146 | Bank of India Indonesia |
| 114 | 152 | Bank Shinhan Indonesia |
| 115 | 167 | QNB Indonesia |
| 116 | 200 | Tabungan Negara (Persero) |
| 117 | 213 | BTPN |
| 119 | 076 | Bumi Arta |
| 120 | 089 | Rabobank International Indonesia |
| 121 | 111 | DKI Jakarta |
| 122 | 046 | DBS Indonesia |
| 123 | 048 | MIZUHO Indonesia |
| 124 | 052 | The Royal Bank of SCOTLAND N.V. (RBS) |
| 126 | 033 | Bank of America |
| 127 | 040 | The Bangkok Bank PCL |
| 128 | 041 | Hongkong and Shanghai Banking Corporation (HSBC) Syariah |
| 129 | 045 | Sumitomo Mitsui Indonesia |
| 130 | 947 | Maybank Syariah |
| 131 | 494 | BRI Agroniaga |
| 132 | 164 | ICBC Indonesia |
| 133 | 139 | Permata Syariah |
| 134 | 032 | JPMorgan Chase Bank, NA |
| 135 | 069 | Bank of China Limited |
| 136 | 949 | CTBC Indonesia |
| 139 | 097 | Mayapada |
| 140 | 054 | Capital Indonesia |
| 142 | 567 | Harda Internasional |
| 143 | 036 | China Construction Bank Indonesia |
| 144 | 013 | Gopay |
| 145 | 427 | BNI Syariah |
| 146 | 506 | Mega Syariah |
| 147 | 059 | Korea Exchange Bank (KEB) |
| 148 | 213 | BTPN Syariah |
| 149 | 000 | ODEO |
| 151 | 451 | Syariah Indonesia |
| 152 | 137 | BPD BANTEN |
| 156 | 212 | WOORI SAUDARA INDONESIA 1906 |
| 247 | ANGLOMAS | Anglomas International Bank |
| 248 | ARTA_NIAGA_KENCANA | Bank Arta Niaga Kencana |
| 249 | BJB | Bank BJB |
| 250 | CHINATRUST | Bank Chinatrust Indonesia |
| 251 | INA_PERDANA | Bank Ina Perdania |
| 252 | TABUNGAN_PENSIUNAN_NASIONAL | Bank Tabungan Pensiunan Nasional |
| 253 | KALIMANTAN_TENGAH | BPD Kalimantan Tengah |
| 254 | SULUT | BPD Sulut |
| 255 | SUMUT | BPD Sumut |
| 256 | EXIMBANK | Indonesia Eximbank (formerly Bank Ekspor Indonesia) |
| 257 | DANA | DANA |
| 258 | GOPAY | GOPAY |
| 260 | LINKAJA | LINKAJA |
| 261 | OVO | OVO |
| 262 | SHOPEEPAY | SHOPEEPAY |
代付订单状态枚举
| 值 | 说明 | 备注 |
|---|---|---|
| PROCESSING | 处理中 | |
| WAITING | 路由中 | |
| PAYING | 支付中 | |
| SUCCESS | 成功 | 订单终态 |
| FAIL | 失败 | 订单终态 |
| CANCEL | 驳回/取消 | 订单终态 |
TIP
注意，在处理来自Cashy的回调或者查询结果时，应对订单状态进行精确地判断。只有终态结果才能认为代付订单明确成功/失败。
代付订单状态描述
| 值 | 说明 |
|---|---|
| ACCOUNT_NOT_EXIST | 账户不存在 |
| ACCOUNT_FREEZING | 账户冻结 |
| ACCOUNT_CANCEL | 账户已取消 |
| ACCOUNT_IN_ANOTHER_CURRENCY | 另一种货币的帐户 |
| ACCOUNT_NOT_BELONG_TO | 帐户不属于接收参与者 |
| ACCOUNT_EXCEPTION | 收款账户异常 |
| MCH_NOT_KNOW_PAYMENT | 收款人不承认付款 |
| MISS_MUST_PAYMENT_INFO | 缺少完成付款的必填信息 |
| ERROR_PAYMENT_TYPE | 错误的付款方式 |
| ERROR_OPERATION_TYPE | 错误的操作类型 |
| ACCOUNT_TYPE_NOT_APPLICABLE | 账户类型不适用 |
| INVALID_CHARACTER | 无效字符 |
| OUT_ACCOUNT_BALANCE | 超出授权账户余额限制 |
| OUT_ACCOUNT_MONTH_BALANCE | 超出账户当月允许的信用额度 |
| NOT_REGISTER_TELPHONE | 未注册的手机号码 |
| NOT_RECEIVE_BANXICO_PAYMENT | 附加帐户不会收到非来自 Banxico 的付款 |
| INFO_STRUCTURE_INVALID | 附加信息结构不正确 |
| UNKNOWN_ERROR | 未知异常 |
| SUCCESS | 成功 |
| AMOUNT_ERROR | 金额错误 |
| PARAM_ERROR | 参数错误 |
| NOT_SUPPORTED_CASH | 不支持现金支付 |
| NOT_SUPPORTED_CREDIT | 不支持信用卡支付 |
| SYSTEM_ERROR | 系统异常 |
| INVALID_BANK_ACCOUNT | 无效的银行账户 |
| RUT_INVALID | 无效的RUT (智利) |
| COMPLIANCE_REJECT | 付款因合规原因被拒绝 (智利) |
| INVALID_CCI | 无效的CCI (秘鲁) |
| PAYMENT_REJECT_BY_RECEIPT_PSP | 付款被收款人的PSP拒绝（巴西） |
| BENEFICIARY_ACCOUNT_FREQUENCY_RISK_BY_BANK | 受益账户触发上游银行交易频率风控（巴西） ,此情况请暂缓该收款账户的出款操作，等待一段时间后再重试 |
| ACCOUNT_NOT_FOUND | 未找到对应的收款账号 |
| PAGAMENTO_EXPIRADO_POR_TIMEOUT | (Pagamento expirado por timeout)付款因超时而过期（巴西）, 通常因为巴西央行波动引起的 |
| CHANNEL_IB_TRY_AGAIN_LATER | 渠道异常，可稍后重试 |
代收PayType枚举
直连方式
| 值 | 支付产品 | 说明 |
|---|---|---|
| 21 | BCAVA | BCA 只支持游戏商户开通 |
| 22 | BRIVA | BRI |
| 23 | BersamaVA | Bersama |
| 24 | PermataVA | Permata |
| 25 | MandiriVA | Mandiri |
| 26 | BNIVA | BNI |
| 27 | CIMBVA | CIMB |
| 31 | AlfaGroupVA | AlfaGroup 便利店 |
| 32 | IndomaretVA | Indomaret 便利店 暂不支持 |
| 41 | QRIS | QRIS |
重定向方式
| 值 | 支付产品 | 说明 |
|---|---|---|
| 42 | Gopay | Gopay 暂不支持 |
| 43 | Dana | Dana |
| 44 | ShopeeJumpApps | Shopee 跳转App支付 |
| 45 | LinkAja | LinkAja 暂不支持 |
| 47 | OVO_PUSH | OVO推送(注意:OVO固定过期时间大概几分钟内失效) |
代收订单状态枚举
| 值 | 说明 | 备注 |
|---|---|---|
| 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证件号格式无效 | 巴西 |