| Parameter | Description | Example |
|---|---|---|
| widget_id | Widget Id (required) | 67710925-8b40-4767-846e-3b88db69f04d |
| type | Fixed type of operation | buy or sell |
| amount | Sets an amount of cryptocurrency | 0.1 |
| fix_amount | Prevents user from changing the amount of cryptocurrency | true |
| currency | Sets cryptocurrency ticker | BTC |
| currencies | Sets an array of available cryptocurrencies | BTC,ETH |
| networks | Sets an array of available networks | ETHEREUM,BITCOIN |
| fix_currency | Prevents user from changing the cryptocurrency | true |
| fiat_amount | Sets an amount of fiat currency | 100 |
| fix_fiat_amount | Prevents user from changing the amount of fiat currency | true |
| fiat_currency | Sets fiat currency ticker | EUR |
| fix_fiat_currency | Prevents user from changing the fiat currency | true |
| fiat_currencies | Sets an array of available fiat currencies | EUR,USD |
| rates_fee_off | Sets currency rates without fees | true |
| address | Sets wallet address for the predefined currency or BTC by default | a8c1dead-ed5f-4740-b9ce-c4ea7721c93b |
| network | sets an ability to make deposits and withdrawals via L2 networks | SOLANA |
| address_map | JS object of wallets, there are several display options | %7B%22BTC%22%3A%222N2SJgCWoksfTmQySbMZhgwmdy9QNLRuD84%22%2C%22ETH%22%3A%220x7E64caCaC81B37Eaa254E9B5D1D830e9CDf70Cc5%22%7D(urlencoded JSON {"BTC": "2N2SJgCWoksfTmQySbMZhgwmdy9QNLRuD84", "ETH": "0x7E64caCaC81B37Eaa254E9B5D1D830e9CDf70Cc5"}),%7B%22BTC%22%3A%7B%22address%22%3A%222N2SJgCWoksfTmQySbMZhgwmdy9QNLRuD84%22%2C%22network%22%3A%22SOLANA%22%7D%2C%22ETH%22%3A%7B%22address%22%3A%220x7E64caCaC81B37Eaa254E9B5D1D830e9CDf70Cc5%22%2C%22network%22%3A%22SOLANA%22%7D%7D(urlencoded JSON {"BTC": {"address": "2N2SJgCWoksfTmQySbMZhgwmdy9QNLRuD84", "network": "SOLANA"}, "ETH": {"address": "0x7E64caCaC81B37Eaa254E9B5D1D830e9CDf70Cc5", "network": "SOLANA"}})or %7B%22BTC%22%3A%222N2SJgCWoksfTmQySbMZhgwmdy9QNLRuD84%22%2C%22ETH%22%3A%7B%22address%22%3A%220x7E64caCaC81B37Eaa254E9B5D1D830e9CDf70Cc5%22%2C%22network%22%3A%22SOLANA%22%7D%7D(urlencoded JSON {"BTC": "2N2SJgCWoksfTmQySbMZhgwmdy9QNLRuD84", "ETH": {"address": "0x7E64caCaC81B37Eaa254E9B5D1D830e9CDf70Cc5", "network": "SOLANA"}}) |
| refund_address | Wallet address for the predefined currency or BTC by default. It is used for refund in sell | a8c1dead-ed5f-4740-b9ce-c4ea7721c93b |
| refund_address_map | JS object of wallets for refund in sell | %7B%22BTC%22%3A%222N2SJgCWoksfTmQySbMZhgwmdy9QNLRuD84%22%2C%22ETH%22%3A%220x7E64caCaC81B37Eaa254E9B5D1D830e9CDf70Cc5%22%7D(urlencoded JSON {"BTC": "2N2SJgCWoksfTmQySbMZhgwmdy9QNLRuD84", "ETH": "0x7E64caCaC81B37Eaa254E9B5D1D830e9CDf70Cc5"}),%7B%22BTC%22%3A%7B%22address%22%3A%222N2SJgCWoksfTmQySbMZhgwmdy9QNLRuD84%22%2C%22network%22%3A%22SOLANA%22%7D%2C%22ETH%22%3A%7B%22address%22%3A%220x7E64caCaC81B37Eaa254E9B5D1D830e9CDf70Cc5%22%2C%22network%22%3A%22SOLANA%22%7D%7D(urlencoded JSON {"BTC": {"address": "2N2SJgCWoksfTmQySbMZhgwmdy9QNLRuD84", "network": "SOLANA"}, "ETH": {"address": "0x7E64caCaC81B37Eaa254E9B5D1D830e9CDf70Cc5", "network": "SOLANA"}})or %7B%22BTC%22%3A%222N2SJgCWoksfTmQySbMZhgwmdy9QNLRuD84%22%2C%22ETH%22%3A%7B%22address%22%3A%220x7E64caCaC81B37Eaa254E9B5D1D830e9CDf70Cc5%22%2C%22network%22%3A%22SOLANA%22%7D%7D(urlencoded JSON {"BTC": "2N2SJgCWoksfTmQySbMZhgwmdy9QNLRuD84", "ETH": {"address": "0x7E64caCaC81B37Eaa254E9B5D1D830e9CDf70Cc5", "network": "SOLANA"}}) |
| hide_refund_address | Not showing wallet address for refund in user interface | true |
| signature | Sets wallet address signature | cf23df2207d99a74fbe169e3eba035e633b65d94 |
| hash | Sets hash for transaction identification | 0x1234567890abcdef |
| country_code | Sets country code of user's citizenship in ISO 3166-1 alpha-2 format | cy |
| phone | Sets user phone number | 79998887766 |
| first_name | Sets user first name | Ivan |
| last_name | Sets user last name | Ivanov |
| birthdate | Sets user date of birth in dd.mm.yyyy or dd/mm/yyyy format | 01/01/1980 |
| Sets user email address | ivan@gmail.com | |
| merchant_transaction_id | Merchant's id of the transaction | d523a528503b22d25 |
| ref_code | Code for referral program | Yr89v |
| lang | a default language for user interface in ISO 639-1 format | de |
| theme | A name of a custom CSS theme | mercuryo |
| share_token | Sets SumSub share token | _act-ca0dae00-0ecd-000d-00e0-00d0ca000b0d |
| redirect_url | URL to which the user is redirected after passing the purchase or sale scenarios | https://mercuryo.io |
| fix_network | Sets an array of available networks | ETHEREUM,BINANCESMARTCHAIN,POLYGON |
| payment_method | pre-selects the payment method | card |
| fix_payment_method | locks the payment method, works with the payment_method parameter | true |
| show_spend_card_details | Show spend card details page first | true |
| is_cryptocredential_redirect | Redirect to Crypto Credentials page first | true |
| voe_declined | Disables VOE boost points display. Passed automatically by the widget when opening the external mobile pay window if the user has previously opted out of boost points | true |
| coinme_agree | Pre-fills Coinme terms agreement when opening the external mobile pay window. Passed automatically by the widget when the user has accepted Coinme terms in the current session | true |