Skip to main content

Documentation

Transfer Funds Between Wallets Message Sequences

These sequences describe the process for transferring funds between two wallets. The recipient must accept or reject the incoming transaction. If the recipient does not respond, then the client must cancel the transaction.

Transfer Funds Between Wallets Sequence - Recipient Accepts Transaction

transfer-funds-between-wallets-sequence---recipient-accepts-transaction.svg
  1. Customer 1 asks Client to send funds to Customer 2.

  2. Client sends Transfer Funds Between Wallets request to Rapyd.

  3. Rapyd sends Transfer Funds Between Wallets response to Client with data.status set to PEN (pending) and removes the funds from Customer 1's wallet.

  4. Rapyd sends Webhook - Transfer Funds Between Wallets Created to Client.

  5. Client notifies Customer 2 of a pending transaction.

  6. Customer 2 responds to Client with acceptance of the transaction.

  7. Client sends Set Transfer Response request to Rapyd with status set to accept.

  8. Rapyd sends Set Transfer Response response to Client with data.status set to CLO (closed).

  9. Rapyd transfers the funds to Customer 2's wallet.

  10. Rapyd sends Webhook - Transfer Funds Between Wallets Response to Client with data.status set to accept.

Transfer Funds Between Wallets Sequence - Customer Rejects Transaction

  1. Customer 1 asks Client to send funds to Customer 2.

  2. Client sends Transfer Funds Between Wallets request to Rapyd.

  3. Rapyd sends Transfer Funds Between Wallets response to Client with data.status set to PEN (pending) and removes the funds from Customer 1’s wallet.

  4. Rapyd sends Webhook - Transfer Funds Between Wallets Created to Client.

  5. Client notifies Customer 2 of a pending transaction.

  6. Customer 2 responds to Client with rejection of the transaction.

  7. Client sends Set Transfer Response request to Rapyd with status set to decline.

  8. Rapyd sends Set Transfer Response response to Client with data.status set to DEC (declined).

  9. Rapyd releases the funds to Customer 1's wallet.

  10. Rapyd sends Webhook - Transfer Funds Between Wallets Response to Client with data.status set to decline.

Transfer Funds Between Wallets Sequence - Recipient Does Not Respond

If the recipient does not accept or decline the pending transaction, then the client must cancel the transaction to have the funds released to the sender’s wallet.

  1. Customer 1 asks Client to send funds to Customer 2.

  2. Client sends Transfer Funds Between Wallets request to Rapyd.

  3. Rapyd sends Transfer Funds Between Wallets response to Client with data.status set to PEN (pending) and removes the funds from Customer 1’s wallet.

  4. Rapyd sends Webhook - Transfer Funds Between Wallets Created to Client.

  5. Client notifies Customer 2 of a pending transaction.

  6. Customer 2 does not respond to the pending transaction notification. Client sends Set Transfer Response request to Rapyd with status set to cancel.

  7. Rapyd sends Set Transfer Response response to Client with data.status set to CAN (cancel).

  8. Rapyd releases the funds to Customer 1's wallet.

  9. Rapyd sends Webhook - Transfer Funds Between Wallets Response to Client with data.status set to cancel.