Citron
Home
  • 🍋General Description
  • Integration Guide
    • How to integrate with us?
    • Deposits
    • Withdrawals
    • Exchanges
    • Callbacks
    • What is Crypto payment form?
  • API Documentation
    • Authorization
    • Environments
    • Payment flows
    • Transaction types and statuses
    • API Endpoints
    • Callback Examples
  • How to use Citron
    • Balances
    • Transactions
    • Reports
    • Addresses and Bank Accounts
    • Fees
    • Profile
  • Confirmations and limits
  • FAQ
Powered by GitBook
On this page
  • Withdrawals
  • Common withdrawal workflow

Was this helpful?

  1. Integration Guide

Withdrawals

Contains withdrawals description and provides common workflow for that feature

PreviousDepositsNextExchanges

Last updated 4 months ago

Was this helpful?

Withdrawals

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.

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.

Page cover image