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 gets | Payment method | Usually arrives in |
|---|---|---|
| MXN | SPEI | 0–5 minutes |
| USD | Wire | 1–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_methodis the local payment network, hereSPEI.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.
Updated about 1 month ago