Convert with certainty. Lock the rate first.

# 1) Quote — illustrative parameters, see docs.localpayment.com curl -G https://api.stage.localpayment.com/api/fx/currency-exchange/CurrencyExchange \ -H "Authorization: Bearer $ACCESS_TOKEN" \ --data-urlencode "sourceCurrency=BRL" \ --data-urlencode "quoteCurrency=USD" \ --data-urlencode "accountNumber=<your-BRL-account>" \ --data-urlencode "quoteAccountNumber=<your-USD-account>" # → { "exchangeRateToken": "fxq_7Qk2...", "expirationDate": "2026-09-30T11:05:00-03:00", "quotes": [ ... ] } # 2) Convert at the locked rate before it expires curl -X POST https://api.stage.localpayment.com/api/currency-exchange \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "externalId": "b1d2c3e4-0000-4000-8000-000000000077", "country": "BRA", "currency": "BRL", "exchangeRateToken": "fxq_7Qk2...", "account": { "debited": { "currency": "BRL", "accountNumber": "<your-BRL-account>", "amount": 250000.00 }, "credited": { "currency": "USD", "accountNumber": "<your-USD-account>" } } }'

# 1) Quote — illustrative parameters, see docs.localpayment.com
curl -G https://api.stage.localpayment.com/api/fx/currency-exchange/CurrencyExchange \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data-urlencode "sourceCurrency=BRL" \
  --data-urlencode "quoteCurrency=USD" \
  --data-urlencode "accountNumber=<your-BRL-account>" \
  --data-urlencode "quoteAccountNumber=<your-USD-account>"
# → { "exchangeRateToken": "fxq_7Qk2...", "expirationDate": "2026-09-30T11:05:00-03:00", "quotes": [ ... ] }

# 2) Convert at the locked rate before it expires
curl -X POST https://api.stage.localpayment.com/api/currency-exchange \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "b1d2c3e4-0000-4000-8000-000000000077",
    "country": "BRA",
    "currency": "BRL",
    "exchangeRateToken": "fxq_7Qk2...",
    "account": {
      "debited": { "currency": "BRL", "accountNumber": "<your-BRL-account>", "amount": 250000.00 },
      "credited": { "currency": "USD", "accountNumber": "<your-USD-account>" }
    }
  }'

// Illustrative. Fields simplified; credentials come from your secrets manager. const headers = { Authorization: `Bearer ${access}`, 'Content-Type': 'application/json' }; // Quote and lock const params = new URLSearchParams({ sourceCurrency: 'MXN', quoteCurrency: 'USD', accountNumber: process.env.LP_MXN_ACCOUNT, quoteAccountNumber: process.env.LP_USD_ACCOUNT, }); const quote = await fetch(`https://api.stage.localpayment.com/api/fx/currency-exchange/CurrencyExchange?${params}`, { headers }) .then((r) => r.json()); // Execute before the quote expires if (new Date(quote.expirationDate) > new Date()) { await fetch('https://api.stage.localpayment.com/api/currency-exchange', { method: 'POST', headers, body: JSON.stringify({ externalId: crypto.randomUUID(), country: 'MEX', currency: 'MXN', exchangeRateToken: quote.exchangeRateToken, account: { debited: { currency: 'MXN', accountNumber: process.env.LP_MXN_ACCOUNT, amount: 4500000 }, credited: { currency: 'USD', accountNumber: process.env.LP_USD_ACCOUNT }, }, }), }); }

// Illustrative. Fields simplified; credentials come from your secrets manager.
const headers = { Authorization: `Bearer ${access}`, 'Content-Type': 'application/json' };

// Quote and lock
const params = new URLSearchParams({
  sourceCurrency: 'MXN',
  quoteCurrency: 'USD',
  accountNumber: process.env.LP_MXN_ACCOUNT,
  quoteAccountNumber: process.env.LP_USD_ACCOUNT,
});
const quote = await fetch(`https://api.stage.localpayment.com/api/fx/currency-exchange/CurrencyExchange?${params}`, { headers })
  .then((r) => r.json());

// Execute before the quote expires
if (new Date(quote.expirationDate) > new Date()) {
  await fetch('https://api.stage.localpayment.com/api/currency-exchange', {
    method: 'POST',
    headers,
    body: JSON.stringify({
      externalId: crypto.randomUUID(),
      country: 'MEX',
      currency: 'MXN',
      exchangeRateToken: quote.exchangeRateToken,
      account: {
        debited: { currency: 'MXN', accountNumber: process.env.LP_MXN_ACCOUNT, amount: 4500000 },
        credited: { currency: 'USD', accountNumber: process.env.LP_USD_ACCOUNT },
      },
    }),
  });
}