Getting Started

Start working with the Asterium Pay API and begin accepting crypto payments safely and efficiently.

📘

Before You Begin

Make sure you have access to app-stg.pay.asterium.uz and your organization has completed KYB verification.

---

Quick Start Steps

1. Create Account

Register at app.asterium.io and complete KYB verification.

2. Authenticate

Obtain an access_token or generate an API Key.

3. Create Invoice

Issue a payment invoice with amount, currency, and network.

4. Accept Payments

Process payments, handle webhooks, and manage refunds.

---

Step 1: Create an Asterium Account

Register your business account at app-stg.pay.asterium.uz.
Complete KYB (Know Your Business) verification for your organization to enable payment and settlement operations.

👍

Once Verified

You'll get access to the Merchant Dashboard where you can manage invoices, payments, settlements, and configuration.

---

Step 2: Authenticate Your Integration

OAuth 2.0API Key (Recommended))

Obtain an access_token by following the Authorization Flow instructions.

This is a multi-factor authorization flow. The token is required for all authorized API requests.

---

Step 3: Create an Invoice

Once authorized, issue payment invoices using the Invoice Creation guide.

You'll define parameters such as amount, currency, and blockchain network — and receive a ready-to-use payment URL for your customer.

Invoice API Endpoints

Endpoint	Method	Description
Create Invoice	POST	Create a new payment invoice
Get Invoice by ID	GET	Retrieve invoice details
Get Merchant Invoices	GET	List all merchant invoices
Copy Invoice	POST	Duplicate an existing invoice
Update Invoice	POST	Modify invoice parameters
Delete Invoice	DELETE	Remove an invoice
Submit Fiscal Receipt	POST	Attach fiscal receipt to invoice

Working with Rates & Currencies

Endpoint	Method	Description
Get Exchange Rate	GET	Get rate for a currency pair
Get Currency	GET	Retrieve supported currencies
Get Currency by Slug	GET	Look up currency by slug identifier

---

Step 4: Handle Payments

Learn how to manage payments, confirm statuses, and process webhook notifications in the Payment Flow documentation.

Payments

Endpoint	Method
Create Payment	POST
Get Payment	GET
List Payments	GET
Delete Payment	DELETE

Refunds

Endpoint	Method
Create Refund	POST
List Refunds	GET
Get Refund by ID	GET

📘

Payment Lifecycle

The payment flow covers the complete lifecycle: from invoice creation → payment initiation → blockchain confirmation → webhook notification → settlement.

---

Step 5: Configure Merchant Settings

Customize your integration using the configuration management guides.

Merchant LevelBusiness Unit LevelTerminal Level

Manage currencies, networks, payment methods, and fees at the merchant level.

Endpoint	Method	Description
Get Config	GET	Get merchant-level configuration
Get Config Section	GET	Get config for a specific section
Update Config	PUT	Update merchant config section
Get Config Schema	GET	Validate config with JSON Schema

---

Additional Resources

Wallet & Balances

Manage accounts, check balances, view deposit/withdrawal history, and perform currency exchanges.

Settlements

View settlements, create settlement orders, and track settlement status.

Items & Products

Manage product catalog: create items, bulk import via CSV, upload photos.

Merchant Profile

Create and manage your merchant profile for customer-facing pages.

---

👍

Need Help?

If you run into any issues during integration, reach out to the Asterium support team or consult the full API Reference.