name: integrating-payment-gateways description: Patterns for connecting payment providers (Stripe, etc.) with Appwrite. Use for handling secure transactions and updating booking status.

Payment Gateway Integration

When to use this skill

• When implementating actual "checkout" flows.
• When an order status needs to change from "pending" to "paid".

Architecture

1. Client: Redirect user to payment provider (Stripe Checkout).
2. Provider: Sends a Webhook back to your Appwrite Function or Route Handler upon success.
3. Server: Verifies the webhook signature.
4. Database: Updates the booking document in Appwrite.

Rules

• Never Store CC Info: Use tokens/checkouts provided by the gateway.
• Idempotency: Ensure that receiving the same webhook twice doesn't result in double bookings.

Instructions

• Test Mode: Always use "Sandbox" or "Test" keys during development.
• Logs: Keep detailed logs of webhook transactions for debugging.