Ir al contenido
ArionPay

Biblioteca para Python

Acepta pagos en cripto en tu app de Python

Crea facturas en cripto desde Flask, Django, FastAPI o un simple script, y verifica el webhook firmado cuando el cliente pague. El dinero va directo a tu propia billetera.

Instalar

pip install arionpay
Código fuente en GitHub
Ejemplo

Qué hace

ArionPay para desarrolladores de Python

arionpay es el cliente oficial de ArionPay para Python 3.8 o posterior, escrito solo con la biblioteca estándar. Crea y lee facturas, comprueba las firmas de los webhooks sobre el cuerpo sin procesar y hace pasar las facturas de prueba por distintos escenarios de pago.
Leer másLas facturas se devuelven como dicts con los mismos nombres de campo que el webhook, así que una sola función puede procesar un webhook y una lectura. ArionPay nunca custodia el dinero: va directo a tu propia billetera.
  • Sin dependencias (solo la biblioteca estándar). Python 3.8 o posterior.
  • Ejemplos en el README para Flask, Django y FastAPI. Los scripts simples también funcionan.
  • Cada solicitud de factura lleva una clave de idempotencia, así que un error de red nunca puede crear dos facturas.
  • Firma cada solicitud de factura con HMAC-SHA256 y tu secreto de API. El secreto en sí nunca se envía.
  • verify_webhook comprueba el encabezado ArionPay-Signature sobre el cuerpo sin procesar y lanza SignatureError cuando no coincide o tiene más de 5 minutos.
  • simulate_payment lleva una factura de prueba por escenarios como exact, partial_half, overpaid o late. send_test_webhook envía un evento de ejemplo firmado.
  • Incluye anotaciones de tipo (py.typed).

Requisitos y licencia

Funciona con
Python 3.8 o posterior · Flask, Django, FastAPI o scripts simples · solo la biblioteca estándar
Precio
La biblioteca es gratuita. ArionPay cobra un 0.5% por pago, sin cuota mensual.
Código fuente
Código abierto (MIT) en GitHub.

Configuración

Configúralo en 5 pasos

  1. Paso 1

    Instala el paquete

    Ejecuta pip install arionpay. Solo usa la biblioteca estándar.

  2. Paso 2

    Copia tus claves

    En tu panel de ArionPay, abre tu tienda y copia la clave de API (pk_) y el secreto de API (sk_; te pide tu código de autenticación). El secreto de firma del webhook (whsec_) está en la página Webhooks. Guárdalos en tu servidor, por ejemplo en variables de entorno.

  3. Paso 3

    Crear una factura

    Llama a create_invoice con el importe, la moneda y tu order_id, y luego envía al cliente a invoice["invoiceUrl"].

  4. Paso 4

    Verifica el webhook

    Configura la dirección de tu webhook en la página Webhooks, o por factura con callback_url. Pasa el cuerpo sin procesar y el encabezado ArionPay-Signature a verify_webhook, y entrega el pedido con invoice.paid.

  5. Paso 5

    Prueba sin dinero real

    Crea una factura con test=True y un asset como USDT_TRC20, y luego llama a simulate_payment(invoice["id"], "exact"). Tu webhook recibe invoice.paid, como con un pago real.

Después de la configuración

Cómo llega un pago a tu código

  • invoice.pending: se detectó un pago en la red y espera confirmaciones. No entregues todavía.
  • invoice.paid: pagada por completo y confirmada, o aceptada por ti a mano en el panel. Entrega solo con este evento (o cuando get_invoice indique paid). Volver a success_url no demuestra el pago.
  • Antes de entregar, comprueba que la factura corresponde a tu pedido: tu order_id o metadata, y el mismo importe y la misma moneda que el total actual del pedido.
  • invoice.partial, invoice.expired e invoice.needs_review nunca significan que debas entregar. Un pago tardío todavía puede dejar pagada una factura vencida.
  • ArionPay vuelve a enviar durante unos 3 días cuando tu servidor no responde 2xx. Procesa cada event["id"] una sola vez.

16 monedas y tokens en 9 redes

Todas las monedas
  • BTCBitcoin
  • ETHEthereum
  • USDTEthereum
  • USDCEthereum
  • BNBBNB Smart Chain
  • USDTBNB Smart Chain
  • USDCBNB Smart Chain
  • POLPolygon
  • USDTPolygon
  • USDCPolygon
  • TRXTRON
  • USDTTRON
  • LTCLitecoin
  • DOGEDogecoin
  • BCHBitcoin Cash
  • DASHDash

Preguntas sobre la biblioteca de ArionPay para Python

Respuestas breves antes de empezar a programar.

Sí. Marca la vista con @csrf_exempt y @require_POST, y luego pasa request.body y el encabezado ArionPay-Signature a verify_webhook.

Bibliotecas para desarrolladores