Test an integration locally

Test layers

• Unit-test request serialization and error mapping.
• Mock POST /api/v1/checkouts and assert a stable idempotency key is sent.
• Test a simulated timeout followed by an identical retry, and confirm the response is replayed rather than duplicated.
• Test a signature mismatch, a stale timestamp, and a duplicate delivery ID.
• Test the full checkout.paid payload against a disposable order database.
• Run migration and test commands only against a disposable PostgreSQL instance — never a shared or production database.

bun run db:migrate
bun run test
bun run build

The application repository also documents a local Redis workflow and a port-3001 browser smoke test. A public tunnel is needed to exercise the real provider-webhook path locally; there is no turnkey tunnel command in the verified source — see testing.

Related documentation

• Testing — the broader test-environment reference.
• Production checklist — what to confirm once these tests pass.