Overview

Introduction

FX Control is PayRetailers' comprehensive solution for managing foreign exchange complexity when operating across Latin American markets. Whether you're accepting payments from customers or sending payouts to end users, FX Control gives you complete transparency and control over currency conversion, spreads, fees, and taxes.

Why FX Control Matters

Operating in Latin America presents unique challenges when your business settles in a different currency than your customers use:

• Exchange Rate Volatility: Currency values fluctuate constantly, making it difficult to predict actual costs and revenues
• Hidden Fees: Multiple layers of spreads, taxes, and processing fees can obscure true transaction costs
• Reconciliation Complexity: Without detailed breakdowns, matching payments to deposits becomes time-consuming
• User Experience: End users deserve transparency about exactly what they're paying or receiving

FX Control solves these challenges by providing real-time, itemized breakdowns of every currency conversion, giving you the data you need to make informed business decisions and deliver transparent experiences to your users.

Two Sides of FX Control

FX Control operates in both directions of your payment flow:

Merchant FX Control (Incoming Payments)

When customers pay you in local currencies (BRL, MXN, COP, etc.) and you settle in a different wallet currency (USD, EUR, GBP):

• Receive detailed FX breakdowns at the moment of transaction creation
• Understand exactly how much you'll receive after all conversions and fees
• Choose whether to absorb FX costs or pass them to customers
• Simplify reconciliation with itemized currency conversion data

Use this for: Payment processing, checkout flows, deposit transactions

Payins FX Control (Experimental)

Payout FX Control (Outgoing Payments)

When you send payouts from your wallet currency to end users receiving funds in local currencies:

• Lock in exchange rates for up to 5 minutes with guaranteed payout quotes
• Show end users the exact local amount they'll receive before confirmation
• Eliminate surprises with deterministic, time-bound pricing
• Track complete FX breakdowns for every payout

Use this for: Withdrawals, disbursements, settlement payments to end users

Payouts FX Control (Experimental)

Key Benefits Across Both Solutions

Complete Transparency

Every transaction includes a detailed fxBreakdown object showing:

• Exchange rates applied
• Merchant spread percentages
• PSP spread percentages
• Local taxes (e.g., IOF in Brazil)
• Operation fees
• Net amounts in both currencies

Flexible Cost Management

• Configure your own merchant spread to match your business model
• Choose to absorb FX costs or pass them to end users
• Adjust strategies per market or transaction type

Simplified Reconciliation

• Detailed breakdowns in both base currency (your wallet) and local currency
• Audit trail for every conversion
• Clear attribution of all fee components

Enhanced User Experience

• Show customers transparent pricing at checkout
• Display guaranteed payout amounts before confirmation
• Build trust through clarity and predictability

Technical Overview

Both FX Control solutions integrate seamlessly with your existing PayRetailers API implementation:

Merchant FX Control adds:

• merchantSpreadPercent parameter to transaction creation
• fxBreakdown object in transaction responses

Payout FX Control adds:

• /v2/payouts/quote endpoint for creating locked quotes
• payoutQuoteId parameter in payout execution
• fxBreakdown object in payout responses and webhooks

All FX calculations use real-time market data with deterministic rounding rules, ensuring consistency and auditability.

Getting Started

FX Control features are available to PayRetailers merchants upon request:

1. Contact Your Account Manager: Reach out to discuss which FX Control features align with your business needs
2. Configure Your Account: Work with our team to set up appropriate spread percentages and enable features
3. Integrate: Follow the detailed documentation for transactions, payouts, or both
4. Go Live: Start delivering transparent FX experiences to your users

Support & Resources

• Account Manager: Your dedicated PayRetailers account manager
• Merchant Support: [email protected]