SPEI

Dirección de solicitud

Nombre del entorno	URL
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

Key	Value
Content-Type	application/json

Cuerpo de solicitud

Nombre de variable	Tipo	Obligatorio	Descripción
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.
callbackUrl	String	No	Dirección de callback Consulte la explicación de notificación de callback
countryId	String	Sí	Código del país Referencia：Tabla de diccionario-Código del país Mexico：MEX
currency	String	Sí	Moneda Referencia：Tabla de diccionario-Moneda Peso mexicano：MXN
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.
sign	String	Sí	Firma Referencia específica: algoritmo de firma

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

Nombre de variable	Tipo	Descripción
code	String	Código de respuesta Referencia específica: Códigos de estado 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.

Nombre de variable	Tipo	Descripción
amount	String	Monto del pedido
countryId	String	Código del país. Referencia: Tabla de diccionario - Códigos de país México: MEX
customerName	String	Nombre del beneficiario
fee	String	Comisión anticipada
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
status	String	Estado de la transacción Referencia específica: Tabla de diccionario - Estado del pedido de transacción
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",
    "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

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