@adonis-agora/payments

Payments and billing for AdonisJS — 18 gateways behind one driver contract, a Cashier-style subscription layer, idempotent webhook processing and invoice emission. Part of the Agora ecosystem.

Gateways: Asaas, AbacatePay, Woovi, Pagar.me, PagBank, Efí, InfinitePay, Mercado Pago · Stripe, Adyen, PayPal, Mollie, Razorpay, Square · Paddle, Lemon Squeezy, Polar, Dodo Payments.

Install

node ace add @adonis-agora/payments

Use

Configure gateways in config/payments.ts and route each payment method to one:

import env from '#start/env'
import { defineConfig, payments } from '@adonis-agora/payments'

export default defineConfig({
  default: 'asaas',
  providers: {
    asaas: payments.asaas({
      apiKey: env.get('PAYMENTS_ASAAS_KEY'),
      webhookToken: env.get('PAYMENTS_ASAAS_WEBHOOK_TOKEN'),
    }),
  },
  methods: { pix: 'asaas', credit_card: 'asaas' },
})

Then charge through the routed driver:

import { getPayments } from '@adonis-agora/payments/services/main'

const payments = getPayments()

const customer = await payments.driver('pix').createCustomer({
  name: 'Jane Doe',
  email: '[email protected]',
  taxId: '123.456.789-00',
})

const payment = await payments.driver('pix').charge({
  customerId: customer.id,
  amount: 1990, // integer cents: R$ 19,90
  externalReference: order.id, // your own row; comes back on every webhook for this charge
})

// payment.pixCode → the copy-paste BR code to show the customer

Documentation

Gateways, webhooks, subscriptions and billing, invoices, testing and production notes: https://davidecarvalho.github.io/agora/docs/payments

Sponsors

Every Agora library is MIT and stays free. The work is funded by partners and sponsors — become one.

License

MIT