Transfer to Local Currency

Pay recipients in their own currency, through their country's local payment network.

A local currency transfer is an off-ramp where the recipient gets their own currency, such as MXN in Mexico or BRL in Brazil, in a local bank account. The funds move through the country's local payment network, such as SPEI or PIX, instead of an international wire.

Local Currency or USD

In many countries, you can pay the recipient either in the local currency or in USD. For example, in Mexico:

Recipient getsPayment methodUsually arrives in
MXNSPEI0–5 minutes
USDWire1–3 days

With a local currency transfer:

  • The recipient doesn't have to convert USD themselves.
  • The funds usually arrive faster.
  • Each country has its own payment method and account details. For example, SPEI needs the recipient's CLABE.

How It Works

When you create a quote, set destination.asset to the local currency and destination.country to the recipient's country:

curl --location --request POST 'https://harbor-sandbox.owlpay.com/api/v2/transfers/quotes' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'X-API-KEY: {{API_KEY}}' \
--data-raw '{
    "source": {
        "country": "US",
        "chain": "ethereum",
        "asset": "USDC",
        "type": "individual",
        "amount": 100
    },
    "destination": {
        "country": "MX",
        "asset": "MXN",
        "type": "individual"
    }
}'
{
    "data": [
        {
            "id": "quote_Ny1I5vlxqKZrRdLr3modSVtN8U4dAmxb76HGDQgd",
            "payment_method": "SPEI",
            "source_amount": "100.000000",
            "source_currency": "USDC",
            "destination_amount": "1768.21",
            "destination_currency": "MXN",
            "exchange_rate": "17.68210000",
            "fiat_settlement_time_min": 0,
            "fiat_settlement_time_max": 5,
            "fiat_settlement_time_unit": "MINUTES",
            ...
        }
    ]
}
  • payment_method is the local payment network, here SPEI.
  • fiat_settlement_time_* shows how long the payout usually takes.
  • The transfer requirements for this quote list the account details that country needs, such as mx_clabe.

For the full steps, see the Off-Ramp guide.

When the transfer is completed, the payout was sent. SPEI settles in real time, so for SPEI the funds have reached the recipient's account. The transfer's receipt.tracking_number has the network's reference, such as the SPEI clave de rastreo. In Production, the recipient's bank can use it to find the payment. See Confirm the Payout.

Supported Countries

For the countries, local currencies and payment methods available, see Off-Ramp Coverage.


Did this page help you?