capabilities.work

FX Preview and Pay

A 2-step recipe with dLocal. We can help you get access.

Recipe · 2 steps

FX Preview and Pay

with dLocal

Preview an FX rate and create a payment in the local currency.

  1. Retrieve the real-time exchange rate for the settlement-to-local currency corridor so the rate can be shown before charging.
  2. Create a payment denominated in the local currency now that the live FX rate has been previewed.
What you'll need to have ready
  • fromCurrency: Settlement currency to convert from (e.g. USD).
  • toCurrency: Local currency to convert to (e.g. BRL).
  • country: ISO 3166-1 alpha-2 country code (e.g. BR).
  • amount: Amount in the local currency to charge.
  • orderId: Merchant-provided order identifier.
  • paymentMethodId: Local payment method code (e.g. PIX, CARD).
  • payerName: Full name of the payer.
  • payerEmail: Email address of the payer.
  • payerDocument: National identification document of the payer.
For your developer

Arazzo workflow d-local:fx-preview-and-pay, 2 operations: getExchangeRate → createPayment. Specs on APIs.io.

More recipes with dLocal

Authorize and Capture PaymentCancel Pending PaymentCreate and Resolve KYC VerificationCreate Payment and Confirm StatusEnroll and Charge RecurringHold and Release PayoutList and Inspect Payment RefundsManage Account Bank AccountsOnboard Sub-Merchant AccountQuote and Request Payout