Before you start
- Have an app your assistant can inspect, and decide what customers will buy.
- Get a sandbox API key. Keep it in your server’s environment; do not paste it into a chat.
- Let your assistant read the linked docs. If it cannot open them, use Copy page on each guide and paste the content alongside the prompt.
- Use the Bachs CLI to forward sandbox webhooks to your machine.
AGENTS.md file or installing a skill.
Build with the SDK
For a Node.js or TypeScript server, use the official Bachs SDK. It handles API requests, typed responses, and webhook signature verification. Your app still owns authentication, order state, access, and delivery recovery. The Next.js SaaS starter uses the SDK and includes its tested package while the npm release is being prepared. The current npm 0.0.1 package is a placeholder. Follow the starter’s package instructions instead of installing that version. Connect onboarding, account context, and marketplace splits currently use the documented API because these operations are not yet supported by the SDK.Choose a prompt
Building a marketplace? Its prompt is on the marketplace use case, because Connect is not yet in the SDK.
Accept a one-time payment
What you’ll build: a customer chooses an item, pays on Bachs checkout, and your app fulfils the order after confirming payment. Have ready: what you sell, its price and currency, and the action that completes an order. Products can be created in the dashboard or through the Products API.Prompt
Check the result
- A successful sandbox checkout pays the correct order and fulfils it once.
- Opening the success URL before paying leaves the order unpaid.
- An unsuccessful checkout does not fulfil the order.
- Redelivery cannot repeat fulfilment; failed handling can recover on redelivery.
- An unrelated payment or virtual-account deposit cannot pay the order.
Sell subscriptions
What you’ll build: monthly and yearly plans, access that follows subscription state, and a Manage billing button for the customer portal. Have ready: signed-in users, your plans, and a decision about access during a failed renewal. The current subscription guide supports USD card billing; free trials are in beta.Prompt
Check the result
- A sandbox payment saves the user’s customer ID and subscription, then grants access.
- A redirect alone cannot grant access.
- Duplicate or older events cannot undo a later cancellation.
- Manage billing opens the signed-in user’s own customer portal.
- Scheduled cancellation keeps access for the remaining paid period; immediate cancellation removes it.
- Renewal failure follows your access policy and can recover after a successful retry.
Review before go-live
What you get: a list of problems in your Bachs integration, by file and line and ordered by risk, with what correct code does. The assistant does not change your code. Have ready: an integration you have built, with or without an assistant. Run this before you switch to production keys, and again after large changes.Prompt
Check the result
- Every problem names a file and line you can open.
- Fix the problems, then run the prompt again until it reports none you disagree with.
- A review reads code. It does not prove a payment works. Complete a real sandbox payment, including a failure case, before you go live. See Test payment outcomes.

