Payment flows

Please note that your side's final status and calculations shall be applied only after receiving a final callback from Citron.

If a connection disruption occurs and you do not see a transaction on your side, please be patient and wait for a final callback or check the transaction in the back office.

Deposit flow

1. You obtain the new address from Citron API (for some currencies it may be address and tag) and store it somewhere on your side.

2. You provide this address to your customer to make a deposit.

3. The customer sends some funds to this address.

4. When the transaction is sent by a customer - Citron sends a callback to your callback url with transaction details. It contains status, address, currency, amount, and fees. If the callback contains status is successful, you should deposit the respective amount to the customer balance on your side.

Deposit flow with currency exchange

You don't want to touch or store cryptocurrency but only use it as a payment method. Your customer deposits BTC, and Citron instantly converts it to EUR so that you receive EUR on your Citron account.

1. You obtain the new address from Citron API same as in deposit flow but additionally, pass another parameter "convert_to" in your request specifying the resulting currency.

2. When the new deposit arrives, Citron converts all arriving funds to destination funds and sends notifications as in a regular deposit

The merchant's base currency is one (for example EUR) and is configured by us during the integration process.

Withdrawal flow

1. You request to send the amount of money to the address.

2. Your request is validated on our side. If the signature is correct, the address is valid and you have enough balance - Citron responds to you with the transaction object.

3. You will receive a callback when the transaction status is updated.

Withdrawal flow with currency exchange

You can make payouts by automatically converting the payout amount from your main merchant balance. For example, if the merchant's main currency is EUR or USDT, and you need to make a payout in BTC, you can do this using withdrawal with exchange.

This allows you not to hold balances for payouts in volatile cryptocurrencies and not lose on the exchange rate.

1. Make the same withdraw as usual, but specify your merchant currency in the currency field when making a payout.

Important! - the merchant currency is configured during the merchants integration and auto-conversion is possible only in this currency.

1. As the second currency, define the currency in which the payout is made.

2. Your request is validated on our side. If signature is correct, address is valid and you have enough balance - Citron responds you with the transaction object.

3. You will receive a callback when transaction status is updated.

Deposit with redirect flow

A deposit with a redirect flow refers to a payment process where a customer is redirected to an external website or payment gateway to complete their deposit or payment. This method is commonly used in online transactions, especially when dealing with financial services, online casinos, or e-commerce websites where direct payment options or specific payment gateways are integrated for processing transactions.

Here's how it works:

1. Initiation: The customer chooses to make a deposit or payment on a service provider's website or app.

2. Selection of Payment Method: The customer selects their preferred payment method. This could be a bank transfer, credit card payment, e-wallet, or any other payment service.

3. Redirection: Instead of entering payment details directly on the original website, the customer is redirected to the payment service provider's page. This redirection is the "redirect flow" part of the process. To the payment service providers page also goes information about the transaction, more details about it here.

1. Payment Authorization: On the redirected website, the customer authorizes the payment by entering their payment details (either scanning the QR-code displayed on the screen or entering the deposit address manually), confirming their identity, and approving the transaction.

2. Confirmation and Redirect Back: After the payment is authorized and processed, the customer is redirected back to the original website with a confirmation of the transaction's success or failure.

1. Transaction Completion: The service provider's website then finalizes the transaction based on the received confirmation and updates the customer's account balance, order status, or any relevant details accordingly.