On Ramp

Lets you create Fiat deposits and automatically receive the equivalent in crypto. No manual intervention required on your end. Once enabled, the full conversion lifecycle is handled by Waltrex and settled to your master wallet.

Prerequisites

Before you can start using Autoswap, reach out to your Waltrex account manager with the following:

1. Markets: which currency corridors you need (e.g. MXN → USDT ERC-20)
2. Master Wallet: Master wallet with the network selected for your corridor, which receives the crypto once Autoswap is complete

Once confirmed, Waltrex will enable On Ramp on your account. Every deposit made to your CLABE will be automatically converted, and the resulting crypto balance will be settled in your Master Wallet. To help you monitor and respond to wallet activity in real time, webhook notifications will be sent at each key step of the automation process.
To enable this, you’ll need to configure a webhook endpoint to receive these notifications. Follow this guide to set it up.

---

How it works

Each conversion follows a three-step lifecycle:

End user deposits → Create order → Funds settled

This flow is fully automated. Your only responsibility is to display the AutoSwap CLABE where you'll receive the MXN deposits. A webhook is triggered at each status change, so your system stays in sync in real time.

---

Create a quote (Optional)

Request a quote for the conversion you want to offer your end user. The quote locks in an exchange rate for a limited time (25s). This step is only necessary if you want to display an estimated target amount to the end user before they complete their deposit.

HTTP

POST /waltrex-conversions/private/v1/quotes
authorization: Bearer YOUR_TOKEN
x-irs-csrf-token: YOUR_CSRFTOKEN
Content-Type: application/json
{
  "coinFrom": "MXN",
  "chainTo": "TRX",
  "coinTo": "USDT",
  "amountFrom": "1000"
 }

Response fields you need:

Field	Description
target_amount	The fiat currency the beneficiary will receive
expires_at	Timestamp after which this quote is no longer valid. Request a new quote to continue

---

step-by-step breakdown of the webhook event flow:

1. Deposit Received
   A deposit is made to your AutoSwap CLABE.
2. Order Created
   The order process begins
   → You receive a webhook with eventType:transaction-created.
   JSON

   {  
     "data": {
       "eventType": "order-created",
       "payload": {
         "id": "<order-tx-id>",
         "orderReference":"<reference-id>"
       }
     }
   }

3. Order Completed Confirmed
   When the order is confirmed
   → You receive a webhook with eventType:order-updated newStatus:executed
   JSON

   {  
     "data": {
       "eventType": "order-updated",
       "payload": {
         "id": "<order-tx-id>",
         "newStatus": "executed",
         "orderReference":"<reference-id>"
       }
     }
   }

   Possible newStatus values:

   Status	Meaning
   awaiting_funds	Order created, waiting for the deposit to be received
   executed	Order has been executed
   expired	Order expired before the deposit was received
   failed	Order failed before completion

4. Funds settled
   Once the order process is complete, you'll receive a crypto deposit with the converted amount.
   → You receive a webhook with eventType:transaction-created.
   JSON

   {  
     "data": {
       "eventType": "transaction-created",
       "payload": {
         "id": "<deposit-id>"
       }
     }

5. AutoSwap Completed
   → You receive a webhook with eventType:transaction-updated newStatus:mined/confirmed for the crypto deposit, confirming that Autoswap has been successfully completed for this deposit.
   JSON

   {  
     "data": {
       "eventType": "transaction-updated",
       "payload": {
         "id": "<deposit-tx-id>",
         "newStatus": "confirmed"
       }
     }
   }

   Possible newStatus values:

   Status	Meaning
   published	Transaction has been broadcast
   mined	Transaction has been mined on-chain, pending confirmations
   confirmed	Transaction has reached the required number of confirmations
   failed	Transaction failed to process
   declined	Transaction was declined
   canceled	Transaction was canceled
   dropped	Transaction was dropped from the network
   expired	Transaction expired before completion

---

Going live checklist

• Markets confirmed with your Waltrex account manager

• Webhook endpoint registered and returning 200 OK

• Handling all transaction-created and transaction-updated webhook events, including confirmed and completed statuses