Realizar SPEI®

Si su programa tiene habilitado el servicio SPEI, esta operación le permitirá realizar una “Transferencia Interbancaria” desde una tarjeta a cualquier Banco Mexicano parte de la Asociación de Bancos de México (ABM).

Solicitud HTTP

POST /spei

Parámetros del encabezado

Encabezado	Descripción
Authorization  requerida	El bearer token creado en Obtener token de autorización
Content-Type requerido	application/json

Parametros del cuerpo

Parámetro	Tipo	Patrón	Descripción
card_number requerido	cadena	16 dígitos* o uuid	number_card del remitente o card_id
payment_concept requerido	cadena	1-40 caracteres	Concepto de pago por transferencia
beneficiary_account requerido	cadena	10, 16 o 18 dígitos	Cuenta del beneficiario, puede ser teléfono, número de tarjeta o CLABE
beneficiary_institution requerida	cadena	Instituciones SPEI	Institución bancaria del beneficiario
amount  requerida	flotante	dígitos	La cantidad a transferir
beneficiary_name requerido	cadena	1-40 caracteres	Nombre de la cuenta del beneficiario
numeric_reference requerida	cadena	1-7 dígitos	Referencia numérica para el pago
beneficiary_rfc_curp requerido	cadena	'ND', 10-13 o 18 caracteres	RFC o CURP del beneficiario. Si no lo conoce, utilice la cadena 'ND'
beneficiary_email requerido	cadena	correo electrónico	Correo electrónico del beneficiario
latitude  requerida	flotante	Formato de dígitos "DD.ddddd" (precisión decimal 5)	Latitud desde donde se solicita el spei. Las latitudes sur están precedidas por un signo menos. Las latitudes van de -90 a 90
longitude  requerida	flotante	Formato de dígitos "DDD.ddddd" (precisión decimal de 5)	Longitud desde donde se solicita el spei. Las longitudes oeste van precedidas de un signo menos. Las longitudes van de -180 a 180

Nota

 *Si el card_number se envía con 16 dígitos, debe enviarse cifrado y codificado en Base 64. Consulte Codificación y cifrado de datos .

Ejemplo de solicitud JSON:

{
   "card_number": "11111111-daa7-1234-aaaa-123123123ecd",
    "payment_concept": "Pago de Renta",
    "beneficiary_account": "014027000005555558",
    "beneficiary_institution": "SANTANDER",
    "amount": 3000.25,
    "beneficiary_name": "John Doe",
    "numeric_reference": "12345" ,
    "beneficiary_rfc_curp": "ND",
    "beneficiary_email": "[email protected]",
    "latitude": 12.12345,
    "longitude": -15.12345
}

Ejemplo de respuesta JSON:

{
        "success": true,
        "code": 0,
        "message": "OK",
        "data": {
            "card": {
                "card_id": "11111111-daa7-1234-aaaa-123123123ecd",
                "card_type": "PHISYCAL",
                "masked_card_number": "************1234"
            },
            "account": {
                "account_id": "22222222-daa7-1234-aaaa-123123123ecd",
                "rfc": "XAXX010101000",
                "curp": "XEXX010101HNEXXXA4",
                "primary_phone": "5555555555",
                "mobile_phone": "5555555555",
                "observations":  ""
            },
            "spei": {
                "id": "123456",
                "tracking_key": "ABM123456789",
                "operation_date": "2021-01-01",
                "reference_operation": "ab123456-1qq2-1234-tt5g-8873fe52bf54",
                "amount": 3000.25,
                "commission": 5.80,
                "commission_type": "FLAT",
                "iva":   0.93
            }
        }
}