MXN Offramps

Endpoint MigrationThe /v1/automations endpoints have been renamed to /v1/payment-routes. The old /v1/automations paths remain available as deprecated aliases during migration. Update your integrations to use /v1/payment-routes as the deprecated endpoints will be removed in a future release.

MXN offramps follow the same flow as standard offramps, but with MXN as the destination currency and SPEI as the rail. This guide covers only the differences. Refer to the offramps guide for the full integration flow, managing payment routes, webhooks, and settlement details.

Differences from USD offramps

Step 1: create a payment account

Before creating an MXN offramp payment route, register the beneficiary’s Mexican bank account as a payment account. The key difference is using mxn as the currency, mx_spei as the rail, and providing a clabeNumber instead of accountNumber and routingNumber.

Request

curl -X POST https://api.rain.xyz/v1/payment-accounts \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "externalFiatAccount",
    "userId": "11111111-1111-1111-1111-111111111111",
    "nickname": "Juan SPEI Account",
    "externalFiatAccount": {
      "currency": "mxn",
      "rail": "mx_spei",
      "thirdParty": true,
      "beneficiaryFirstName": "Juan",
      "beneficiaryLastName": "Perez",
      "beneficiaryType": "individual",
      "clabeNumber": "032180000118359719"
    }
  }'

Response

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "type": "externalFiatAccount",
  "nickname": "Juan SPEI Account",
  "userId": "11111111-1111-1111-1111-111111111111",
  "externalFiatAccount": {
    "currency": "mxn",
    "rail": "mx_spei",
    "thirdParty": true,
    "beneficiaryFirstName": "Juan",
    "beneficiaryLastName": "Perez",
    "beneficiaryType": "individual",
    "clabeNumber": "032180000118359719"
  },
  "createdAt": "2025-01-15T10:30:00Z"
}

Required fields for MXN/SPEI

Field	Required
`clabeNumber`	Required
`beneficiaryType`	Required

Beneficiary type and name fieldsSet beneficiaryType to either individual or business. The name fields you must provide depend on this value:

Individual: provide beneficiaryFirstName and beneficiaryLastName.
Business: provide beneficiaryBusinessName.

Unlike USD payment accounts, MXN/SPEI accounts only require a clabeNumber (18-digit CLABE) and beneficiaryType. They don’t need accountNumber, routingNumber, bankAccountType, beneficiaryAddress, bankName, or bankAddress.

Step 2: create an offramp payment route

Once you have a payment account, create the offramp payment route. The request and response follow the same structure as the standard offramp, with MXN as the destination:

curl -X POST https://api.rain.xyz/v1/payment-routes \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "11111111-1111-1111-1111-111111111111",
    "source": {
      "currency": "usdc",
      "rail": "base"
    },
    "destination": {
      "currency": "mxn",
      "rail": "mx_spei",
      "address": {
        "type": "paymentAccount",
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      }
    },
    "refundAddress": "0x1234567890abcdef1234567890abcdef12345678"
  }'

Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "userId": "11111111-1111-1111-1111-111111111111",
  "status": "active",
  "source": {
    "currency": "usdc",
    "rail": "base"
  },
  "destination": {
    "currency": "mxn",
    "rail": "mx_spei",
    "address": {
      "type": "paymentAccount",
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    }
  },
  "refundAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "depositAddress": {
    "type": "onchain",
    "address": "0xabcdef1234567890abcdef1234567890abcdef12"
  },
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-15T10:30:00Z"
}

Once the payment route is active, sending stablecoin to the depositAddress triggers a conversion and SPEI transfer of MXN to the user’s bank account.

MXN payment routes can’t be updated after creation. To change one, delete the route and create a new one.

Introduction

Set Up Money Movement

Money Movement

Subtenants

Reconciliation

MXN Offramps

Differences from USD offramps

Step 1: create a payment account

Request

Response

Required fields for MXN/SPEI

Step 2: create an offramp payment route

Response

​Differences from USD offramps

​Step 1: create a payment account

​Request

​Response

​Required fields for MXN/SPEI

​Step 2: create an offramp payment route

​Response

Differences from USD offramps

Step 1: create a payment account

Request

Response

Required fields for MXN/SPEI

Step 2: create an offramp payment route

Response