Getting Started Flow

This section describes the standard flow for onboarding and starting work with the crypto acquiring system. The process is intentionally straightforward and mirrors familiar patterns from traditional payment acquiring.

1. Terminal Creation

The first step is creating a terminal via the main dashboard.

A terminal is a logical entity used to group and manage payment orders. Terminals allow merchants to separate payment flows based on business needs, for example:

• Different online stores or websites
• Different brands under one company
• Separate product categories or business lines
• Test and production environments

Each payment order is always associated with a specific terminal, which makes reporting, analytics, and access control clear and predictable.

2. API Key Generation

After the terminal is created, an API key must be issued for it.

Key characteristics of the API key:

• Each API key is uniquely linked to a single terminal
• Requests made with the key can only operate within that terminal’s scope
• The full API key is displayed only once at the moment of creation
• After that, part of the key is permanently hidden for security reasons

Important: Store the API key securely. If the key is lost or compromised, it must be revoked and reissued.

The API key is used to authenticate all requests to the acquiring API, including payment creation, status checks, and webhook verification.

3. Integration and Payment Initialization

With the terminal and API key in place, the next step is integrating the acquiring system into your application.

At this stage, the merchant:

• Integrates the API or uses a hosted payment page
• Creates payment orders programmatically from their backend
• Passes order details such as amount, currency, and external order ID

Once a payment order is created, the system generates a payment flow for the customer, including wallet addres with qr.

4. Payment Processing and Status Tracking

After the customer completes the payment:

• The transaction is detected and verified on-chain
• The payment status is updated in real time
• Webhooks notify the merchant’s system about status changes

This ensures reliable synchronization between blockchain events and the merchant’s internal order management system.

5. Funds Availability and Further Operations

When the payment is confirmed:

• Funds are credited to the merchant’s balance for the corresponding terminal
• The merchant can monitor transactions and balances via the dashboard or API
• Funds can be held, exchanged, or used for payouts according to business needs

This flow provides a clear and secure path from terminal setup to live crypto payment acceptance, enabling fast onboarding and predictable operations.