How to test the Checkout

Initially, each licensee is granted access in test mode to safely implement and validate their integration without triggering real transactions or orders.

How Checkout Works (Live & Test Mode)

1. Checkout Start
   Your integration app starts the checkout by sending a request to our Basket API, optionally including "mode": "test" in the payload.

2. Payment Intent Creation
   Our API creates a Stripe Payment Intent (based on the selected mode: test or live) and returns the necessary Stripe data (e.g., client_secret) to your app.

3. Collect Payment Details (in your app)
   Your app takes over the user flow: collect address, select payment method, etc., using the provided client_secret.

4. Status Reporting to Our API
   Upon cancellation or completion, your app should notify our Basket API of the current status via a designated endpoint.

5. Final Payment Processing
   The actual payment capture and any order processing are performed exclusively by our server-side Basket API, triggered by Stripe webhooks.

   Important: The client app cannot trigger a real order by itself.

Going Live

Once your integration has been successfully tested, you can request activation for production use. After our team approves, both test and live modes will be available to you.

Choosing Between Test and Live Mode

After approval, you may specify the mode in each checkout request:

• "mode": "test" → uses Stripe test environment
• "mode": "live" → uses Stripe live environment

If no mode is passed, the default mode configured for your tenant will apply.

→ Using Stripe's API

Test Mode Limitations

• No real charges
  Payments using test cards simulate a transaction but do not process real money.
  → Stripe test cards

• No real order
  Test transactions will not trigger actual orders in the shop system.

• Test cards only
  Only Stripe test cards are allowed during test mode.

• Simulated webhooks
  Stripe webhooks are triggered but contain test events only.
  → Testing Stripe webhooks

Next Steps

1. Implement the Basket and Checkout APIs
2. Run full test flows using Stripe test data
3. Handle status reporting via the Basket API
4. Request production access once integration is complete