API documentation

Aeris API documentation

Reference for authentication, creating payments and payouts, webhook events and status checks.

Main sections

Base URL
https://aeris-psp.net
Data format
application/json

API keys

The primary key is created with the project. You can issue up to four additional keys in the dashboard. The same section contains the notification URL, server IP/CIDR ranges and HTTPS widget domains. Viewing keys and saving changes requires confirmation through Telegram or an authenticator app.

Settings → API keys
Primary key + up to 4 additional keys

Settings → Webhook and access
Webhook URL → default notification endpoint
API IP → server addresses
Checkout origins → website domains

Authentication

Every request is signed with HMAC-SHA256. Send the timestamp as Unix seconds within the accepted time window. Serialize JSON compactly without spaces. Use an empty body for GET requests.

body = compact_json(request_body)
message = body + ":" + unix_timestamp + "++"
signature = hex(hmac_sha256(base64(secret_key), message))

X-API-KEY: <public_key>
X-TIMESTAMP: <unix_seconds>
X-SIGNATURE: <signature>
Create a paymentSBP, SberPay and bank cards
SBP

Pay with SBP

The customer scans a QR code on desktop or opens their banking app on a smartphone.

When to useThe main checkout flow for online stores when fast payment without card entry matters.
  1. Your website
    Creates a payment

    The backend signs the request and stores the operation ID.

  2. Aeris
    Returns payment_url

    Open the URL directly or pass it to Payment page or Widget.

  3. Customer
    Selects a bank

    On desktop, scans the QR code. On mobile, opens the banking app.

  4. Your website
    Receives the final status

    Fulfil the order only after completed arrives through webhook or status API.

Aeris payment page

Desktop
Order 10001

Order payment

RUB 9,000

Demo Store
Payment method

The result will appear on this page

Mobile
Order 10001

Order payment

RUB 9,000

Demo Store
Payment method

The result will appear on this page

Create a payoutBank card in RUB and USDT on TRON
Bank card

Payout to a bank card

Transfer RUB by card number. Creation requires the recipient phone and name; use the payout status as the final result.

When to useRefunds, rewards and batch payouts to individuals in Russia.
  1. Your website
    Creates a payout

    Sends amount, unique order number and beneficiary details.

  2. Aeris
    Reserves the amount

    Payout and fee are reserved. Reusing merchant_order_id does not create a duplicate.

  3. Payment network
    Processes the transfer

    Initial pending means the request is accepted but not final.

  4. Your website
    Receives the result

    completed finalizes the reserve; failed releases the full reserved amount.

availablecreatedfrozencompleted → debited
failed → released

Operations

This section contains read-only operations. Payment and payout creation is documented under each method above.

PAYMENTS

Payments

Retrieve one operation, a filtered list or an XLSX export.

GET /api/v1/merchant/transactions/{transaction_id}
GET /api/v1/merchant/transactions?page_number=1&items_per_page=50&status=completed
GET /api/v1/merchant/transactions/export?status=completed
PAYOUTS

Payouts

Retrieve one payout by local or external ID, or a list filtered by status.

GET /api/v1/merchant/payouts/{payout_id}
GET /api/v1/merchant/payouts?page_number=1&items_per_page=50
GET /api/v1/merchant/payouts?page_number=1&items_per_page=50&status=pending
PROJECT

Balance and time

Check available and reserved balances or synchronize the signature timestamp.

GET /api/v1/merchant/balance
GET /api/v1/merchant/timestamp