Skip to main content

Documentation

Payout With FX Message Sequences

Payout that includes conversion to another currency.

You can confirm the payout exchange rate automatically or manually.

Create Payout with Automatic Confirmation of Exchange Rate - Success

The following sequence is used when the FX rate is confirmed automatically.

  1. The client sends a Create Payout request to Rapyd.

  2. Rapyd sends a response with a transaction code and other details.

  3. Rapyd sends the Payout Created webhook.

  4. Rapyd converts the payout amount to the required currency and transfers the funds to the recipient.

  5. The recipient accepts the funds.

  6. Rapyd sends Payout Completed webhook to the client.

Create Payout with Manual Confirmation of Exchange Rate - Success

The following sequence is used when creation of the payout depends on manual confirmation of the FX rate.

  1. The client sends a Create Payout request to Rapyd.

  2. Rapyd sends a response. The payout status is set to Confirmation.

  3. The client sends Confirm Payout with FX request to Rapyd. This is the client's manual confirmation of the foreign exchange rate.

  4. Rapyd sends a response with the payout details. The payout status is set to Created.

  5. Rapyd sends the Payout Created webhook. The payout status is set to Created.

  6. Rapyd transfers the funds to the recipient.

  7. The recipient accepts the funds.

  8. Rapyd sends the Payout Completed webhook to the client. The payout status is set to Completed.