{"_id":"@abacatepay/express","_rev":"7-88ddb021781775a476cc2b439cf072bf","name":"@abacatepay/express","dist-tags":{"latest":"2.0.3"},"versions":{"1.0.0":{"name":"@abacatepay/express","version":"1.0.0","keywords":["abacatepay","payments","express","api","webhooks"],"license":"Apache-2.0","_id":"@abacatepay/express@1.0.0","maintainers":[{"name":"albuquerquesz","email":"albq.victor@gmail.com"},{"name":"bolodissenouraa","email":"daniel@abacatepay.com"},{"name":"escoteiros","email":"accounts@eualmeida.com.br"}],"homepage":"https://github.com/almeidazs/ecosystem#readme","bugs":{"url":"https://github.com/almeidazs/ecosystem/issues"},"dist":{"shasum":"68e4b57046bd73ca1ffb5f9ecd17fae356b387f9","tarball":"https://registry.npmjs.org/@abacatepay/express/-/express-1.0.0.tgz","fileCount":12,"integrity":"sha512-z96vcM/xYwZFJxDI1Vh/l37XTuNzbKPErxTruhxlds5CUhHVhawqoMMfxO9xH+2QyKTungxjPqU0BEvLFHl6Ng==","signatures":[{"sig":"MEYCIQCEjkKAaKS0dWdgas8kDvoHo1IwhvC2GZZqIiWp+N3aEwIhAMvZOm8uFLPL2aDkxacsnxRlkgiW/3Mqy6IOK8iis8FR","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9188},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"bun":">=1.0.0","node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"00caa3681c26546f150857d69d4e88f55ec44b4f","scripts":{"test":"bun test","build":"rm -rf dist && bun run scripts/version.ts && tsc","types":"bunx tsc --emitDeclarationOnly","prepublishOnly":"bun run build"},"_npmUser":{"name":"escoteiros","email":"accounts@eualmeida.com.br"},"repository":{"url":"git+https://github.com/almeidazs/ecosystem.git","type":"git"},"_npmVersion":"11.6.2","description":"Checkouts and Webhooks made simple with AbacatePay and Express.","directories":{},"sideEffects":false,"_nodeVersion":"24.12.0","dependencies":{"@abacatepay/zod":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@biomejs/biome":"^2.3.11"},"peerDependencies":{"express":"^5.2.1","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/express_1.0.0_1769268635363_0.9552990443417806","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@abacatepay/express","version":"1.0.1","keywords":["abacatepay","payments","express","api","webhooks"],"license":"Apache-2.0","_id":"@abacatepay/express@1.0.1","maintainers":[{"name":"albuquerquesz","email":"albq.victor@gmail.com"},{"name":"bolodissenouraa","email":"daniel@abacatepay.com"},{"name":"escoteiros","email":"accounts@eualmeida.com.br"}],"homepage":"https://github.com/almeidazs/ecosystem#readme","bugs":{"url":"https://github.com/almeidazs/ecosystem/issues"},"dist":{"shasum":"df9bb9ad7b75fcf9da702492a739e44955843c54","tarball":"https://registry.npmjs.org/@abacatepay/express/-/express-1.0.1.tgz","fileCount":8,"integrity":"sha512-wsO3lGv5YoqzvhFAKaC02W2brZv0ZtrP26JiZsu+D3iE6XCRbBkRGL+PBrgETD3BEZHelWbTLLYMTO/rCh4Qxw==","signatures":[{"sig":"MEUCIQDtv+RZbiFbYdB6LvVBjMUNxyYflkh7wB3+vrT3oJEd+QIgSolXGLQfksmODxUKrqS8WesOVmgj1bXY1FqGaCAE5D4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6986},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"bun":">=1.0.0","node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"fce0da7b8dec48e08f7be9c082b5d90a104b1b97","scripts":{"test":"bun test","build":"rm -rf dist && bun run scripts/version.ts && tsc","types":"bunx tsc --emitDeclarationOnly","prepublishOnly":"bun run build"},"_npmUser":{"name":"escoteiros","email":"accounts@eualmeida.com.br"},"repository":{"url":"git+https://github.com/almeidazs/ecosystem.git","type":"git"},"_npmVersion":"11.6.2","description":"Checkouts and Webhooks made simple with AbacatePay and Express.","directories":{},"sideEffects":false,"_nodeVersion":"24.12.0","dependencies":{"@abacatepay/adapters":"^1.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@biomejs/biome":"^2.3.11"},"peerDependencies":{"express":"^5.2.1","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/express_1.0.1_1769355606393_0.8097757154699108","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@abacatepay/express","version":"1.0.2","keywords":["abacatepay","payments","express","api","webhooks"],"author":{"url":"https://abacatepay.com","name":"AbacatePay","email":"opensource@abacatepay.com"},"license":"Apache-2.0","_id":"@abacatepay/express@1.0.2","maintainers":[{"name":"albuquerquesz","email":"albq.victor@gmail.com"},{"name":"bolodissenouraa","email":"daniel@abacatepay.com"},{"name":"escoteiros","email":"accounts@eualmeida.com.br"}],"homepage":"https://github.com/AbacatePay/ecosystem#readme","bugs":{"url":"https://github.com/AbacatePay/ecosystem/issues"},"dist":{"shasum":"b79e3e494ec35912b955d90142e4bb37971288d1","tarball":"https://registry.npmjs.org/@abacatepay/express/-/express-1.0.2.tgz","fileCount":8,"integrity":"sha512-yLMv96wQ/ZinKnsm9uKI2LgyJpeqTraPckjB7V13i7BPBPcAeZVylfMY/5Zu6Abk8gvu1eeCf6fxM3j+mcW0Hw==","signatures":[{"sig":"MEUCIQDeNPXYWeF9aRVHAKcM52K615+waIyFPXQbyEw9EQqQ/wIgS+hVSQTWZk4iSbAsOItnlFEPD6/rHzj2X2YszIo2Nx0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7203},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"bun":">=1.0.0","node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"4af5fea8c40caa1a1add9b42cb194bc29333ddb0","scripts":{"test":"bun test","build":"rm -rf dist && bun run scripts/version.ts && tsc","types":"bunx tsc --emitDeclarationOnly","prepublishOnly":"bun run build"},"_npmUser":{"name":"escoteiros","email":"accounts@eualmeida.com.br"},"repository":{"url":"git+https://github.com/AbacatePay/ecosystem.git","type":"git"},"_npmVersion":"11.6.2","description":"Checkouts and Webhooks made simple with AbacatePay and Express.","directories":{},"sideEffects":false,"_nodeVersion":"24.12.0","dependencies":{"@abacatepay/adapters":"^1.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@biomejs/biome":"^2.3.11"},"peerDependencies":{"express":"^5.2.1","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/express_1.0.2_1769436923816_0.13503508305342526","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@abacatepay/express","version":"2.0.0","keywords":["abacatepay","payments","express","api","webhooks"],"author":{"url":"https://abacatepay.com","name":"AbacatePay","email":"opensource@abacatepay.com"},"license":"Apache-2.0","_id":"@abacatepay/express@2.0.0","maintainers":[{"name":"albuquerquesz","email":"albq.victor@gmail.com"},{"name":"bolodissenouraa","email":"daniel@abacatepay.com"},{"name":"escoteiros","email":"ajuda@abacatepay.com"}],"homepage":"https://github.com/AbacatePay/ecosystem#readme","bugs":{"url":"https://github.com/AbacatePay/ecosystem/issues"},"dist":{"shasum":"338a73c5389adfda11e062912c493a49d14a9c5f","tarball":"https://registry.npmjs.org/@abacatepay/express/-/express-2.0.0.tgz","fileCount":6,"integrity":"sha512-v6pymgpTR/Z4rlAyo0t2HvxTPlP5y8RISQPyVMJ+cVqa9NNJtYPyVk2oEyJg+VDm8A43nYCeDsTXzmtIJadxsQ==","signatures":[{"sig":"MEQCIAmj3fEAGQ1/Es2CAFWLvpN79G0unUpUEZTwzBdRneIFAiAe++V+CyCzyE+VFYwCXrGmNr1i+LgRsi6FyMX5AtoJhw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6863},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"bun":">=1.0.0","node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"2dc44ef4789adc69e81f94a8e459cc85fd76668c","scripts":{"test":"bun test","build":"rm -rf dist && bun run scripts/version.ts && tsc","types":"bunx tsc --emitDeclarationOnly","prepublishOnly":"bun run build"},"_npmUser":{"name":"escoteiros","email":"ajuda@abacatepay.com"},"repository":{"url":"git+https://github.com/AbacatePay/ecosystem.git","type":"git"},"_npmVersion":"11.8.0","description":"Checkouts and Webhooks made simple with AbacatePay and Express.","directories":{},"sideEffects":false,"_nodeVersion":"24.13.1","dependencies":{"@abacatepay/adapters":"^2.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@biomejs/biome":"^2.3.11"},"peerDependencies":{"express":"^5.2.1","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/express_2.0.0_1785159305815_0.8737625349404181","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@abacatepay/express","version":"2.0.1","keywords":["abacatepay","payments","express","api","webhooks"],"author":{"url":"https://abacatepay.com","name":"AbacatePay","email":"opensource@abacatepay.com"},"license":"Apache-2.0","_id":"@abacatepay/express@2.0.1","maintainers":[{"name":"albuquerquesz","email":"albq.victor@gmail.com"},{"name":"bolodissenouraa","email":"daniel@abacatepay.com"},{"name":"escoteiros","email":"ajuda@abacatepay.com"}],"homepage":"https://github.com/AbacatePay/ecosystem#readme","bugs":{"url":"https://github.com/AbacatePay/ecosystem/issues"},"dist":{"shasum":"451a0fd7c2973d9b6ca9f64747a012b5533a6825","tarball":"https://registry.npmjs.org/@abacatepay/express/-/express-2.0.1.tgz","fileCount":5,"integrity":"sha512-8kPF/PnrxMP/AkKgTvtdQGnLli0YvzD+qunLVLbSCjlk7u8uvUXf2DYqXAe8ySeuP7WD99gsUGgi8Uy4zk68eA==","signatures":[{"sig":"MEUCIC9/ep/vAvQ1sqJ9TioIf5sIK9joAsINM6B1SYFIzH+hAiEA7FpJAY/xPG+/Oh7H61oeFYKLhWFfSCDkZPV/f3yGCcU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":485680},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"bun":">=1.0.0","node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"ff4bbae0210c3eb16826c4f3f3f8d9c1953031ad","scripts":{"test":"bun test","build":"rm -rf dist && bun run scripts/version.ts && bun build src/index.ts --outdir dist --target node && bun run types","types":"bunx tsc --emitDeclarationOnly","prepublishOnly":"bun run build"},"_npmUser":{"name":"escoteiros","email":"ajuda@abacatepay.com"},"repository":{"url":"git+https://github.com/AbacatePay/ecosystem.git","type":"git"},"_npmVersion":"11.8.0","description":"Checkouts and Webhooks made simple with AbacatePay and Express.","directories":{},"sideEffects":false,"_nodeVersion":"24.13.1","dependencies":{"@abacatepay/adapters":"^2.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@biomejs/biome":"^2.3.11"},"peerDependencies":{"express":"^5.2.1","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/express_2.0.1_1785173897448_0.07936789527900201","host":"s3://npm-registry-packages-npm-production"}},"2.0.2":{"name":"@abacatepay/express","version":"2.0.2","keywords":["abacatepay","payments","express","api","webhooks"],"author":{"url":"https://abacatepay.com","name":"AbacatePay","email":"opensource@abacatepay.com"},"license":"Apache-2.0","_id":"@abacatepay/express@2.0.2","maintainers":[{"name":"albuquerquesz","email":"albq.victor@gmail.com"},{"name":"bolodissenouraa","email":"daniel@abacatepay.com"},{"name":"escoteiros","email":"ajuda@abacatepay.com"}],"homepage":"https://github.com/AbacatePay/ecosystem#readme","bugs":{"url":"https://github.com/AbacatePay/ecosystem/issues"},"dist":{"shasum":"88813ad435b05a57dc4e24eddd0cffb9c081f00c","tarball":"https://registry.npmjs.org/@abacatepay/express/-/express-2.0.2.tgz","fileCount":6,"integrity":"sha512-4qUuEu+m7Mf/9VOlvfNKEdXzngoZ+8NfxBllU0K1mliZB/CaEwuxhEqjhB8sQYxPGFv0IFAr9mGMjOrzS2pTow==","signatures":[{"sig":"MEUCICwpQzs6TcSP0TUypC5CEM464cn61Eq35uMrkDEeFClJAiEAugHiGpJMwMRABI+dufWuHUyY8epN1kD2Sv5G8TZmJYI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7784},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"bun":">=1.0.0","node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"4f44b0102e118ca7fd4abd4da8c094cf8f22360c","scripts":{"test":"bun test","build":"rm -rf dist && bun run scripts/version.ts && bun build src/index.ts --outdir dist --target node --external '@abacatepay/adapters' --external '@abacatepay/adapters/*' && bun run types","types":"bunx tsc --emitDeclarationOnly","prepublishOnly":"bun run build"},"_npmUser":{"name":"escoteiros","email":"ajuda@abacatepay.com"},"repository":{"url":"git+https://github.com/AbacatePay/ecosystem.git","type":"git"},"_npmVersion":"11.8.0","description":"Checkouts and Webhooks made simple with AbacatePay and Express.","directories":{},"sideEffects":false,"_nodeVersion":"24.13.1","dependencies":{"@abacatepay/adapters":"^2.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@biomejs/biome":"^2.3.11"},"peerDependencies":{"express":"^5.2.1","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/express_2.0.2_1785181676460_0.6474901123413446","host":"s3://npm-registry-packages-npm-production"}},"2.0.3":{"name":"@abacatepay/express","version":"2.0.3","repository":{"type":"git","url":"git+https://github.com/AbacatePay/ecosystem.git"},"main":"./dist/index.js","devDependencies":{"@biomejs/biome":"^2.3.11","typescript":"^5.0.0"},"peerDependencies":{"@types/express":"^5.0.6","express":"^5.2.1"},"author":{"name":"AbacatePay","email":"opensource@abacatepay.com","url":"https://abacatepay.com"},"maintainers":[{"name":"albuquerquesz","email":"albq.victor@gmail.com"},{"name":"bolodissenouraa","email":"daniel@abacatepay.com"},{"name":"escoteiros","email":"ajuda@abacatepay.com"}],"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"description":"Checkouts and Webhooks made simple with AbacatePay and Express.","engines":{"node":">=18","bun":">=1.0.0"},"keywords":["abacatepay","payments","express","api","webhooks"],"license":"Apache-2.0","publishConfig":{"access":"public"},"scripts":{"test":"bun test","build":"rm -rf dist && bun run scripts/version.ts && bun build src/index.ts --outdir dist --target node --external '@abacatepay/adapters' --external '@abacatepay/adapters/*' && bun run types","types":"bunx tsc --emitDeclarationOnly","prepublishOnly":"bun run build"},"sideEffects":false,"type":"module","types":"./dist/index.d.ts","dependencies":{"@abacatepay/adapters":"^2.0.0"},"gitHead":"5c10083ce1c3dfce4b35af061f28b10bec33ff32","_id":"@abacatepay/express@2.0.3","bugs":{"url":"https://github.com/AbacatePay/ecosystem/issues"},"homepage":"https://github.com/AbacatePay/ecosystem#readme","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-pHL+DsXwHUKeTIJKbtc3Hu3yIFMyub4x7l9Ji8LUFF/hfSC2mp+q5quqaDFnzcWBPzwMgqxGp/Qgpo+xxZTnKg==","shasum":"ab71004d7cdb50c09088b45f524edfb5b080ac92","tarball":"https://registry.npmjs.org/@abacatepay/express/-/express-2.0.3.tgz","fileCount":6,"unpackedSize":8097,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCOYTcujCkFG+gLarWi8gssYCWKLGXIK/VZzppS5D4CMAIhAItwqrvjmb6WHAc3gjNtdH0h0SDIn0Z2PrnTSPiqUMo5"}]},"_npmUser":{"name":"escoteiros","email":"ajuda@abacatepay.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/express_2.0.3_1785184807713_0.046502425780377"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-24T15:30:35.247Z","modified":"2026-07-27T20:40:08.083Z","1.0.0":"2026-01-24T15:30:35.530Z","1.0.1":"2026-01-25T15:40:06.538Z","1.0.2":"2026-01-26T14:15:23.958Z","2.0.0":"2026-07-27T13:35:05.964Z","2.0.1":"2026-07-27T17:38:17.607Z","2.0.2":"2026-07-27T19:47:56.617Z","2.0.3":"2026-07-27T20:40:07.858Z"},"bugs":{"url":"https://github.com/AbacatePay/ecosystem/issues"},"author":{"name":"AbacatePay","email":"opensource@abacatepay.com","url":"https://abacatepay.com"},"license":"Apache-2.0","homepage":"https://github.com/AbacatePay/ecosystem#readme","keywords":["abacatepay","payments","express","api","webhooks"],"repository":{"type":"git","url":"git+https://github.com/AbacatePay/ecosystem.git"},"description":"Checkouts and Webhooks made simple with AbacatePay and Express.","maintainers":[{"name":"albuquerquesz","email":"albq.victor@gmail.com"},{"name":"bolodissenouraa","email":"daniel@abacatepay.com"},{"name":"escoteiros","email":"ajuda@abacatepay.com"}],"readme":"
\n\n# AbacatePay Express\n\nIntegração oficial da **AbacatePay** com o **Express** para receber **Webhooks** de forma simples, segura e totalmente tipada.\n\nO [`@abacatepay/express`](https://www.npmjs.com/package/@abacatepay/express) é um pacote **framework-first**, projetado para funcionar nativamente com o Express, focado em **DX**, **TypeScript first** e **boas práticas de segurança**.\n\n\"AbacatePay\n\nVocê pode encontrar a documentação completa de Webhooks [aqui](https://docs.abacatepay.com/pages/webhooks).\n\n## Instalação\n\nUse com o seu *package manager* favorito:\n\n
\n\n```bash\nbun add @abacatepay/express\n# ou\npnpm add @abacatepay/express\n# ou\nnpm install @abacatepay/express\n```\n\n
\n\nNenhuma dependência extra é necessária. O pacote já vem pronto para uso com o Express.\n\n## Uso básico\n\n
\n\n```ts\nimport express from 'express';\nimport { Webhooks } from '@abacatepay/express';\n\nconst app = express();\n\nconst { ok, handler, error } = Webhooks({\n secret: '...',\n onPayload(payload) {\n console.log('Evento recebido:', payload.event);\n },\n});\n\nif (!ok) throw new Error(error);\n\napp.post('/webhooks/abacatepay', express.raw({ type: '*/*' }), handler);\n```\n\n
\n\n`Webhooks(...)` nunca lança exceção — se o `secret` estiver ausente, ela retorna `{ ok: false, error }` em vez de `{ ok: true, handler }`.\n\n
\n\n
\n\n## Segurança por padrão\n
\n\n- Verificação automática da assinatura do webhook\n- Comparação segura do webhook secret\n- Payload validado antes de chegar ao seu handler\n- Nenhum acesso direto à API key\n\n

Nunca exponha sua API key em webhooks.
\nSempre utilize variáveis de ambiente.

\n\n
\n\n## Tratamento por evento\n\nVocê pode lidar com eventos específicos sem boilerplate:\n\n
\n\n```ts\nconst { handler } = Webhooks({\n secret,\n onCheckoutCompleted({ data }) {\n console.log('Cobrança paga:', data.payment.amount);\n },\n onPayoutCompleted({ data }) {\n console.log('Payout concluído:', data.transaction.id);\n },\n onPayoutFailed({ data }) {\n console.error('Falha no payout:', data.transaction.id);\n },\n});\n```\n\n\n

Ou tratar tudo de forma genérica:

\n\n```ts\nconst { handler } = Webhooks({\n secret,\n onPayload({ data, event }) {\n console.log(event, data);\n },\n});\n```\n\n
\n\nFeito com 🥑 pela equipe AbacatePay
\nOpen source, de verdade.\n\n
\n","readmeFilename":"README.md"}