Skip to content

代付账户类型

accountType值字段说明
3银行账户

代付订单状态枚举

说明备注
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枚举

直连方式

支付产品说明
21BCAVA只支持游戏商户开通
22BRIVABRI
23BersamaVABersama
24PermataVAPermata
25MandiriVAMandiri
26BNIVABNI
27CIMBVACIMB
31AlfaGroupVAAlfaGroup 便利店
32IndomaretVA暂不支持
41QRISQRIS

重定向方式

支付产品说明
42Gopay暂不支持
43DanaDana
44ShopeeJumpAppsShopee 跳转App支付
45LinkAja暂不支持
47OVO_PUSHOVO推送(注意: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_InvalidateClabe无效墨西哥
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_InvalidCPF格式的收款帐号无效巴西
Params_idType_Required证件类型必传部分国家
Params_idType_Invalid证件类型无效部分国家
Params_idCard_Required证件号必传部分国家
Params_idCard_CPF_InvalidCPF证件号无效巴西
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用户属于黑名单限制全部

Released under the MIT License.