Ir al contenido
ArionPay

Módulo para Go

Acepta pagos en cripto en tu app de Go

Crea facturas en cripto desde tu servicio en Go y verifica webhooks firmados solo con la biblioteca estándar. El dinero va directo a tu propia billetera.

Instalar

go get github.com/ArionPay-Dev/arionpay-go
Código fuente en GitHub
Ejemplo

Qué hace

ArionPay para desarrolladores de Go

arionpay-go es el cliente oficial de ArionPay para Go 1.21 o posterior, sin dependencias fuera de la biblioteca estándar. Crea y lee facturas, comprueba las firmas de los webhooks sobre el cuerpo sin procesar y acepta un context.Context en cada llamada.
Leer másUna factura de webhook y un resultado de GetInvoice son el mismo tipo arionpay.Invoice, así que una sola función puede manejar ambos. ArionPay nunca custodia el dinero: va directamente a tu propia billetera.
  • Sin dependencias (solo la biblioteca estándar). Go 1.21 o posterior.
  • Cada llamada acepta un context.Context. Un contexto cancelado también detiene las esperas entre reintentos.
  • Cada solicitud de factura lleva una clave de idempotencia, así que un error de red nunca puede crear dos facturas.
  • VerifyWebhook comprueba la firma sobre el cuerpo sin procesar y devuelve un *SignatureError cuando no coincide o tiene más de 5 minutos.
  • Los importes son arionpay.Amount: el texto exactamente como lo envió ArionPay, nunca redondeado. inv.Matches("49.90", "USD") compara el total del pedido al centavo.
  • Un Client se puede compartir de forma segura entre goroutines. El cliente HTTP predeterminado tiene un timeout de 20 s y no sigue redirecciones.
  • SimulatePayment y SendTestWebhook te permiten probar sin dinero real.

Requisitos y licencia

Funciona con
Go 1.21 o posterior · net/http, Gin, Echo, Chi, Fiber · 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

    Añade el módulo

    Ejecuta go get github.com/ArionPay-Dev/arionpay-go e impórtalo como arionpay "github.com/ArionPay-Dev/arionpay-go".

  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. Pásalos a arionpay.New en un Config.

  3. Paso 3

    Crear una factura

    Llama a client.CreateInvoice(ctx, arionpay.InvoiceParams{...}) con Amount, Currency y OrderID, y luego redirige a inv.InvoiceURL.

  4. Paso 4

    Verifica el webhook

    Configura la dirección de tu webhook en la página Webhooks, o por factura con CallbackURL. Lee el cuerpo sin procesar, pásalo a client.VerifyWebhook con el encabezado ArionPay-Signature y entrega con invoice.paid.

  5. Paso 5

    Prueba sin dinero real

    Crea una factura con Test: arionpay.Bool(true) y un Asset como USDT_TRC20, y luego llama a client.SimulatePayment(ctx, 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 GetInvoice devuelva Status "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 Go

Respuestas breves antes de empezar a programar.

Sí. Lee el cuerpo sin procesar con c.GetRawData() en Gin o io.ReadAll(c.Request().Body) en Echo, y pásalo a VerifyWebhook. No vincules antes el cuerpo a un struct.

Bibliotecas para desarrolladores