SPEI

请求地址

环境名称

URL

SandBox

POST https://api.supefina.tech/api/supefina/transactions/payout

正式环境

POST https://api.supefina.net/api/supefina/transactions/payout

请求方式

请求头

Key

Value

Content-Type

application/json

请求体

变量名

类型

必填

描述

account

String

是

收款方账户号

CLABE号是18位

银行卡号大多数是16位

bankId

String

是

收款人银行编号

具体参照：下载＞墨西哥银行列表

callbackUrl

String

否

回调地址

详见通知回调说明

countryId

String

是

国家编号参照：字典表-国家编号墨西哥：MEX

currency

String

是

币种参照：字典表-货币墨西哥比索：MXN

customerName

String

是

收款人姓名

名字长度不能超过40个字符，首尾不得包含空格，但姓名之间可以有空格

description

String

是

订单描述长度不能超过200个字符，不能包含特殊符号

merId

String

是

商户ID 商户ID获取路径：Supefina商户后台-商户管理-基本信息-商户ID

merOrderNo

String

是

商户订单号

nonceStr

String

是

随机字符串长度不能超过32字符

orderAmount

String

是

订单金额

payProduct

String

是

支付类型 Clabe号：15

银行卡号：16

当收款方账户号属于CLABE的时候，示例为15

当bankId是90646-STP、90706-ARCUS FI、90684-TRANSFER、90659-ASP INTEGRA OPC时，payProduct只支持15

sign

String

是

签名具体参照：签名算法

请求示例

{
    "account": "646150996402711110",
    "bankId": "40138",
    "callbackUrl": "https://test.com",
    "countryId": "MEX",
    "currency": "MXN",
    "customerName": "Test Name",
    "description": "1",
    "merId": "8302489774950079",
    "merOrderNo": "P02024051517452550031520001",
    "nonceStr": "4qeo9p0kuz0d1a4ehtujvbdqivn7mpvg",
    "orderAmount": "100.00",
    "payProduct": "15",
    "sign": "CD4B69BE52D44552B94CFB404CA5B54F"
}

响应参数

变量名

类型

描述

code

String

响应编码具体参照：响应状态码

data

Object

响应数据

amount

BigDecimal

订单金额

fee

BigDecimal

预收手续费

merCode

String

商户ID

merOrderNo

String

商户订单号

supefinaOrderNo

String

supefina订单号

transactionStatus

String

下单状态该笔订单的的发起状态是否成功，与订单真正的交易状态无关。 00：下单成功 04：下单失败

msg

String

响应信息

响应示例

{
    "code": "200",
    "data": {
        "amount": 100.00,
        "fee": 2.80,
        "merCode": "8302489774950079",
        "merOrderNo": "P02024051517452550031520001",
        "supefinaOrderNo": "2024051503020044f56bd9608964b",
        "transactionStatus": "00"
    },
    "msg": "success "
}

回调通知

注意：SPEI代付存在两次回调的情况：代付订单收到成功回调事件后，仍然可能接收到代付状态改变的回调事件，交易状态由成功变为失败。

原因是：付款银行会进行两次账户检查：首次通过后，渠道回调成功并将款项交给发卡行，发卡行进行第二次校验。如果收款账户错误、过期或被锁定，发卡行将不付款并回调失败。

针对这种先成功后失败的情况，建议商户以最后一次收到的回调状态为准。

由于银行处理时间的不确定性，Supefina系统无法预测是否会有第二次回调及具体时间。历史数据显示，两次回调间隔通常为20秒至数小时，个别订单可能超过2天。

提交方式：POST

变量名

类型

描述

amount

String

订单金额

countryId

String

国家编号参照：字典表-国家编号墨西哥：MEX

customerName

String

收款人姓名

fee

String

预收手续费

identifier

String

付款参考 Clabe

merId

String

商户ID

merOrderId

String

商户订单号

msg

String

消息

nonceStr

String

随机字符串长度不能超过32位

realityAmount

String

实收金额

realityFee

String

实收手续费

reference

String

付款参考

sign

String

签名

status

String

交易状态具体参照：字典表——交易订单状态

successTime

String

交易成功时间

supefinaOrderId

String

supefina订单号

transactionType

String

交易类型 01：代收 02：代付

回调通知示例

{
    "amount": "100.00",
    "countryId": "MEX",
    "customerName": "Test Name",
    "fee": "2.80",
    "identifier": "706180968985601627",
    "merId": "8302489774950079",
    "merOrderId": "P02024051517452550031520001",
    "msg": "SUCCESS",
    "nonceStr": "20cba2cd-248b-4b4d-b59b-9e6997",
    "realityAmount": "100.00",
    "realityFee": "2.80",
    "reference": "2024051590706SXX5HDKCMTN4DM1S",
    "sign": "EAB0EF13923B2969FD9D55E5065B3D09",
    "status": "01",
    "successTime": 1715766375520,
    "supefinaOrderId": "2024051503020044f56bd9608964b",
    "transactionType": "02"
}

回调通知响应

商户成功收到回调后需同步返回指定字符串：SUCCESS 不返回或返回其他内容默认通知失败如：

public String test(){
	return "SUCCESS";
}

墨西哥代付银行列表

bankId

bankName

40138

ABC CAPITAL

40133

ACTINVER

40062

AFIRME

90661

ALTERNATIVOS

90706

ARCUS FI

90659

ASP INTEGRA OPC

40128

AUTOFIN

40127

AZTECA

37166

BaBien

40030

BAJIO

40002

BANAMEX

40154

BANCO COVALTO

37006

BANCOMEXT

40137

BANCOPPEL

40160

BANCO S3

40152

BANCREA

37019

BANJERCITO

40147

BANKAOOL

40106

BANK OF AMERICA

40159

BANK OF CHINA

37009

BANOBRAS

40072

BANORTE

40058

BANREGIO

40060

BANSI

40129

BARCLAYS

40145

BBASE

40012

BBVA MEXICO

40112

BMONEX

90677

CAJA POP MEXICA

90683

CAJA TELEFONIST

90630

CB INTERCAM

40143

CIBANCO

90631

CI BOLSA

90901

CLS

40130

COMPARTAMOS

40140

CONSUBANCO

90652

CREDICAPITAL

90688

CREDICLUB

90680

CRISTOBAL COLON

90723

Cuenca

40151

DONDE

90616

FINAMEX

90634

FINCOMUN

90689

FOMPED

90685

FONDO (FIRA)

90601

GBM

37168

HIPOTECARIA FED

40021

HSBC

40155

ICBC

40036

INBURSA

90902

INDEVAL

40150

INMOBILIARIO

40136

INTERCAM BANCO

90686

INVERCAP

40059

INVEX

40110

JP MORGAN

90653

KUSPIT

90670

LIBERTAD

90602

MASARI

90722

Mercado Pago W

40042

MIFEL

40158

MIZUHO BANK

90600

MONEXCB

40108

MUFG

40132

MULTIVA BANCO

37135

NAFIN

90638

NU MEXICO

90710

NVIO

40148

PAGATODO

90620

PROFUTURO

40156

SABADELL

40014

SANTANDER

40044

SCOTIABANK

40157

SHINHAN

90646

STP

90703

TESORED

90684

TRANSFER

90656

UNAGRA

90617

VALMEX

90605

VALUE

90608

VECTOR

40113

VE POR MAS

40141

VOLKSWAGEN

40124

CITI MEXICO

90699

FONDEADORA

90732

Peibo

90728

SPIN BY OXXO

最后更新于18分钟前