Skip to main content

🇲🇽 Mexico

Learn everything you need to know about making payouts in Mexico.

Payment Methods

  • SPEI Instant
  • Bank Transfer

Available Operations

  • Local LATAM
  • Cross Border

Payee Types

  • B2B
  • B2C

Payment Methods​

Checkout our SLAs for each payment method:

Payment MethodSLAB2BB2C
SPEISPEI< 2 minutescheck_circle_outlinecheck_circle_outline
Bank TransferBank TransferUp to 3 dayscheck_circle_outlinecheck_circle_outline

Instructions​

To create a payout using EBANX Direct API, follow the steps below.

  1. Define request parameters
    ​

    Provide the required parameters listed below to create a payout.

    FieldDescription
    integration_keyYour EBANX integration key.
    external_referenceThe unique payout ID provided by you.
    countryThe two-letter country code for the customer country. In this case, we'll show the method to mx (Mexico)
    amountThe amount in the specified currency (currency_code).
    currency_codeThree-letter code of the payout currency. In this case, we'll use MXN (Mexican Peso)
    payeeA JSON object containing the details of the payee of your request.

    Document Types Allowed

    Document typeDescription
    RFCFederal taxpayer registration (Registro Federal de Contribuyentes).
    CURPUnique Population Registry Code (Clave Única de Registro de Población), 18 characters.
    Understanding CLABE

    In Mexico, bank accounts are identified using the CLABE (Clave Bancaria Estandarizada), an 18-digit standard number. The first three digits identify the specific bank (e.g., 012 for BBVA, 002 for Banamex). This three-digit bank code is the same as the last three digits of the bank's official institution key.

  2. Send payout request to EBANX
    ​

    To create a new Payout, you will use the /ws/payout/create endpoint.

    For Mexico, when sending payee information, the bank_info tag only requires the bank_details key filled with the CLABE number. The bank_details key is mandatory. The API will automatically extract bank_name, bank_branch, bank_account and account_type values from the CLABE number.

    The following example demonstrates a payout request to an individual payee using their CLABE number:

    curl -X POST 'https://sandbox.ebanx.com/ws/payout/create' \
    --header 'Content-Type: application/json' \
    --data '{
      "integration_key": "your_test_integration_key",
      "external_reference": "PAYOUT_EBANX_MX_01",
      "country": "mx",
      "amount": 1000,
      "currency_code": "MXN",
      "payee": {
        "name": "Carlos Martinez Lopez",
        "email": "carlos.martinez@email.com",
        "phone": "+525512345678",
        "document": "MALC900101HDFRRL09",
        "document_type": "CURP",
        "bank_info": {
          "bank_details": "012180012345678907"
        },
        "address": {
          "zipcode": "06600",
          "state": "CDMX",
          "city": "Ciudad de Mexico",
          "street_address": "Av. Paseo de la Reforma 250",
          "street_complement": "Piso 10"
        }
      }
    }'

    A successful creation will return a JSON Object with type "success" and a payout object with all the details of the newly created payout.

    {
      "type": "success",
      "payout": {
        "uid": "d4685f5341c3c8c1e40ea9c06715f05778ff35ee",
        "external_reference": "PAYOUT_EBANX_MX_01",
        "status": "OP",
        "request_date": "2024-01-15 10:30:00",
        "status_date": null,
        "paid_date": null,
        "cancel_date": null,
        "payee": {
          "name": "Carlos Martinez Lopez",
          "email": "carlos.martinez@email.com",
          "phone": "525512345678",
          "document": "MALC900101HDFRRL09",
          "document_type": "CURP",
          "birthdate": null,
          "bank_info": {
            "bank_name": "012 BBVA MEXICO",
            "bank_branch": "1800",
            "bank_account": "12345678907",
            "account_type": "C",
            "bank_details": "012180012345678907"
          }
        },
        "request_amount": "1000.00",
        "request_currency": "MXN",
        "request_exchange_rate": "1.0000",
        "debit_amount": "1000.00",
        "debit_fee": "10.00",
        "debit_amount_total": "1010.00",
        "debit_currency": "MXN",
        "local_tax_amount": "0.00",
        "local_amount_total": "1000.00",
        "local_currency": "MXN",
        "local_exchange_rate": "1.0000"
      }
    }

  3. Send commit request to EBANX
    ​

    Once the new payout record is created it'll be committed automatically after 6 hours. Or you can use the /ws/payout/commit endpoint to start the payment process.

    Here's an example of a commit operation using the payout we've just created:

    curl -X POST 'https://sandbox.ebanx.com/ws/payout/commit' \
    --header 'Content-Type: application/json' \
    --data '{
      "integration_key": "your_test_integration_key",
      "uid": "d4685f5341c3c8c1e40ea9c06715f05778ff35ee"
    }'

    Once the new payout is commited, a JSON Object with type "success" will be returned.

    {
      "type": "success",
      "message": "Payout has already been committed"
    }

  4. Congratulations!
    ​

    You have successfully Created a Payout in Mexico.

