In this section we'll go through the endpoints you'll need to execute crypto payments on your website. You can make use of our hosted checkout experience or spin-off a custom UI.Guidelines for checkout integration in Iframe#
To provide the best user experience, we strongly recommend that you use the following dimensions when displaying our checkout:Minimal dimensions for the checkout Iframe- height: 500px; width: 360px;
Optimal dimensions for the checkout Iframe - height: 627px; width: 450px;
allow="clipboard-write" property to your <iframe> tag.Payment statuses#
| Status | Description |
|---|
| NEW | A payment has been created, however, no depositCurrency has been selected yet. (Screen 1 above) |
| PENDING | Customer has selected a depositCurrency and is presented with a cryptocurrency deposit address. Finrax listens for blockchain events on the particular wallet address. |
| AWAITING | This is an optional status. It will be skipped if the deposit is eligible for Instant Deposits. This status represents that we've "seen" a transfer on the blockchain, but is still in UNCONFIRMED status. Transaction has not been validated yet on the blockchain (Screen 4 above) |
| DEPOSITED | The transaction has been completed and your account balance has been updated. A callback notification is triggered to your designated endpoint. |
| EXPIRED | Once the expirationMinutes is reached and no deposit has been received against the supplied wallet address, the payment will be changed to status EXPIRED. Bear in mind that this is a tentative status. If we locate a blockchain transaction after the payment is changed to EXPIRED, we'll update the status from EXPIRED to DEPOSITED and trigger a callback notification. |
| BLOCKED | The transaction received against a given payment has been blocked due to compliance reasons. This usually happens if the origin of funds is marked as illicit (i.e. Darknet, Scam , etc.) |
| OVERPAID | Only present if the business has the overpayment logic active. The deposited amount exceeded the expected amount, starting the process of refunding. |
Adding side chain support for deposits #
If the network field is not included in the request, then we'll use the default network for respective currency. Details for the supported deposit and default deposit networks can be found in the table below.List of currencies and their supported deposit networks #
| Currency | Network | Default Network |
|---|
| USDC | Ethereum chain (ETH), Binance Smart Chain (BSC) and Solana network (SPL) | Ethereum chain (ETH) |
| ETH | Ethereum chain (ETH) and Binance Smart Chain (BSC) | Ethereum chain (ETH) |
| USDT | Ethereum chain (ETH), Binance Smart Chain (BSC), Tron Chain (TRX) and Solana network (SPL) | Ethereum chain (ETH) |
| SOL | SOL | Solana network (SPL) |
| BTC | BTC | BTC |
| BCH | BCH | BCH |
| LTC | LTC | LTC |
| XRP | XRP | XRP |
| XLM | XLM | XLM |
| LINK | ETH | ETH |
Modified at 2024-07-09 07:37:37
