Integration

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.

Step 1: import ATLOS script file

On your checkout page, add the line of code below before the </body> tag:

Step 2: add a payment button

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:

Optional: postback

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:

How to view transactions

View the payments in the Payments section of the Merchant Panel. You may also verify all transaction data with the corresponding block explorers:

Ethereum Explorer

Binance Explorer

Polygon Explorer

Optimism Explorer

Arbitrum Explorer

We recommend using a separate wallet just for ATLOS transactions.

How to get help

Need integration support? Contact us at .