Biblioteca para .NET
Acepta pagos en cripto en tu app de .NET
Crea facturas en cripto desde ASP.NET Core y verifica webhooks firmados, con async de principio a fin. El dinero va directo a tu propia billetera.
Instalar
dotnet add package ArionPayQué hace
ArionPay para desarrolladores de .NET
Leer más
Cada llamada es asíncrona y acepta un CancellationToken. ArionPay nunca custodia el dinero: va directamente a tu propia billetera.- Sin dependencias: solo el propio .NET (HttpClient, System.Text.Json). .NET 8 o posterior (8, 9, 10).
- Async de principio a fin, con un CancellationToken en cada llamada.
- Cada solicitud de factura lleva una clave de idempotencia, así que un error de red nunca puede crear dos facturas.
- VerifyWebhookAsync lee el cuerpo de la solicitud, comprueba la firma y lanza ArionPaySignatureException cuando no coincide o tiene más de 5 minutos.
- Importes exactos: los precios son decimal y los importes en cripto se guardan como texto. inv.Matches(49.90m, "USD") compara el total del pedido al centavo.
- Thread-safe: registra el cliente una sola vez como singleton. Puedes pasar tu propio HttpClient, por ejemplo desde IHttpClientFactory.
- SimulatePaymentAsync y SendTestWebhookAsync te permiten probar sin dinero real.
Requisitos y licencia
- Funciona con
- .NET 8 o posterior · minimal APIs y controladores de ASP.NET Core, worker services, apps de consola
- 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
Añade el paquete
Ejecuta dotnet add package ArionPay. No tiene dependencias fuera de .NET.
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 variables de entorno o en user secrets.
Paso 3
Registra el cliente y crea una factura
Registra un ArionPayClient como singleton. Llama a CreateInvoiceAsync con un InvoiceRequest (Amount, Currency, OrderId) y luego redirige a invoice.InvoiceUrl.
Paso 4
Verifica el webhook
Configura la dirección de tu webhook en la página Webhooks, o por factura con CallbackUrl. Pasa request.Body y el encabezado ArionPay-Signature a VerifyWebhookAsync, y entrega 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 SimulatePaymentAsync(inv.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 GetInvoiceAsync indique paid). Volver a SuccessUrl no demuestra el pago.
- Antes de entregar, comprueba que la factura corresponde a tu pedido: tu OrderId o Metadata, e inv.Matches(order.Total, order.Currency).
- 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 ev.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 .NET
Respuestas breves antes de empezar a programar.