> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spacemedia.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Stripe, PayPal, and Airwallex gateways

> Set up Stripe, PayPal, or Airwallex gateways for subscription, pay-per-release, credit, and add-on checkout flows in your organization portal.

# Payments

Payment settings control which checkout flows are available to the organization. The dashboard stores secrets server-side and returns masked secret values in settings payloads.

## Gateway fields

| Gateway   | Public behavior                                                                                                                                                              |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Stripe    | Subscription and pay-per-release checkout routes require active Stripe settings and valid public/secret keys. Secret keys are returned as `<MASKED>` in settings payloads.   |
| PayPal    | Subscription and Pay-Per-Release checkout routes require PayPal client ID and secret. Secret values are masked after save.                                                   |
| Airwallex | Subscription, Pay-Per-Release, credits, add-on, and copyright top-up checkouts depend on Airwallex availability for the organization. API key and webhook secret are masked. |

## Public payment endpoints

The public API exposes checkout creation and verification endpoints for subscriptions, pay-per-release orders, credit orders, add-on purchases, and copyright wallet top-ups. Request bodies must include `cancel_url` and `success_url` where the controller checks for both values.

## Safe examples

Use fake checkout URLs and deterministic payment intent UUIDs in examples. Do not paste live Stripe session IDs, PayPal order IDs, Airwallex intent IDs, webhook secrets, or API keys into the playground.