A rate lock reserves a specific exchange rate for a defined period, guaranteeing the rate for a subsequent payment.
1. POST to /v1/fx/lock with: from, to, amount, direction (sell or buy).
2. The response returns a rateLockId, the locked rate, the locked amount, and an expiresAt timestamp.
💡 Tip: Use direction sell when you know the source amount; buy when you know the destination amount. |
3. Include the rateLockId in your POST /v1/payments request to execute at the locked rate.
⚠️ Warning: Rate locks expire. If your payment is not submitted before expiresAt, request a new lock. |
Related articles: