Start working with the Asterium Pay API and begin accepting crypto payments safely and efficiently.
Before You BeginMake sure you have access to app-stg.pay.asterium.uz and your organization has completed KYB verification.
Quick Start Steps
Register at app.asterium.io and complete KYB verification.
Obtain an access_token or generate an API Key.
Issue a payment invoice with amount, currency, and network.
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 VerifiedYou'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.
access_token by following the Authorization Flow instructions.This is a multi-factor authorization flow. The token is required for all authorized API requests.
For direct server-to-server communication, generate an API Key.
Security NoteStore API keys securely. Never expose them in client-side code or public repositories.
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 LifecycleThe 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 |
Configure settings per business unit for multi-entity setups.
| Endpoint | Method | Description |
|---|---|---|
| Get BU Config | GET | Get business unit configuration |
| Get BU Config Section | GET | Get config for a specific section |
| Update BU Config | PUT | Update business unit config |
| Get BU Schema | GET | Validate with JSON Schema |
Fine-tune configuration per terminal (POS).
| Endpoint | Method | Description |
|---|---|---|
| Get Terminal Config | GET | Get terminal-level configuration |
| Get Terminal Config Section | GET | Get config for a specific section |
| Update Terminal Config | PUT | Update terminal config section |
| Get Terminal Schema | GET | Validate with JSON Schema |
Additional Resources
Manage accounts, check balances, view deposit/withdrawal history, and perform currency exchanges.
View settlements, create settlement orders, and track settlement status.
Manage product catalog: create items, bulk import via CSV, upload photos.
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.