FX & Rate Locking (Payout)

Where FX applies in PAYOUT

FX is introduced when the source currency differs from the destination currency:

• You create a quotation using POST /api/v1/pay-out/create-quotation.
• The quotation response returns:
  • wholesale_fx_rate (market/wholesale reference)
  • fee (transaction fee)
  • computed destination.amount or source.amount depending on the chosen mode.

---

Rate Locking Rules

When you create a quotation:

• FX rate and fees are locked until expiration_date.
• You must create the payout transaction before the quotation expires to guarantee the quoted values.
• After expiration, you must create a new quotation.

---

Fee models

Fees may be applied by Cashela and/or underlying payout networks.

• Fees are surfaced in the quotation response under fee.
• Always show fees and the effective rate to users prior to confirmation.

---

Example (from quotation)

{
  "wholesale_fx_rate": 5.41696,
  "fee": { "amount": 118.2, "currency": "USD" },
  "expiration_date": "2025-12-22T13:56:04.000Z"
}

---

Best Practices

• Create the transaction immediately after payer selection.
• Cache quotation details and enforce expiry client-side.
• Do not reuse a quotation after expiration.

---

See Also

• Create Quotation
• Rate Locking Rules (Quotation)