AbacatePay Fastify

Integração oficial da AbacatePay com o Fastify para receber Webhooks de forma simples, segura e totalmente tipada.

O @abacatepay/fastify é um pacote framework-first, projetado para funcionar nativamente com o Fastify, focado em DX, TypeScript first e boas práticas de segurança.

Você pode encontrar a documentação completa de Webhooks aqui.

Instalação

Use com o seu package manager favorito:

bun add @abacatepay/fastify
# ou
pnpm add @abacatepay/fastify
# ou
npm install @abacatepay/fastify

Nenhuma dependência extra é necessária. O pacote já vem pronto para uso com o Fastify.

Uso básico

import fastify from 'fastify';
import { Webhooks } from '@abacatepay/fastify';

const app = fastify();

app.addContentTypeParser(
    '*',
    { parseAs: 'string' },
    (_req, body, done) => {
        done(null, body);
    },
);

app.post(
    '/webhooks/abacatepay',
    Webhooks({
        secret: '...',
        onPayload(payload) {
            console.log('Evento recebido:', payload.event);
        },
    }),
);

Você precisa usar .addContentTypeParser para a rota /webhooks/abacatepay receber o body como string e validar corretamente.

Segurança por padrão

• Verificação automática da assinatura do webhook
• Comparação segura do webhook secret
• Payload validado antes de chegar ao seu handler
• Nenhum acesso direto à API key

Tratamento por evento

Você pode lidar com eventos específicos sem boilerplate:

Webhooks({
    onBillingPaid({ data }) {
        console.log('Cobrança paga:', data.payment.amount);
    },
    onPayoutDone({ data }) {
        console.log('Payout concluído:', data.transaction.id);
    },
    onPayoutFailed({ data }) {
        console.error('Falha no payout:', data.transaction.id);
    },
});

Webhooks({
    secret,
    onPayload({ data, event }) {
        console.log(event, data);
    },
});

Feito com 🥑 pela equipe AbacatePay Open source, de verdade.