Payment Options
Settings > Brand Settings > Payment Options connects your own payment accounts. Money from your customers goes to your gateway, under your merchant account, in your currency.
You can activate more than one gateway. Each has two switches: one for one-time payments and one for recurring memberships.
The three gateways
| Gateway | You provide | Where to get it |
|---|---|---|
| Stripe | Publishable key and secret key | Stripe Dashboard > API Keys |
| PayPal | Client ID and secret | PayPal Developer Dashboard > Apps and Credentials |
| Airwallex | Client ID, API key, and webhook secret | Airwallex > Create API Key, then Create Webhook |
Credentials are stored server-side and masked after saving. To keep an existing secret when re-saving, leave the field empty.
Connecting a gateway
Open Settings > Brand Settings > Payment Options and find the gateway card.
Select Configure Credentials and paste in the values from your gateway account. Use the environment you actually intend to charge in.
Switch Activate gateway on. That enables one-time card payments through it.
Switch Subscriptions on if this gateway should also handle recurring membership checkouts. Activating a gateway turns this on by default, so switch it off if you do not want recurring charges on that gateway.
Save, then confirm the secret fields are now masked.
Run one small real transaction end to end and check it appears in your gateway dashboard.
Airwallex setup
Airwallex needs two extra things.
Scopes. Enable all of these on the API key, or checkouts will fail in ways that are hard to diagnose:
- Payment Acceptance: Read, Write
- Billing Customers: Read, Write
- Payment Sources: Read, Write
- Subscriptions: Read, Write
- Prices: Read, Write
- Products: Read, Write
- Billing Transactions: Read
- Invoices: Read
- Payment Disputes: Read
Webhook. The Payment Options page shows the exact webhook URL to register in Airwallex. Copy it, create the webhook in the Airwallex web app, then paste the resulting webhook secret back into the dashboard.
What you sell
Payment Options is the plumbing. The products are defined in Settings > Upgrades.
| Product | What it is |
|---|---|
| Memberships | Recurring plans with their own price, billing cycle, royalty share, and limits on releases and artist profiles. Draft plans stay hidden, published plans appear to your customers, and archived plans leave the storefront while keeping existing subscribers intact. |
| Pay per release | A price charged each time a customer submits a release, set per release type, with optional per-type discounts. |
Add at least one pay-per-release option before switching pay-per-release on globally. An upgrade button only appears on a published membership when there is a higher published plan above it.
Before you go live
- Use production credentials for production and test credentials for testing. Never mix them.
- Confirm your gateway account is on the right legal entity and settlement currency.
- Test the success path, the cancel path, and an expired session.
- If you offer both memberships and pay-per-release, test one of each.
The query string a customer lands back on after checkout is navigation data only. Never treat it as confirmation that an order, subscription, add-on, or credit balance is paid, and never diagnose a failed payment from it. Your gateway dashboard and the platform's own order records are the truth.
If a payment fails
| Symptom | Check |
|---|---|
| Checkout will not open | Gateway is activated and credentials saved for the right environment |
| Card is charged but nothing unlocks | Webhook is registered and the webhook secret matches |
| Memberships fail but one-time payments work | The Subscriptions switch is on for that gateway |
| Airwallex checkout errors on some steps | A required scope is missing from the API key |
If a production gateway starts failing, switch that gateway off rather than repeatedly replacing secrets. Existing subscriptions stay manageable, and you can restore the working configuration from your gateway control panel.
Common questions
Can I use more than one gateway at once? Yes. Activate each one you want, and set the Subscriptions switch per gateway.
Does SpaceMedia take the payment? No. The gateway account is yours, and settlement goes to you.
Why is this section greyed out? Payment Options stays read-only until the 30-day free trial is started with an authorized card. See Getting Started.
Where do refunds happen? In your gateway dashboard, as with any other charge on your merchant account.
Was this page helpful?
Languages
Choose which of the ten supported interface languages your SpaceMedia portal offers, set the default for new users, and understand right-to-left layout support.
Domain Setup
Connect your own domain to your SpaceMedia portal: publish the TXT ownership record, verify ownership, add the CNAME, and switch over without downtime.