Withdrawals

Contains withdrawals description and provides common workflow for that feature

To the opposite of deposits, sending cryptocurrencies to the users is similar to classic payment methods. Users fill the form where they provide the address and the amount of the withdrawal. After that the web-service creates the transaction and sends a withdrawal request to the payment provider. When the transaction is confirmed by the payment provider, the web-service decreases the user's balance on the website.

Common withdrawal workflow

The most common scenario for sending crypto is "withdrawal with exchange". Citron provides web-services with on-the-fly exchange solution. This means that the funds that are stored on a merchant's fiat balance can be automatically converted into cryptocurrencies before being sent to the user's crypto wallet.

In case of regular withdrawals without exchange the workflow will be the same except of conversion operation.

Withdrawal Algorithm

1

Client makes a withdrawal request to the merchant, and also provides the wallet.

2

The merchant sends the amount to the API along with the clients ID and wallet.

3

Citron makes a withdrawal to the provided wallet.

4

After a successful transaction on the blockchain, Citron sends a callback to the merchant.

5

Merchant notifies the client of a successful withdrawal.

Hint

In order to make a withdrawal you should use the "/withdrawal/crypto" method from our API. You can define what currency should be used to send the funds, and, if necessary, from what fiat currency the funds should be converted before sending to the user.

Attention

Unlike the "/addresses/take" method, you should use the unique "foreign_id" every time you make a withdrawal request to our system.

Withdrawal Confirmation Guide

The Withdrawal Confirmation feature enhances security by requiring a secondary approval for all withdrawal requests. This ensures that no single user can authorize a payout independently, providing a robust safeguard for your funds.

Feature Activation

To enable Withdrawal Confirmation, navigate to your merchant account settings.

1

Locate Withdrawal Confirmation in Settings

Status must be Disabled

2

Click Enable

At least two users with withdrawal rights must exist

3

Complete 2FA Verification

You must have an authorized device/app

4

Confirm via Email

You must have a primary account email

Important!

This feature cannot be enabled for projects with only one user. If attempted, the system will prompt you to create an additional user with withdrawal rights.

Withdrawal workflow

Once active, the withdrawal process follows a dual-authorization flow.

1

Initiation

User creates a withdrawal request.

2

Notification

The system displays the message: "The payout has been sent for confirmation."

3

Status Update

The request enters the Waiting for approval status.

4

Approval

An Approve button appears next to the transaction.

• The initiator cannot approve their own request.

• Any other user with withdrawal rights can approve the request.

5

Finalization

Once approved, the status changes to Pending, and the standard payout process continues.

Feature Deactivation

1

Click Disable in Settings

Status must be Enabled

2

Complete 2FA Verification

You must have an authorized device/app.

3

Select Approving User

Choose from users with withdrawal rights.

4

Dual Email Confirmation

Approval required from two separate email addresses.

Notifications

Stay informed about pending approvals by configuring alerts in your notification settings.

• Email: Receive direct alerts for every withdrawal awaiting approval.

• Slack: Integrate your workspace to receive real-time notifications in a designated channel.