Deployment

Before you begin

The application is a Next.js app with Bun-based background workers, PostgreSQL, Redis, Alchemy/Chainstack provider routing, and Railway configuration files. A deployed payment pipeline needs the web service and the payment, reconciliation, and webhook workers to share the same database and queue.

Release steps

1. Run migrations and validate the schema.
2. Confirm every worker service is deployed with its required environment variables.
3. Verify the provider webhook signing key and the merchant-webhook encryption configuration.
4. Confirm private Redis networking and database connection ceilings.
5. Run the test suite and bun run build.
6. Exercise checkout creation, detection, webhook delivery, and failure recovery in a controlled environment before opening the release to real merchants.

Related documentation

• Environment variables — every variable referenced above.
• Operational troubleshooting — diagnosing a failed deployment step.
• Production checklist — the integration-level counterpart to this checklist.