Creating a Payout using the Dashboard​

You can also create a payout through our Dashboard in the Overview section of the Payout tab. Click on Create Payout, fill in the payee information, payout amount and click on Create. Additionally, you can create a Mass Payout by sending a spreadsheet to be processed in bulks.

Available Banks​

Below is the list of banks supported for payout operations in Mexico. The Bank Code corresponds to the first three digits of the CLABE number.

Institution KeyBank Code (from CLABE)Institution Name
40133133ACTINVER
40062062AFIRME
90721721albo
90706706ARCUS FI
90659659ASP INTEGRA OPC
40127127AZTECA
37166166BaBien
40030030BAJIO
40002002BANAMEX
40154154BANCO COVALTO
37006006BANCOMEXT
40137137BANCOPPEL
40160160BANCO S3
40152152BANCREA
37019019BANJERCITO
40147147BANKAOOL
40106106BANK OF AMERICA
40159159BANK OF CHINA
37009009BANOBRAS
40072072BANORTE
40058058BANREGIO
40060060BANSI
2001001BANXICO
40129129BARCLAYS
40145145BBASE
40012012BBVA MEXICO
40112112BMONEX
90677677CAJA POP MEXICA
90683683CAJA TELEFONIST
90715715CASHI CUENTA
90630630CB INTERCAM
90631631CI BOLSA
40124124CITI MEXICO
90901901CLS
90903903CoDi Valida
40130130COMPARTAMOS
40140140CONSUBANCO
90725725COOPDESARROLLO
90652652CREDICAPITAL
90688688CREDICLUB
90680680CRISTOBAL COLON
90723723Cuenca
90729729Dep y Pag Dig
40151151DONDE
90616616FINAMEX
90634634FINCOMUN
90734734FINCO PAY
90699699FONDEADORA
90685685FONDO (FIRA)
90601601GBM
40167167HEY BANCO
37168168HIPOTECARIA FED
40021021HSBC
40155155ICBC
40036036INBURSA
90902902INDEVAL
40150150INMOBILIARIO
40136136INTERCAM BANCO
40059059INVEX
40110110JP MORGAN
40128128KAPITAL
90661661KLAR
90653653KUSPIT
90670670LIBERTAD
90602602MASARI
90722722Mercado Pago W
90720720MexPago
40042042MIFEL
40158158MIZUHO BANK
90600600MONEXCB
40108108MUFG
40132132MULTIVA BANCO
37135135NAFIN
90638638NU MEXICO
90710710NVIO
40148148PAGATODO
90732732Peibo
90620620PROFUTURO
40156156SABADELL
40014014SANTANDER
40044044SCOTIABANK
40157157SHINHAN
90728728SPIN BY OXXO
90646646STP
90703703TESORED
90684684TRANSFER
40138138UALA
90656656UNAGRA
90617617VALMEX
90605605VALUE
90608608VECTOR
40113113VE POR MAS
40141141VOLKSWAGEN

Possible Errors​

Click here and check out our Payout Error Code page to learn more about the possible errors.

Still need help?

Help Image

We hope this article was helpful. If you still have questions, you can explore the following options: