Quickstart

Getting an API key

1. Open the Atomic Pay dashboard and select the project that needs a key.

2. Open the project settings.

3. In the «Integrations» section, click «Create new key» in the API key block.

4. Name the key and choose its access settings: allowed IPs and whether withdrawals via API are allowed.

5. Save the key — it cannot be viewed again after the dialog is closed. Use it to authorize Merchant API requests.

First integration

1. Get the coins and networks available to the project via GET /project/currencies.
2. Create your first invoice with POST /invoices.
3. Store the invoice uuid from the response.
4. Set up a webhook in the project dashboard.
5. Wait for the webhook about the invoice status change.
6. Check the current invoice state via GET /invoices/{invoiceId}.

curl -X POST "https://api.atomic.wallet/api/v1/invoices" \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "coinCode": "USDT",
  "networkCode": "tron",
  "amount": "100.00",
  "currency": "USD",
  "orderId": "order-1001",
  "description": "Order payment"
}'

This order lets you check the available assets, create a test invoice and make sure that API requests and webhooks work correctly.