@adonis-agora/payments 0.18.0 → 0.19.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @adonis-agora/payments
 
+## 0.19.1
+
+### Patch Changes
+
+- [#146](https://github.com/DavideCarvalho/adonis-agora-payments/pull/146) [`c071147`](https://github.com/DavideCarvalho/adonis-agora-payments/commit/c071147d5e455ad3514055db5fb1c19c4279f79a) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Ship a README. The package listed `README.md` in `files` but had none, so its npm page was empty.
+
+## 0.19.0
+
+### Minor Changes
+
+- [#144](https://github.com/DavideCarvalho/adonis-agora-payments/pull/144) [`876b94a`](https://github.com/DavideCarvalho/adonis-agora-payments/commit/876b94a62c9e29d5f1bee733174e654de1bd3f1e) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Support stripe-node 23. Its default API version (`2026-09-30.endive`) removed `payment_method_types` from PaymentIntent creation in favour of `allowed_payment_method_types`, and the Stripe driver used the old field to hold a charge to its method (Pix stays Pix): on stripe 23 every charge that named a method would have sent a parameter the API no longer takes. The driver now reads `Stripe.API_VERSION` from the SDK the app installed and sends `allowed_payment_method_types` from 2026-09-30 on, `payment_method_types` before it, so stripe 17 through 23 all work. The `stripe` peer range now includes `^23.0.0`.
+
 ## 0.18.0
 
 ### Minor Changes

package/README.md

@@ -0,0 +1,67 @@
+# `@adonis-agora/payments`
+
+[![npm version](https://img.shields.io/npm/v/@adonis-agora/payments)](https://www.npmjs.com/package/@adonis-agora/payments) [![npm downloads](https://img.shields.io/npm/dm/@adonis-agora/payments)](https://www.npmjs.com/package/@adonis-agora/payments) [![CI](https://github.com/DavideCarvalho/adonis-agora-payments/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/DavideCarvalho/adonis-agora-payments/actions/workflows/ci.yml) [![license](https://img.shields.io/npm/l/@adonis-agora/payments)](https://www.npmjs.com/package/@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](https://davidecarvalho.github.io/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
+
+```sh
+node ace add @adonis-agora/payments
+```
+
+## Use
+
+Configure gateways in `config/payments.ts` and route each payment method to one:
+
+```ts
+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:
+
+```ts
+import { getPayments } from '@adonis-agora/payments/services/main'
+
+const payments = getPayments()
+
+const customer = await payments.driver('pix').createCustomer({
+  name: 'Jane Doe',
+  email: 'jane@example.com',
+  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**
+
+## License
+
+MIT