📘
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

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.

Endpoints involved:

Endpoint	Method	Description
OAuth2.0 Token	`POST`	Obtain access token
Create 2FA	`POST`	Set up two-factor authentication
Create Challenge	`POST`	Create 2FA challenge for verification

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.

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.