How-to

Create a Sandbox Account Sign In Helpdesk Legal & Privacy
Search…
How-to
Step 1
Log in to your Cryptopay account
Navigate to Settings → Widget
Generate a widget key
Step 2
Add the following meta tags to your web page.
<head>
  ...
  <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
  ...
</head>
Step 3
Add the following code to your web page.
HTML
JavaScript
<script src="https://widget-business-sandbox.cryptopay.me/widget.js" />
const el = document.createElement('SCRIPT');
el.src = 'https://widget-business-sandbox.cryptopay.me/widget.js';
document.body.appendChild(el);
Environment
src
Sandbox
​https://widget-business-sandbox.cryptopay.me/widget.js​
Production
​https://business-widget.cryptopay.me/widget.js​
Step 4
Widget initialization.
var widget = new CryptopayWidget({
  widgetKey: 'bd3476f9-57Bc-4517-b499-afb83e1538ес',
  embedded: true,
  elId: 'cryptopay-widget',
  styleOptions: {
    closeButtons: false
  }
});
Parameter
Usage
Description
widgetKey
Required
Your widget key - see Step 1
accounts
Optional
Skip this parameter to make all supported cryptocurrencies available by default. Choose which cryptocurrencies you want your customers to pay with. Can be BTC, ETH, LTC, XRP, XLM, BCH, USDT, USDC and DAI. 
embedded
Optional
If false, the widget will popup on the page
If true, the widget will be embedded
elId
Optional
cryptopay-widget by default. The place on your web page where the widget will be plugged in
styleOptions
Optional
closeButtons - Optional. Use false to hide the blue Close buttons. See the screenshots below.
​
backToSelect - Optional. Use false to hide the Back button that returns the users to the initial "Choose a coin to pay with" screen 
​
theme - Optional. Controls the color design of the widget. light (by default) or dark.
​
isShowQr - Optional. Use true to show the QR code on the mobile version of the page
Step 5
Widget calling.
widget.pay({
    amount: 10,
    currency: 'EUR',
    customId: '2a713ee9-d401-4d97-9909-b67d6755c1c7',
    onOpen: function () {},
    onClose: function () {}
});
Parameter
Type
Usage
Description
amount
number (double)
Required
Purchase amount
currency
string
Required
Purchase currency
customId
string
Required
Purchase reference ID in your system
name
string
Optional
Purchase name
description
string
Optional
Purchase description
metadata
object
Optional
Key-valued data
onOpen
function
Optional
Function to be called upon widget opening
onClose
function
Optional
Function to be called upon widget closing
​
Payment widget
Invoice callbacks
Last modified 1mo ago
Copy link
Outline