代付账户类型
| 值 | 说明 |
|---|---|
0 | 活期账户(Corriente) |
1 | 储蓄账户(Ahorro) |
代付收款人证件类型
| 值 | 说明 | 备注 |
|---|---|---|
| 1 | DNI | 身份证,通常为8位数字 |
| 2 | PAS | 护照,通常为7-12 位数字 |
| 3 | CE | 外国人居留许可证,通常为8-20 位数字 |
| 4 | RUC | 纳税人注册号,通常为 11 位数字 |
代付收款银行账号格式
| 银行名称 | 校验规则 |
|---|---|
| BBVA (Banco Continental) | 18位或20位 EX: 001106660100012345 (18位) EX: 00110666010001234512 (20位) |
| Interbank | 13位 |
| BCP (Banco de Credito) | 活期账户13 储蓄账户:14位 |
| Scotiabank | 10位 Example:0037651234 (10 digits: 3 agency + 7 account) |
| 非四大行 | 使用20位的CCI账号 Example:00219400254640654321 (20 digits) |
TIP
BCP,储蓄账户(Ahorro),卡号第十二位为0
BBVA,储蓄账户(Ahorro),长度为18位,卡号第9位为0,第10位为2
BBVA,活期账户(Corriente),长度为20位,卡号第11位为0,第12位为1
以上规则仅供参考
代付银行列表
TIP
银行支持列表以生产环境实际支持情况为准，建议您在进入生产环境前，调用我们的银行列表查询接口来确认生产银行支持情况。
| bank_id | bank_code | bank_name |
|---|---|---|
| 1 | BBVA Continental | BBVA Continental |
| 2 | Interbank | Interbank |
| 3 | BCP Banco de Crédito de Perú | BCP Banco de Crédito de Perú |
| 4 | Scotiabank | Scotiabank |
| 5 | Banco Falabella | Banco Falabella |
| 6 | BanBif | BanBif |
| 7 | Banco Santander | Banco Santander |
| 8 | Mi Banco | Mi Banco |
| 9 | Banco de Comercio | Banco de Comercio |
| 10 | Banco Financiero | Banco Financiero |
| 11 | Banco GNB | Banco GNB |
| 12 | Citibank | Citibank |
| 13 | Banco de la Nacion | Banco de la Nacion |
| 14 | CMAC Trujillo | CMAC Trujillo |
| 17 | CMAC Sullana | CMAC Sullana |
| 18 | CMAC Cusco | CMAC Cusco |
| 19 | CMAC Huancayo | CMAC Huancayo |
| 20 | Caja Metropolitana | Caja Metropolitana |
| 21 | Banco Pichincha | Banco Pichincha |
| 22 | Banco Azteca | Banco Azteca |
| 23 | Banco Cencosud | Banco Cencosud |
| 24 | ICBC PERU BANK | ICBC PERU BANK |
| 25 | Caja Maynas | Caja Maynas |
| 26 | Caja Municipal Ica | Caja Municipal Ica |
| 27 | Caja Tacna | Caja Tacna |
| 28 | Banco Ripley | Banco Ripley |
代付订单状态枚举
| 值 | 说明 | 备注 |
|---|---|---|
| PROCESSING | 处理中 | |
| WAITING | 路由中 | |
| PAYING | 支付中 | |
| SUCCESS | 成功 | 订单终态 |
| FAIL | 失败 | 订单终态 |
| CANCEL | 驳回/取消 | 订单终态 |
TIP
注意，在处理来自Cashy的回调或者查询结果时，应对订单状态进行精确地判断。只有终态结果才能认为代付订单明确成功/失败。
代付订单状态描述
| 值 | 说明 |
|---|---|
| ACCOUNT_FREEZING | 收款账户已冻结 |
| BANK_ACCOUNT_ERROR | 银行账号错误 |
| INVALID_BANK_ACCOUNT | 无效的银行账号 |
| INVALID_CCI | 无效的CCI |
| PAYMENT_OFFSET | 支付冲正 |
| ACCOUNT_NOT_EXIST | 账号不存在 |
| CHANNEL_EXCEPTION | 渠道异常 |
| ID_CARD_ERROR | 用户证件号错误 |
| NOT_ACCOUNT_HOLDER | 收款人不是账户持有者 |
| ACCOUNT_CLOSED | 收款账户已注销/关闭 |
| NAME_INCOMPLETE | 用户姓名不完整 |
| UNKNOWN_ERROR | 未知错误 |
| CHANNEL_IB_TRY_AGAIN_LATER | 渠道异常，可稍后重试 |
代收付款人证件类型
| 值 | 说明 | 备注 |
|---|---|---|
| 1 | DNI | 身份证,通常为8位数字 |
| 2 | PAS | 护照,通常为7-12 位数字 |
| 3 | CE | 外国人居留许可证,通常为8-20 位数字 |
| 4 | RUC | 纳税人注册号,通常为 11 位数字 |
代收PayType枚举
| 值 | 说明 |
|---|---|
200 | 聚合收银台 |
代收订单状态枚举
| 值 | 说明 | 备注 |
|---|---|---|
| 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证件号格式无效 | 巴西 |