代付账户类型
| 值 | 含义 | 备注 |
|---|---|---|
| 3 | 银行卡号 | 16位长度，会强制校验 |
| 40 | Clabe | 18 位长度，会强制校验 |
代付银行列表
TIP
银行支持列表以生产环境实际支持情况为准，建议您在进入生产环境前，调用我们的银行列表查询接口来确认生产银行支持情况。
TIP
当收款银行为STP（bankId=24）时，代付账户类型只允许为clabe账号（即accountType=40）
| bankId | bankCode | bankName |
|---|---|---|
| 5 | 91812 | BBVA BANCOMER2 |
| 6 | 91802 | BANAMEX2 |
| 7 | 90903 | CoDi Valida |
| 8 | 90902 | INDEVAL |
| 10 | 90706 | ARCUS |
| 11 | 90689 | FOMPED |
| 12 | 90686 | INVERCAP |
| 13 | 90685 | FONDO (FIRA) |
| 15 | 90683 | CAJA TELEFONIST |
| 16 | 90680 | CRISTOBAL COLON |
| 17 | 90677 | CAJA POP MEXICA |
| 18 | 90670 | LIBERTAD |
| 19 | 90659 | ASP INTEGRA OPC |
| 20 | 90656 | UNAGRA |
| 21 | 90653 | KUSPIT |
| 22 | 90652 | CREDICAPITAL |
| 24 | 90646 | STP |
| 25 | 90638 | AKALA |
| 26 | 90634 | FINCOMUN |
| 27 | 90631 | CI BOLSA |
| 28 | 90630 | CB INTERCAM |
| 29 | 90620 | PROFUTURO |
| 30 | 90617 | VALMEX |
| 31 | 90616 | FINAMEX |
| 32 | 90613 | MULTIVA CBOLSA |
| 33 | 90608 | VECTOR |
| 34 | 90605 | VALUE |
| 35 | 90602 | MASARI |
| 36 | 90601 | GBM |
| 37 | 90600 | MONEXCB |
| 38 | 40160 | BANCO S3 |
| 39 | 40158 | MIZUHO BANK |
| 40 | 40157 | SHINHAN |
| 41 | 40156 | SABADELL |
| 42 | 40155 | ICBC |
| 43 | 40154 | BANCO COVALTO |
| 44 | 40152 | BANCREA |
| 45 | 40151 | DONDE |
| 46 | 40150 | INMOBILIARIO |
| 47 | 40148 | PAGATODO |
| 48 | 40147 | BANKAOOL |
| 49 | 40145 | BBASE |
| 50 | 40143 | CIBANCO |
| 51 | 40141 | VOLKSWAGEN |
| 52 | 40140 | CONSUBANCO |
| 53 | 40138 | ABC CAPITAL |
| 54 | 40137 | BANCOPPEL |
| 55 | 40136 | INTERCAM BANCO |
| 56 | 40133 | ACTINVER |
| 57 | 40132 | MULTIVA BANCO |
| 58 | 40130 | COMPARTAMOS |
| 59 | 40129 | BARCLAYS |
| 60 | 40128 | AUTOFIN |
| 61 | 40127 | AZTECA |
| 62 | 40126 | CREDIT SUISSE |
| 63 | 40113 | VE POR MAS |
| 64 | 40112 | BMONEX |
| 65 | 40110 | JP MORGAN |
| 66 | 40108 | MUFG |
| 67 | 40106 | BANK OF AMERICA |
| 68 | 40072 | BANORTE |
| 69 | 40062 | AFIRME |
| 70 | 40060 | BANSI |
| 71 | 40059 | INVEX |
| 72 | 40058 | BANREGIO |
| 73 | 40044 | SCOTIABANK |
| 74 | 40042 | MIFEL |
| 75 | 40036 | INBURSA |
| 76 | 40030 | BAJIO |
| 77 | 40021 | HSBC |
| 78 | 40014 | SANTANDER |
| 79 | 40012 | BBVA MEXICO |
| 80 | 40002 | BANAMEX |
| 81 | 37168 | HIPOTECARIA FED |
| 83 | 37135 | NAFIN |
| 84 | 37019 | BANJERCITO |
| 85 | 37009 | BANOBRAS |
| 86 | 37006 | BANCOMEXT |
| 87 | 2001 | BANXICO |
| 88 | 40159 | BANK OF CHINA |
| 89 | 90642 | REFORMA |
| 92 | 90703 | TESORED |
| 93 | 90710 | NVIO |
| 94 | 37166 | BANSEFI |
| 95 | 90661 | ALTERNATIVOS |
TIP
银行ID为23/90/91的 TACTIV CB 机构（原 CB EVERCORE）自 2023 年 10 月 2 日起暂停在 SPEI 系统中接收和发送付款指令。
代付订单状态枚举
| 值 | 说明 | 备注 |
|---|---|---|
| PROCESSING | 处理中 | |
| WAITING | 路由中 | |
| PAYING | 支付中 | |
| SUCCESS | 成功 | 订单终态 |
| FAIL | 失败 | 订单终态 |
| CANCEL | 驳回/取消 | 订单终态 |
TIP
注意，在处理来自Cashy的回调或者查询结果时，应对订单状态进行精确地判断。只有终态结果才能认为代付订单明确成功/失败。
代付订单状态描述
| 值 | 说明 |
|---|---|
| ACCOUNT_NOT_EXIST | 账户不存在 |
| ACCOUNT_FREEZING | 收款账户已冻结 |
| ACCOUNT_BLOCKED | 收款账户已禁用 |
| TRACKING_KEY_REPEATED | 签发者跟踪键异常 |
| CODI_WITHOUT_NOTICE | CODI不通知付款 |
| ISSUED_CERT_EXPIRED | 颁发的证书过期 |
| COMPLIANCE_REJECT | 付款因合规而被拒绝 |
| INVALID_BANK_INSTITUTION | 无效的运营机构 |
| CLABE_INSTITUTION_NOT_MATCH | CLABE与机构不匹配 |
| REJECT_BY_PLD | 被PLD拒绝 |
| ACCOUNT_CANCEL | 账户已取消 |
| ACCOUNT_IN_ANOTHER_CURRENCY | 另一种货币的帐户 |
| ACCOUNT_NOT_BELONG_TO | 帐户不属于接收参与者 |
| 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 | 未知错误 |
| GATEWAY_TIMEOUT | 支付网关超时 |
| AMOUNT_ERROR | 金额错误 |
| PARAM_IS_NULL | 必要参数为空 |
| NONSUPPORT_PAY_CASH | 不支持现金支付 |
| NONSUPPORT_CREDIT_CARD | 不支持信用卡 |
| APPID_ERROR | 应用ID错误 |
| PARAM_ERROR | 参数错误 |
| SYSTEM_EXCEPTION | 上游系统异常 |
| UP_STREAM_SYSTEM_EXCEPTION | 上游系统异常 |
| PAYMENT_TRANSACTION_EXCEPTION | 付款交易异常 |
| PAYMENT_QUERY_FAIL | 支付查询失败 |
| BANK_NAME_ERROR | 银行名称错误 |
| BANK_CODE_ERROR | 银行编码错误 |
| BANK_ACCOUNT_ERROR | 银行账号错误 |
| PAYMENT_OFFSET | 支付冲正 |
| INVALID_ACCOUNT_NUMBER | 无效的账户号码 |
| ACCOUNTS_NOT_AUTHORISED_FOR_CREDITING | 未授权记入的账户 |
| NUMBER_AND_DOCUMENTS_NOT_MATCH | 账号和证件不匹配 |
| DOCUMENTS_INVALID | 证件号无效 |
| ACCOUNT_NOT_ENABLED | 帐户未启用 |
| BLOCKED_ACCOUNTS | 封锁的账户 |
| ACCOUNT_TYPE_NOT_VALID_FOR_TARGET_BANK | 账户类型对目标银行无效 |
| EACH_PAYMENT_LIMIT_EXCEEDED | 支付额度超过单次支付最大限额 |
| DAILY_PAYMENT_LIMIT_EXCEEDED | 支付额度超过日累计支付最大限额 |
| MONTHLY_PAYMENT_LIMIT_EXCEEDED | 支付额度超过月累计支付最大限额 |
| YEARLY_PAYMENT_LIMIT_EXCEEDED | 支付额度超过年累计支付最大限额 |
| AMOUNT_TOO_SMALL | 支付额度过低被银行拒绝 |
| ACCOUNTING_BILL_ERROR | 支付账单错误 |
| PHONE_NUMBER_INVALID | 手机号无效 |
| PAYMENT_REJECTED_BY_BANK | 付款交易被银行拒绝 |
| PAYMENT_CANCEL_BY_BANK | 付款交易被银行取消 |
| PAYMENT_REJECTED_BY_BENEFICIARY_BANK | 付款交易被收款行拒收 |
| PAYMENT_REJECTED_BY_BENEFICIARY_USER | 付款交易被收款人拒收 |
| ACCOUNT_DAILY_MAXIMUM_NUMBER_TRANSACTIONS | 收款账户已达到当日最大交易笔数 |
ERROR_PAYMENT_TYPE | 错误的付款方式 （付款到到STP必须是18位的Clabe账号） |
ACCOUNT_TYPE_NOT_APPLICABLE | 账户类型不适用 （付款到到STP必须是18位的Clabe账号） |
| CHANNEL_IB_TRY_AGAIN_LATER | 渠道异常，可稍后重试 |
代收PayType枚举
| payType | 类型 | 描述 ß |
|---|---|---|
| 41 | OXXO | 现金支付(支持门店:OXXO) |
| 69 | SPEI | SPEI (Clabe)-在线转账 |
| 70 | PAYLINK | 聚合收银台-暂不支持 |
| 71 | PAYNET | PayNet门店现金支付 |
代收订单状态枚举
| 值 | 说明 | 备注 |
|---|---|---|
| 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证件号格式无效 | 巴西 |