跳转至

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"
}
Content-Type: application/json
{
    "idempotencyKey": "idempotency-key",
    "statusCode": 200,
    "errorMsg": "",
    "transferStatus": "IN_PROGRESS",
    "transferStatusCode": 200,
    "transferErrorMsg": ""
}

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_NAMEMERCHANT_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
回到页面顶部