MXN SPEI

Introduction

The MXN SPEI system in Mexico empowers individuals and businesses to seamlessly transfer funds in Mexican pesos, ensuring both security and efficiency. Widely adopted across the country, it exemplifies reliability and convenience, providing a trusted solution for fast and secure financial transactions.

Getting Started

• Generate Orders
• Reverse Orders

Generate Orders

To generate a MXN SPEI order, you need to send a POST request to the following endpoint:

POST /api/v1/order
Host: binance.sulpayments.ch
Content-Type: "application/json"
ACCOUNT_TOKEN: "<token>"

{
  "customer": {
    "name": "Customer’s full name",
    "document": "GALP900211HDFRPD07",
    "email": "[email protected]",
    "phone": "5598765432",
    "birth": "1996-03-09",
  },
  "order": {
    "code": "123",
    "notification_url": "your_payback_notification_url.com",
    "value": 50.00,
    "additional_info": "Some description of your order as String",
    "payment_method": "mxn_spei"
  }
}

Params descriptions

Field	Description	Value Type	Requirement
customer.name	Customer's full name	String	Required
customer.document	Customer's document (CURP or RFC)	String	Required (see notes below)
customer.email	Customer's email address	String	Optional
customer.phone	Customer's phone number	String	Optional
customer.birth	Customer's date of birth	String	Required
order.code	Order reference in your system	String	Required
order.notification_url	URL to notify when status changes	String	Required
order.value	Total order value	Number (decimal)	Required
order.additional_info	Additional description of the order	String	Required
order.payment_method	Payment method	String	Required

Note 1: The document field is a free-form string but must include a valid CURP or RFC document.

On a successful request HTTP 200 status code, the response will include the following parameters:

{
    "latam_id": "68b9e30e-e124-409d-822f-07824bad580e",
    "code": "2657189",
    "concept": "LA1100072",
    "clabe": "646180191200060363",
    "bank_code": "90646",
    "beneficiary": "LATAM BNKM SA DE CV"
}

Business errors due to incorrect or missing parameters are returned with an HTTP 400 status code. The response will indicate which parameter is invalid or missing.

{
     "message": "invalid document"
}

Reverse Orders

To reverse the order:

POST /api/v1/order/{order_id}/reverse
Host: binance.sulpayments.ch
Content-Type: "application/json"
ACCOUNT_TOKEN: "<token>"

If your request is successful, you will receive a response to the following:

{
  "message": "message": "Refund requested. Waiting for confirmation from the bank."
}