SPEI

请求地址

环境名称

URL

SandBox

POST http://8.130.9.219:8899/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

是

currency

String

是

customerName

String

是

收款人姓名

description

String

是

订单描述不能带特殊符号

merId

String

是

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

merOrderNo

String

是

商户订单号

nonceStr

String

是

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

orderAmount

String

是

订单金额

payProduct

String

是

银行卡号：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 "
}

回调通知

提交方式：POST

注意：

SPEI代付存在两次回调通知状态。代付订单收到成功回调事件后，仍然可能接收到代付状态改变的回调事件，代付状态由成功变为失败。执行付款银行会检查账户信息两次，初次通过后渠道会回调我们成功；此时渠道会把钱给收款账户的发卡行，发卡行会进行第二次账户校验；如果此时客户的收款账户错误/过期、账户被锁定等等因素，发卡行将不会付款，会通知失败。

变量名

类型

描述

amount

String

订单金额

countryId

String

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

customerName

String

收款人姓名

fee

String

预收手续费

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",
    "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

最后更新于4天前

{ "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": "200", "data": { "amount": 100.00, "fee": 2.80, "merCode": "8302489774950079", "merOrderNo": "P02024051517452550031520001", "supefinaOrderNo": "2024051503020044f56bd9608964b", "transactionStatus": "00" }, "msg": "success " }

{ "amount": "100.00", "countryId": "MEX", "customerName": "Test Name", "fee": "2.80", "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" }