SPEI

Rail overview

Use SPEI to withdraw MXN from an internal Conomy account to a Mexican bank account.

After capture, Conomy sends the payout through the provider and updates the payment when the bank rail confirms completion or failure.

Region Mexico

Currency MXN

Direction Pay-out

Model CLABE bank transfer

Validate CLABE and recipient identity data before capture; Mexican bank payouts are sensitive to account-number correctness.

Required fields

Field	Type	Description
type	string	Must be "SPEI"
currency	string	Must be "MXN"
spei.customer.firstName	string	Customer’s first name
spei.customer.lastName	string	Customer’s last name
spei.clabe	string	18-digit CLABE (required for pay-out)
spei.bankId	string	Bank identifier code

Pay-in example

For pay-in, the user sends a transfer to the CLABE generated in the response:

{
  "type": "SPEI",
  "currency": "MXN",
  "spei": {
    "customer": {
      "firstName": "Carlos",
      "lastName": "Mendoza"
    }
  }
}

Pay-out example

For pay-out, provide the recipient’s CLABE:

{
  "type": "SPEI",
  "currency": "MXN",
  "spei": {
    "clabe": "032180000118359719",
    "customer": {
      "firstName": "Ana",
      "lastName": "López"
    }
  }
}

Response fields (pay-in)

Field	Description
clabe	CLABE the payer should transfer to
bankId	Receiving bank code

Share the spei.clabe with your user so they can complete the transfer from their banking app.

Object

clabestring

CLABE (18-digit interbank code) of the recipient. Required for pay-out.

customerobjectrequired

Information on who pays the transaction

idstring

Unique identifier for the internal service.

firstNamestringrequired

Payer's name

emailstring

Payer's email

lastNamestring

Payer's last name

phoneNumberstring

Payer's phone number without prefix

phoneNumberPrefixstring

Phone number prefix (e.g., +57)

documentTypestring

Documeny type of the entity (e.g., RUT, CURP, CURL). Go to the Supported Identity document types page for the complete list of supported values.

documentNumberstring

The document number associated with the documentType

addressobjectshow 8 properties

The entity’s address information.