Create SPEI®

If your program has SPEI service enabled, this operation allow you to make an "Interbanking Transfer" from a card to any Mexican Bank part of Mexican Bank Association (Asociación de Bancos de México – ABM).

HTTP Request

POST /spei

Header Parameters

Header	Description
Authorization  required	The Bearer token created in Get authorization Token
Content-Type  required	application/json

Body Parameters

Parameter	Type	Pattern	Description
card_number  required	string	16 digits* or uuid	Sender's card number or card_id
payment_concept  required	string	1-40 characters	Transfer payment concept
beneficiary_account  required	string	10, 16 or 18 digits	Beneficiary's account, can be phone, card number or CLABE
beneficiary_institution  required	string	SPEI Institutions	Beneficiary's bank institution
amount  required	float	digits	Amount to transfer
beneficiary_name  required	string	1-40 characters	Beneficiary's account name
numeric_reference  required	string	1-7 digits	Numeric reference for payment
beneficiary_rfc_curp  required	string	'ND', 10-13 or 18 characters	Beneficiary's RFC or CURP. If not known use 'ND' string
beneficiary_email  required	string	email	Beneficiary's email
latitude  required	float	Digits format "DD.ddddd" (5 decimal precision)	Latitude from where the spei is requested. South latitudes are preceded by a minus sign. Latitudes range from -90 to 90
longitude  required	float	Digits format "DDD.ddddd" (5 decimal precision)	Longitude from where the spei is requested. West longitudes are preceded by a minus sign. Longitudes range from -180 to 180

note

*If card_number is sended as 16 digits, it must be sended ciphered and Base 64 Encoded. See Data encryption & encoding.

Example JSON Request:

{
   "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
}

Example JSON Response:

{
        "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
            }
        }
}