SPEI
我们提供基于SPEI的墨西哥汇款API。请注意汇款的参数要求在每个国家会有不同,请详细查看下面的文档。
汇款请求
请求付款,并将资金转移到外部银行机构。
HTTP请求
POST
/v1/payments/payouts/spei
Request Headers
{
"Content-Type": "application/json",
"Authorization": "Bearer {{access_token}}",
"x-api-key": "{{api_key}}"
}
Request Body
{
"idempotencyKey": "idempotency-key",
"country": "MX",
"targetName": "usera",
"targetLastName": "lastname",
"targetEmail": "usera@liquido.com",
"targetDocument": "24988323888",
"targetBankName": "STP",
"targetBankCode": "706",
"targetBankBranchId": "123456789",
"targetBankAccountId": "706180105940410332",
"targetBankId": "90706",
"amountInCents": 10000,
"currency": "USD",
"comment": "Liquido CompanyName",
"callbackUrl": "https://api.client.com/callback/",
"subMerchantId": "UUID"
}
HTTP Headers 字段说明
Key | Value |
---|---|
Content-Type | application/json |
Authorization | "bearer"+ "" + {{access_token}} |
x-api-key | {{api_key}} |
Request Body 字段说明
参数 | 是否必填 | 类型 | 描述 |
---|---|---|---|
idempotencyKey | String | 此参数用于幂等目的,交易的唯一标识ID 长度不大于128个字节。 | |
country | String | 用户的国际缩写码,遵循ISO 3166-1 alpha-2 code标准, 长度2个字节, MX | |
targetName | String | 目标账号持有人的全名.如果设置了targetLastName,此处只需要填写First Name | |
targetLastName | String | 目标账号持有人Last Name | |
targetEmail | String | 目标账户持有人的电子邮箱 | |
targetDocument | String | 目标账户持有人的证件号 | |
targetBankName | String | 目标账号的银行名称 | |
targetBankCode | String | 目标账号的银行代码 | |
targetBankBranchId | String | 目标账号的银行分支码 | |
targetBankAccountId | String | 目标账号的账号ID | |
targetBankId | String | 目标银行的ID,当targetBankAccountId为16位银行卡时为必填项。 请看支持的银行。 | |
amountInCents | Long | 汇款金额,注意: 100 = 1MXN/1USD | |
currency | String | 汇款货币代码,长度为3个字节,MXN、USD | |
comment | String | 汇款描述,建议使用公司名称或APP名称,长度不大于40个字节。默认为”payment“。 | |
callbackUrl | String | 接收交易状态变更通知的地址,接收post请求 | |
subMerchantId | String | 子商户ID。商户类型为PSP时必填。 | |
riskData | JSON | 支付的风险信息。MERCHANT_APP_NAME 或 MERCHANT_WEBSITE 在riskData中必须填一个。 请参考这里查看更多详情。 |
创建一个带风控信息的支付
请参考这里查看更多详情。
Response Body 字段说明
参数 | 类型 | 描述 |
---|---|---|
idempotencyKey | String | 交易的唯一标识ID |
statusCode | Integer | 此次请求API状态代码,200代表API请求成功, 401 访问受限, 422 参数错误, 500 内部错误 |
errorMsg | String | 如果API请求失败,返回的错误信息 |
transferStatus | String | 汇款状态,枚举值,"SETTLED", "FAILED", "IN_PROGRESS" 或者 "REJECTED", 交易状态应以transferStatus为准 |
transferStatusCode | Integer | 此次交易的状态码, 交易异常码 |
transferErrorMsg | String | 此次交易失败原因 |
支持的银行
银行Id | 银行名称 |
---|---|
37006 | BANCOMEXT |
37009 | BANOBRAS |
37019 | BANJERCITO |
37135 | NAFIN |
37166 | BaBien |
37168 | HIPOTECARIA FED |
40002 | BANAMEX |
40012 | BBVA MEXICO |
40014 | SANTANDER |
40021 | HSBC |
40030 | BAJIO |
40036 | INBURSA |
40042 | MIFEL |
40044 | SCOTIABANK |
40058 | BANREGIO |
40059 | INVEX |
40060 | BANSI |
40062 | AFIRME |
40072 | BANORTE |
40106 | BANK OF AMERICA |
40108 | MUFG |
40110 | JP MORGAN |
40112 | BMONEX |
40113 | VE POR MAS |
40127 | AZTECA |
40128 | AUTOFIN |
40129 | BARCLAYS |
40130 | COMPARTAMOS |
40132 | MULTIVA BANCO |
40133 | ACTINVER |
40136 | INTERCAM BANCO |
40137 | BANCOPPEL |
40138 | ABC CAPITAL |
40140 | CONSUBANCO |
40141 | VOLKSWAGEN |
40143 | CIBANCO |
40145 | BBASE |
40147 | BANKAOOL |
40148 | PAGATODO |
40150 | INMOBILIARIO |
40151 | DONDE |
40152 | BANCREA |
40154 | BANCO COVALTO |
40155 | ICBC |
40156 | SABADELL |
40157 | SHINHAN |
40158 | MIZUHO BANK |
40159 | BANK OF CHINA |
40160 | BANCO S3 |
90600 | MONEXCB |
90601 | GBM |
90602 | MASARI |
90605 | VALUE |
90608 | VECTOR |
90616 | FINAMEX |
90617 | VALMEX |
90620 | PROFUTURO |
90630 | CB INTERCAM |
90631 | CI BOLSA |
90634 | FINCOMUN |
90638 | NU MEXICO |
90642 | REFORMA |
90646 | STP |
90652 | CREDICAPITAL |
90653 | KUSPIT |
90656 | UNAGRA |
90659 | ASP INTEGRA OPC |
90670 | LIBERTAD |
90677 | CAJA POP MEXICA |
90680 | CRISTOBAL COLON |
90683 | CAJA TELEFONIST |
90684 | TRANSFER |
90685 | FONDO (FIRA) |
90686 | INVERCAP |
90689 | FOMPED |
90703 | TESORED |
90710 | NVIO |
90706 | ARCUS |
90661 | ALTERNATIVOS |
90723 | CUENCA |
90722 | MERCADO PAGO W |
90903 | CoDi Valida |