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-goQué hace
ArionPay para desarrolladores de Go
Leer más
Una 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
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".
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.
Paso 3
Crear una factura
Llama a client.CreateInvoice(ctx, arionpay.InvoiceParams{...}) con Amount, Currency y OrderID, y luego redirige a inv.InvoiceURL.
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.
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.