SPEI
Dirección de solicitud
SandBox
POST
https://api.supefina.tech/api/supefina/transactions/payout
Producción
POST
https://api.supefina.net/api/supefina/transactions/payout
Formas de solicitud
Encabezado de solicitud
Content-Type
application/json
Cuerpo de solicitud
account
String
Sí
Número de cuenta del beneficiario:
El número CLABE es de 18 dígitos.
La mayoría de los números de tarjeta bancaria son de 16 dígitos.
bankId
String
Sí
Número de banco del beneficiario:
Consulte específicamente: descargar > lista de bancos de México.
customerName
String
Sí
Nombre del beneficiario
description
String
Sí
Descripción del pedido:
No puede contener símbolos especiales
merId
String
Sí
ID del comerciante
Ruta para obtener el ID del comerciante: Panel de comerciante Supefina - Gestión de comerciantes - Información básica - ID del comerciante
merOrderNo
String
Sí
Número de pedido del comerciante
nonceStr
String
Sí
Cadena aleatoria
La longitud no puede exceder 32 caracteres
orderAmount
String
Sí
Monto del pedido
payProduct
String
Sí
Tipo de pago:
Número CLABE: 15
Número de tarjeta bancaria: 16
Cuando el número de cuenta del beneficiario es un CLABE, el ejemplo es 15.
Ejemplo de solicitud
{
"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"
}Parámetros de respuesta
data
Object
Datos de respuesta
amount
BigDecimal
Monto del pedido
fee
BigDecimal
Comisión anticipada
merCode
String
ID de comerciante
merOrderNo
String
Número de pedido del comerciante
supefinaOrderNo
String
Número de pedido de Supefina
transactionStatus
String
Estado del pedido. Este estado indica si la solicitud fue exitosa, sin relación con el estado real de la transacción.
00: Pedido exitoso;
04: Pedido fallido.
msg
String
Mensaje de respuesta
Ejemplo de respuesta
{
"code": "200",
"data": {
"amount": 100.00,
"fee": 2.80,
"merCode": "8302489774950079",
"merOrderNo": "P02024051517452550031520001",
"supefinaOrderNo": "2024051503020044f56bd9608964b",
"transactionStatus": "00"
},
"msg": "success "
}Notificación de callback
Método de envío: POST
SPEI permite dos notificaciones de estado de callback para pagos. Después de recibir la notificación de éxito, aún se puede recibir un cambio de estado, de éxito a fallo. El banco ejecutor verifica la información de la cuenta dos veces: tras la primera verificación, el canal nos notifica el éxito; en ese momento, el canal transfiere el dinero al banco emisor del beneficiario, que realiza una segunda verificación. Si hay errores en la cuenta del cliente, como que esté equivocada, expirada o bloqueada, el banco emisor no procesará el pago y notificará el fallo.
amount
String
Monto del pedido
customerName
String
Nombre del beneficiario
fee
String
Comisión anticipada
identifier
String
Referencia de pago Clabe
merId
String
ID del comerciante
merOrderId
String
Número de pedido del comerciante
msg
String
Descripción de la respuesta
nonceStr
String
Cadena aleatoria
La longitud no puede exceder 32 caracteres
realityAmount
String
Monto recibido
realityFee
String
Comisión recibida
reference
String
Identificador
sign
String
Firma
successTime
Date
Tiempo de éxito de la transacción
Hora UTC
supefinaOrderId
String
Número del pedido de Supefina
transactionType
String
Tipo de transacción
01：Payin
02：Payout
Ejemplo de notificación de callback
{
"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"
}Respuesta de notificación de callback
Después de que el comerciante reciba correctamente la notificación de callback, debe devolver la cadena especificada: SUCCESS. Si no se devuelve o se devuelve otro contenido, se considerará que la notificación ha fallado. Por ejemplo:
public String test(){
return "SUCCESS";
}Lista de bancos de payout en México
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
Última actualización