Ir al contenido
ArionPay

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 ArionPay
Código fuente en GitHub
Ejemplo

Qué hace

ArionPay para desarrolladores de .NET

ArionPay en NuGet es el cliente oficial de ArionPay para .NET 8 o posterior. Solo necesita el propio .NET (HttpClient y System.Text.Json), guarda los precios como decimal y los importes en cripto como texto, y comprueba las firmas de los webhooks sobre el cuerpo sin procesar.
Leer másCada 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

  1. Paso 1

    Añade el paquete

    Ejecuta dotnet add package ArionPay. No tiene dependencias fuera de .NET.

  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 variables de entorno o en user secrets.

  3. 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.

  4. 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.

  5. 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.

Sí. Pasa Request.Body y el encabezado ArionPay-Signature a VerifyWebhookAsync, y excluye la acción de la validación antiforgery: la llama ArionPay, no un formulario del navegador.

Bibliotecas para desarrolladores