On-ramp Widget Customization

The FaTPay widget could be customized by passing query parameters. The following parameters empower our partners to tailor the user experience according to their businesses.

All keys and values of parameters are case-sensitive. All values' format is String.

Parameters for all pages

language

• Description: Language code chosen from [Languages] for FaTPay widget, e.g. language=en;

• Default: en;

• Scope: Applicable for all partners;

• Required: Optional for all partners;

• Signed: Not required to sign;

Parameters for quotation page

fiatCurrency

• Description: Fiat currency codes chosen from [Fiat Currencies] for FaTPay widget to provide a list of selected fiat currencies to the user. Multiple currency codes should be concatenated with comma as separator, e.g. fiatCurrency=USD,THB. Then user can only pay in USD or THB;

• Default: All available fiat currencies;

• Scope: Applicable for all partners;

• Required: Optional for all partners;

• Signed: Not required to sign;

defaultFiatCurrency

• Description: Fiat currency code chosen from [Fiat Currencies] for FaTPay widget to display default fiat currency to the user, e.g. defaultFiatCurrency=USD. Then USD is selected as default fiat currency;

• Default: USD. If fiatCurrency is set, then it's the first fiat currency code;

• Scope: Applicable for all partners;

• Required: Optional for all partners;

• Signed: Not required to sign;

amount

• Description: Default fiat currency amount with two decimal digits max, e.g. amount=100.45.

• Default: None;

• Scope: Applicable for all partners;

• Required: Optional for all partners;

• Signed: Not required to sign;

amountFixed

• Description: Fixed fiat currency amount with two decimal digits max which can't be modified by the user, e.g. amountFixed=100.

• Default: None;

• Scope: Applicable for all partners;

• Required: Optional for all partners;

• Signed: Not required to sign;

cryptoCurrency

• Description: Cryptocurrency codes chosen from [Cryptocurrencies (on-ramp)] for FaTPay widget to provide a list of selected Cryptocurrency to the user. Multiple currency codes should be concatenated with comma as separator, e.g. cryptoCurrency=USDT_ERC20,USDT_POLYGON. Then user can only buy USDT_ERC20 or USDT_POLYGON;

• Default: All available cryptocurrencies;

• Scope: Applicable for all partners;

• Required: Optional for all partners;

• Signed: Not required to sign;

defaultCurrency

• Description: Cryptocurrency code chosen from [Cryptocurrencies (on-ramp)] for FaTPay widget to display default cryptocurrency to the user, e.g. defaultCurrency=USDT_POLYGON. Then USDT_POLYGON is selected as default cryptocurrency;

• Default: If cryptoCurrency is set, the default value is the first cryptocurrency code. Otherwise, it's USDT_ERC20;

• Scope: Applicable for all partners;

• Required: Optional for all partners;

• Signed: Not required to sign;

cryptoNetwork

• Description: Cryptocurrency network chosen from [Cryptocurrencies (on-ramp)] for FaTPay widget to provide a list of selected Cryptocurrency on certain public blockchains to the user, e.g. cryptoNetwork=POLYGON,ETHEREUM. Then the user can only buy the cryptocurrencies on POLYGON and ETHEREUM;

• Default: All available crypto networks;

• Scope: Applicable for all partners;

• Required: Optional for all partners;

• Signed: Not required to sign;

Parameters for wallet address page

walletAddress

• Description: Default wallet address which could be modified by the user. FaTPay will validate the wallet address if it's match with the chosen cryptocurrency. The wallet address filed will be left empty if the validation is failed. E.g. walletAddress=0xf0c35891caf1cca9b1dab1291c61ff232e6d5996;

• Default: None;

• Scope: Applicable for Basic/Premium Partners only;

• Required: Mandatory for Premium Partners. Optional for Basic Partners;

• Signed: Mandatory to sign for Premium Partners;

walletAddressLocked

• Description: 0/1. 0 means user can modify the wallet address. While 1 means to display the wallet address but prohibit users from modifying it. It should work pair with walletAddress. E.g. walletAddress=0xf0c35891caf1cca9b1dab1291c61ff232e6d5996&walletAddressLocked=1;

• Default: 0;

• Scope: Applicable for Premium Partners only;

• Required: Optional for all partners;

• Signed: Mandatory to sign for Premium Partners;

walletAddressHidden

• Description: 0/1. 0 means the wallet address is visible to the user. While 1 means the wallet address is invisible. It should work pair with walletAddress. E.g. walletAddress=0xf0c35891caf1cca9b1dab1291c61ff232e6d5996&walletAddressHidden=1;

• Default: 0;

• Scope: Applicable for Premium Partners only;

• Required: Optional for all partners;

• Signed: Mandatory to sign for Premium Partners;

Parameters for sign up/in page

email

• Description: Fill in the email address for user on FaTPay widget. Email address field will be left empty if the format validation of email address is failed. E.g. email=[e-mail];

• Default: None;

• Scope: Applicable for all partners;

• Required: Optional for all partners;

• Signed: Not required to sign;

Misc parameters

windowOpen

• Description: It's suggested to append this parameter to get rid of 403 Forbidden iframe error, e.g. windowopen=1;

• Default: 0;

• Scope: Applicable for all partners;

• Required: Optional for all partners;

• Signed: Not required to sign;

ext

• Description: Extended fields;

• Default: None;

• Scope: Applicable for all partners;

• Required: Optional for all partners;

• Signed: Mandatory to sign for Premium Partners. Should be urlencoded before sign;

How they work in user flow

You might get a better understanding how these parameters work by checking the following diagram.