代付收款人证件类型
| 值 | 说明 |
|---|---|
| 1 | RUT |
TIP
RUT 必须是银行收款账号对应的RUT，否则会导致代付失败。 (针对个人RUN即是RUT)。
RUT/RUN支持以下格式,其中X为数字，K为校验位。
XX.XXX.XXX-K， XXXXXXXX-K， XXXXXXXXK， X.XXX.XXX-K， XXXXXXX-K， XXXXXXXK，
- 我们会对RUT进行格式校验和有效性校验，渠道会对RUT进行真实性校验。
- 格式校验和有效性校验会同步返回校验结果，校验失败订单会被直接拒绝。
- 真实性校验会在订单提交到银行系统后由银行校验，校验过不通过会导致代付失败。
代付账户类型
| 值 | 说明 |
|---|---|
| 1 | Corriente |
| 2 | Vista/Cuenta RUT |
| 3 | Ahorro |
TIP
Vista/Cuenta RUT 此账户类型只适用于Banco Estado银行。
代付银行列表
TIP
银行支持列表以生产环境实际支持情况为准，建议您在进入生产环境前，调用我们的银行列表查询接口来确认生产银行支持情况。
| bankId | bankCode | bankName |
|---|---|---|
| 1 | 0001 | Banco de Chile |
| 2 | 0009 | Banco Internacional |
| 3 | 0012 | Banco Estado |
| 4 | 0014 | Scotiabank Chile |
| 5 | 0016 | Banco de crédito e inversiones (BCI) |
| 6 | 0027 | Banco Corpbanca (不再支持) |
| 7 | 0028 | Banco Bice (不再支持) |
| 8 | 0031 | HSBC Bank Chile |
| 9 | 0037 | Banco Santander Chile |
| 10 | 0039 | Itaú Corpbanca |
| 11 | 0049 | Banco Security |
| 12 | 0051 | Banco Falabella |
| 13 | 0053 | Banco Ripley |
| 14 | 0054 | Rabobank Chile (不再支持) |
| 15 | 0055 | Banco Consorcio |
| 16 | 0056 | Banco Penta (不再支持) |
| 17 | 0057 | Banco Paris (不再支持) |
| 18 | 0059 | Banco BTG Pactual Chile (不再支持) |
| 19 | 0504 | Banco Bilbao Vizcaya Argentaria Chile (BBVA) |
| 20 | 0672 | Coopeuch |
| 21 | 729 | Caja los Andes |
| 22 | 730 | Tenpo |
| 23 | 732 | Los Andes |
| 24 | 875 | Mercado Pago |
代付订单状态枚举
| 值 | 说明 | 备注 |
|---|---|---|
| PROCESSING | 处理中 | |
| WAITING | 路由中 | |
| PAYING | 支付中 | |
| SUCCESS | 成功 | 订单终态 |
| FAIL | 失败 | 订单终态 |
| CANCEL | 驳回/取消 | 订单终态 |
TIP
注意，在处理来自Cashy的回调或者查询结果时，应对订单状态进行精确地判断。只有终态结果才能认为代付订单明确成功/失败。
代付订单状态描述
| 值 | 说明 |
|---|---|
| GATEWAY_TIMEOUT | 支付网关超时 |
| SYSTEM_EXCEPTION | 上游系统异常 |
| PAYMENT_TRANSACTION_EXCEPTION | 付款交易异常 |
| BANK_NAME_ERROR | 银行名称错误 |
| BANK_CODE_ERROR | 银行编码错误 |
| BANK_ACCOUNT_ERROR | 银行账号错误 |
| PAYMENT_OFFSET | 支付冲正 |
| SUCCESS | 成功 |
| UNKNOWN_ERROR | 未知错误 |
| NUMBER_AND_DOCUMENTS_NOT_MATCH | 账号和证件不匹配 |
| DOCUMENTS_INVALID | 证件号无效 |
| 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 | 付款交易被银行拒绝 |
| RUT_INVALID | 无效的RUT |
| COMPLIANCE_REJECT | 付款因合规而被拒绝 |
| BANK_ACCOUNT_INVALID | 银行账号无效 |
| TARGET_BANK_UNAVAILABLE | 目标银行暂不可用 |
| CHANNEL_IB_TRY_AGAIN_LATER | 渠道异常，可稍后重试 |
| AMOUNT_LIMIT_EXCEEDED_PAYEE | 交易金额超过收款账户限额 |
代收付款人证件类型
| 值 | 说明 |
|---|---|
| 1 | RUT |
代收PayType枚举
| 值 | 说明 | 状态 |
|---|---|---|
| 220 | 聚合收银台 | 启用，聚合收银台支持以下类型 |
| 221 | WEB_PAY | 收银台可用，直连需申请 |
| 223 | MACH | 收银台可用，直连需申请 |
| 224 | CHEK | 收银台可用，直连需申请 |
| 225 | MULTICAJA_TRANSFER | 暂不支持 |
| 226 | PAGO46 | 暂不支持 |
| 227 | HITES | 收银台可用，直连需申请 |
| 229 | MULTICAJA_EFECTIVO | 暂不支持 |
| 231 | SERVI_FACIL | 收银台可用，直连需申请 |
| 238 | BANK_TRANSFER | 暂未启用，需申请使用 |
| 239 | SERVIPAG | 暂未启用，需申请使用 |
代收支付方式说明
目前聚合收银台支持以下代收方式
- Webpay：Webpay是智利最常见的在线支付平台之一。它由Transbank运营，允许消费者使用信用卡、借记卡或银行转账来支付在线购物和其他服务。
- Khipu：Khipu是智利一家受欢迎的支付平台，提供快速、安全的银行转账服务。它通过与智利各大银行合作，使用户可以使用自己的银行账户直接进行支付。
- Mach：Mach是智利一家数字支付服务提供商，允许用户通过智能手机进行支付。用户可以用信用卡或借记卡充值Mach账户，并在多个商家和在线平台使用这些资金进行 购物和支付。
- Chek：Chek是智利一种预付卡支付方式。用户可以购买Chek卡，并在参与Chek支付的商家使用该卡进行支付，类似于预付卡或礼品卡。
- Multicaja Transfer：Multicaja Transfer是智利一种在线转账服务，允许用户使用智利的不同银行账户之间进行资金转移。
- Pago46：Pago46是智利的一种在线支付服务，专为移动设备和数字交易而设计。它提供多种支付方式，包括信用卡、借记卡和现金支付。
- Hites：Hites是智利一家零售公司，提供自己的支付服务。客户可以通过Hites卡或其他方式在Hites零售店进行支付。
- Fpay：Fpay是智利的一种数字支付服务，允许用户使用智能手机进行支付。它涵盖多种支付方式，包括信用卡、借记卡和其他电子支付方式。
代收订单状态枚举
| 值 | 说明 | 备注 |
|---|---|---|
| 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证件号格式无效 | 巴西 |