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 arionpayQué hace
ArionPay para desarrolladores de Python
Leer más
Las 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
Paso 1
Instala el paquete
Ejecuta pip install arionpay. Solo usa la biblioteca estándar.
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.
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"].
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.
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.