First, if you haven't done so already, sign up to get your merchant ID and the API secret. You only need a web3 compatible wallet, such as Metamask, to sign up. Once you log in, find the merchant ID and the API secret under Settings.
After you get your merchant ID, follow the instructions below:
On your checkout page, add the line of code below before the
Add a link or a button with the
onclick attribute that opens the payment widget:
Substitute the placeholder text with:
| ||your merchant ID|
| ||Used to track the order. If you only sell one product, you can pass an empty string |
| ||the order amount, e.g. |
| ||(optional) the order currency, e.g. |
| ||(optional) recurrence, omit or pass |
| ||(optional) a callback function to call when the payment is completed successfully|
| ||(optional) a callback function to call when the payment widget is closed and the payment was not completed|
| ||(optional) light or dark theme, defaults to |
The payment widget supports multiple languages. It detected the browser or the device default language and culture for numbers format automatically.
You may set an optional postback (a.k.a. webhook) URL in Settings. Each time a payment transaction has at least one confirmation on blockchain, our system will send a POST request to that URL to notify your backend system of the successful payment.
The POST request will contain the following data in JSON format:
We also recommend that you check the authenticity of the postback message by verifying its HMAC-SHA256 signature. We sign each message using your API secret. You can view your API secret in Settings. We pass the HMAC signature in the
Signature header of the POST request.
HMAC signature verification example in NodeJS:
Sometimes, your system my need to fetch all transactions or specific transactions in a given time range. This may be useful if your system was down for maintenance and needs to catch up with payments that were made while it was down. To get transactions, you may call the following endpoint:
All fields are optional except for
MerchantId. Make sure to pass your API secret in the
View the payments in the Payments section of the Merchant Panel. You may also verify all transaction data with the corresponding block explorers:
We recommend using a separate wallet just for ATLOS transactions.
Need integration support? Contact us at .