Documentación API

Documentación de Aeris API

Referencia de autenticación, creación de pagos y pagos salientes, webhooks y consulta de estados.

Secciones principales

URL base
https://aeris-psp.net
Formato de datos
application/json

Claves API

La clave principal se crea con el proyecto. En el panel puedes emitir hasta cuatro claves adicionales. Allí también se configuran la URL de notificaciones, las IP/CIDR de servidores y los dominios HTTPS del widget. Ver claves y guardar cambios requiere confirmación por Telegram o una aplicación de autenticación.

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

Autenticación

Cada solicitud se firma con HMAC-SHA256. Envía el timestamp en segundos Unix dentro de la ventana permitida. Serializa JSON de forma compacta, sin espacios. Usa un cuerpo vacío para GET.

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>
Crear un pagoSBP, SberPay y tarjetas bancarias
SBP

Pago con SBP

El cliente escanea un código QR en el ordenador o abre la aplicación bancaria en el móvil.

Cuándo usarloCheckout principal de una tienda en línea cuando importa pagar rápido sin introducir tarjeta.
  1. Tu sitio
    Crea el pago

    El backend firma la solicitud y guarda el ID de la operación.

  2. Aeris
    Devuelve payment_url

    La URL puede abrirse directamente o pasarse a Payment page o Widget.

  3. Cliente
    Elige el banco

    En desktop escanea el QR; en móvil abre la aplicación bancaria.

  4. Tu sitio
    Recibe el estado final

    Entrega el pedido solo tras recibir completed por webhook o status API.

Página de pago Aeris

Desktop
Pedido 10001

Pago del pedido

9000 RUB

Demo Store
Método de pago

El resultado aparecerá en esta página

Mobile
Pedido 10001

Pago del pedido

9000 RUB

Demo Store
Método de pago

El resultado aparecerá en esta página

Crear un pago salienteTarjeta bancaria en RUB y USDT en TRON
Tarjeta bancaria

Pago saliente a tarjeta bancaria

Transferencia de RUB por número de tarjeta. Para crearla se necesitan teléfono y nombre del beneficiario; el estado es el resultado final.

Cuándo usarloReembolsos, recompensas y pagos masivos a particulares en Rusia.
  1. Tu sitio
    Crea el pago saliente

    Envía importe, número único de pedido y datos del beneficiario.

  2. Aeris
    Reserva el importe

    Se reservan pago y comisión. Repetir merchant_order_id no crea un duplicado.

  3. Red de pagos
    Procesa la transferencia

    El pending inicial indica que la solicitud fue aceptada, no finalizada.

  4. Tu sitio
    Recibe el resultado

    completed consume la reserva; failed libera todo el importe reservado.

availablecreaciónfrozencompleted → debitado
failed → liberado

Operaciones

Esta sección contiene operaciones de solo lectura. La creación de pagos y pagos salientes se describe en cada método.

PAYMENTS

Pagos

Consulta una operación, una lista filtrada o una exportación XLSX.

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

Pagos salientes

Consulta un pago saliente por ID local o externo, o una lista filtrada por estado.

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

Saldo y hora

Consulta los saldos disponible y reservado o sincroniza el timestamp de firma.

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