Follow the steps below to add ATLOS crypto payments to your website.
Pass your merchant ID to the API methods. You may also use your wallet address instead your merchant ID. However, some features, such as postback notifications, will not be available if using a wallet address. You can find your merchant ID in the Settings section of the Merchant Panel. You will need a web3 compatible wallet to access the Merchant Panel.
On your checkout page, add the line of code below before the </body> tag:
Add a link or a button with the onclick attribute that opens the payment widget:
Substitute the placeholder text with:
merchant_id | your merchant ID |
order_id | Used to track the order. If you only sell one product, you can pass an empty string ''. |
amount | the order amount, e.g. 1234.56 |
currency | (optional) the order currency, e.g. 'USD' |
recurrence | (optional) recurrence, omit or pass atlos.RECURRENCE_NONE for one-time payments |
handleSuccess | (optional) a callback function to call when the payment is completed successfully |
handleCanceled | (optional) a callback function to call when the payment widget is closed and the payment was not completed |
Live example:
Try it:
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:
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 .