代付账户类型
| accountType值 | 字段说明 |
|---|---|
3 | 银行账户 |
4 | VA虚拟账户 |
代付订单状态枚举
| 值 | 说明 | 备注 |
|---|---|---|
| PROCESSING | 处理中 | |
| WAITING | 路由中 | |
| PAYING | 支付中 | |
| SUCCESS | 成功 | 订单终态 |
| FAIL | 失败 | 订单终态 |
| CANCEL | 驳回/取消 | 订单终态 |
TIP
注意，在处理来自Cashy的回调或者查询结果时，应对订单状态进行精确地判断。只有终态结果才能认为代付订单明确成功/失败。
代付订单状态描述
| 值 | 说明 |
|---|---|
| PAYMENT_SUSPECT_SURVEY | 嫌疑人支付调查 |
| PAYMENT_QUERY_FAIL | 支付查询失败 |
| BANK_ACCOUNT_ERROR | 银行帐号错误 |
| BANK_ACCOUNT_ABNORMAL | 银行账户异常 |
| ACCOUNT_HOLDER_NAME_INVALID | 帐户持有人姓名无效 |
| PHONE_NUMBER_ERROR | 手机号错误 |
| BANK_NOT_SUPPORT | 银行不支持 |
| COMMON_FAILED | 通用失败 |
| UP_STREAM_SYSTEM_EXCEPTION | 上游系统异常 |
| BILL_NOT_FOUND | BILL_NOT_FOUND |
| CHANNEL_IB_TRY_AGAIN_LATER | 渠道异常-请稍后重试 |
| BANK_ACCOUNT_CLOSE | 已关闭的银行账户 |
| BANK_REFUSE | 查询被供应商银行拒绝 |
| BANK_CLOSE | 查询供应商银行已关闭 |
| PAYMENT_OFFSET | 支付冲正 |
| BANK_ABNORMAL_OR_REFUSE | 银行拒绝 |
| ACCOUNT_RECEIVE_AMOUNT_LIMIT_EXCEEDED | 超出帐户接收金额限额 |
| EACH_PAYMENT_LIMIT_EXCEEDED | 超过单笔交易金额限制 |
| MONTHLY_PAYMENT_LIMIT_EXCEEDED | 超过月累计支付最大限额 |
| SYSTEM_REJECTION | 系统驳回 |
| MERCHANT_BALANCE_NOT_ENOUGH | 商户余额不足 |
| UNKNOWN_ERROR | 未知异常 |
代收PayType枚举
直连方式
| 值 | 支付产品 | 说明 |
|---|---|---|
| 21 | BCAVA | 只支持游戏商户开通 |
| 22 | BRIVA | BRI |
| 23 | BersamaVA | Bersama |
| 24 | PermataVA | Permata |
| 25 | MandiriVA | Mandiri |
| 26 | BNIVA | BNI |
| 27 | CIMBVA | CIMB |
| 31 | AlfaGroupVA | AlfaGroup 便利店 |
| 32 | IndomaretVA | 暂不支持 |
| 41 | QRIS | QRIS |
重定向方式
| 值 | 支付产品 | 说明 |
|---|---|---|
| 42 | Gopay | 暂不支持 |
| 43 | Dana | Dana |
| 44 | ShopeeJumpApps | Shopee 跳转App支付 |
| 45 | LinkAja | 暂不支持 |
| 47 | OVO_PUSH | OVO推送(注意:OVO PUSH的有效期为数分钟） |
代收订单状态枚举
| 值 | 说明 | 备注 |
|---|---|---|
| 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 | 通道维护中 ，测试环境可联系技术支持 | 全部 |
Params_realName_not_contain_Chinese | 账户名字不允许包含中文 | 全部 |
Params_accountName_not_contain_Chinese | 账户名字不允许包含中文 | 全部 |
Params_accountNo_Clabe_Invalidate | Clabe无效 | 墨西哥 |
Params_accountNo_CardNumber_Invalidate | 银行卡号无效 | 墨西哥 |
Params_email_format_invalid | 邮箱格式无效 | 墨西哥 |
Params_email_length_exceeds<64>characters | 邮箱长度超过了64位（应当保证邮箱长度低于64位） | 全部 |
Params_accountName_Maximum<40>characters | 代付（受益人）收款人姓名过长 | 部分国家，MX为40 |
Params_accountName_Required | 请传递收款帐户名 | 部分国家 |
Params_accountName_Maximum<64>characters | 收款账户名不得超过64字符 | 部分国家 |
Params_accountName_not_contain_Chinese | 收款账户名不得包含中文 | 部分国家 |
Params_CPF_accountNo_Invalid | CPF格式的收款帐号无效 | 巴西 |
Params_idType_Required | 证件类型必传 | 部分国家 |
Params_idType_Invalid | 证件类型无效 | 部分国家 |
Params_idCard_Required | 证件号必传 | 部分国家 |
Params_idCard_CPF_Invalid | CPF证件号无效 | 巴西 |
Params_realName_Required | 代收付款人姓名必传 | 部分国家 |
Params_realName_Maximum<64>characters | 代收付款人姓名不得超过64字符 | 部分国家 |
Params_realName_not_contain_Chinese | 代收付款人姓名不得包含中文 | 部分国家 |
Tran_risk_intercept | 交易风控拦截 ，检查金额是否满足限制条件 | 全部 |
COLLECTION_ACCOUNT_DAY_LIMIT | 收款卡号达到日限制上限次数 | 全部 |
COLLECTION_NAME_DAY_LIMIT | 收款姓名达到日限制上限次数 | 全部 |
LIMIT_MIN_AMOUNT | 订单金额低于最小金额限制 | 全部 |
LIMIT_MAX_AMOUNT | 订单金额高于最大金额限制 | 全部 |
BLACK_LIST_USER_LIMIT | 用户属于黑名单限制 | 全部 |