βš™
Options
Customize your on / off ramp experience
The following parameters allow you to customize how the on / off ramp interface is displayed by default on your website or mobile app:
Parameter
Value
Description
lang
en fr de it es
Default display language
tab
buy sell
Default display tab
tabs
buy sell
Allows to only display the "Buy" or the "Sell" tab
bsc
AUD
CAD CHF
DKK EUR GBP
HKD
JPY
NOK
NZD
SEK SGD USD ZAR
Default buy tab source currency
bdc
agEUR
AVAX BNB BTC BTCB BUSD DAI ETH
EURL
EURS
EURT
FRAX FTM
jAUD jCAD jCHF jEUR jGBP
jJPY
jSEK jSGD
jZAR
MAI MATIC
RBTC
RDOC
RIF
USDC USDT WBTC WETH XDAI XTZ
Default buy tab destination currency
ssc
agEUR
AVAX BNB BTC BTCB BUSD DAI ETH
EURL
EURS
EURT
FRAX FTM
jAUD jCAD jCHF jEUR jGBP
jJPY
jSEK jSGD
jZAR
MAI MATIC
RBTC
RDOC
RIF
USDC USDT WBTC WETH XDAI XTZ
Default sell tab source currency
sdc
AUD CAD CHF DKK EUR GBP HKD JPY NOK NZD SEK SGD USD ZAR
Default sell tab destination currency
curs
AUD
CAD CHF
DKK EUR GBP
HKD
JPY
NOK
NZD
SEK SGD USD ZAR
List of authorized fiat currencies (leave empty for all)
crys
agEUR
AVAX BNB BTC BTCB BUSD DAI ETH
EURL
EURS
EURT
FRAX FTM
jAUD jCAD jCHF jEUR jGBP
jJPY
jSEK jSGD
jZAR
MAI MATIC
RBTC
RDOC
RIF
USDC USDT WBTC WETH XDAI XTZ
List of authorized cryptocurrencies (leave empty for all)
net
arbitrum_mainnet avalanche_mainnet bitcoin_mainnet bsc_mainnet fantom_mainnet mainnet matic_mainnet optimism_mainnet
rsk_mainnet
tezos_mainnet xdai_mainnet
Default network
nets
arbitrum_mainnet avalanche_mainnet bitcoin_mainnet bsc_mainnet fantom_mainnet mainnet matic_mainnet optimism_mainnet
rsk_mainnet
tezos_mainnet xdai_mainnet
List of authorized networks (leave empty for all)
type
web popup webview
Integration type
primary
XXXXXX
Primary color, where XXXXXX is the color's hexadecimal code
success
XXXXXX
CTA color, where XXXXXX is the color's hexadecimal code
addr
public address
Allows you to automatically provide the user's receiving or sending public address (the address has to be unique for each user, common addresses are not permitted and will be rejected)
code
4-digits code
Random 4 digits code between 1000 and 9999 that you need to generate for each address supplied with the addr parameter (don't use the same code for all addresses or the validation will be rejected)
hash
#
base64 encoded signature of the following message: MtPelerin-<code>. The private key used to sign the message has to be the one matching the public address given in addr. To test it, see Test vector below
rfr
string
Referral code
mylogo
logo URL
Add your own logo, which will be displayed in the widget's footer left of the "powered by Mt Pelerin".
All parameters must be URL encoded.
Example: #FFFFFF -> %23FFFFFF

Example iFrame integration with multiple parameters

1
<iframe src="https://widget.mtpelerin.com/?lang=en&tab=sell&type=web&primary=%23e3006f&ssc=USDC&sdc=EUR&net=xdai_mainnet"></iframe>
Copied!

Test vector

You can verify that your signature for the 'hash' parameter is correct by testing it with the following info:
  • private key: 4142e80a872531fd1055f52ccab713d4c7f1eee28c33415558e74faeb516de2b
  • address: 0x270402aeB8f4dAc8203915fC26F0768feA61b532
  • code: 1234
  • hash: /37KcpG6mEp+1oAan8/HLEvcfZFXUi6kTOxTHNjD3ZloxS8DL70v7lCmXiEyDOATm4hvewMzBO2d1n25QdJ8WBw=
or with the following info:
  • seed: bamboo feed assist glove soda merry medal vanish almost solid bean loop
  • derivation path: m/44'/60'/0'/0/0
  • private key: 78ba65f1cc9427fab632340ae4d705b1485fba9f73ab5a24816907d36d5729e9
  • address: 0xEa22e16EA50A43092853329F3cEEa0825Cb9B03e
  • code: 1234
  • hash: yrXNJSmMc4wvVyKEzN4cEmLTvEaridjqTULZAfMwYAMM5PgBz4fCoIWNLr5NwKhxOYiPpI2vhMlKCihWadUw5xs=
Copy link
Contents