billing help · For merchants
Tutorials
Step-by-step walkthroughs: your first payment in fifteen minutes, a subscription product, handling a dispute, and revenue share with payouts.
- Your first payment in 15 minutes
- Add a subscription product with a free trial
- Handle a dispute
- Set up revenue share
Your first payment in 15 minutes
You need: a workspace owner account and a Stripe account (sign-up takes two minutes; test mode works before verification).
1. Copy Stripe's test keys#
In Stripe, stay in the sandbox (test mode). Developers → API keys: copy the publishable key (pk_test_…) and the secret key (sk_test_…).
2. Add the credential set#
Settings → Gateways → Add credential set → Stripe, environment Test, label "Stripe test". Paste both keys and save. On the set's page, press Verify credentials.
3. Register the webhook#
Copy the Webhook endpoint URL from the set's page. In Stripe's Workbench → Webhooks → Create an event destination, paste it, select the events listed on the set's page, and create it. Reveal the signing secret (whsec_…) and paste it into the set. Then Put in service (Test).
4. Create a product#
Products → New product: name "Test product", price type Fixed, status Active. Save, then Add plan: "One-time", interval One-time, price 5.00. Under Pay with, choose "Stripe test" for Stripe and save.
5. Pay#
Press Open pay page. Enter your email, choose Stripe and continue. On Stripe's page pay with card 4242 4242 4242 4242, any future date and any CVC. Back on the Thank you page, the confirmation code appears within seconds.
6. Check and refund#
Transactions shows the payment as Paid, with the fee and net from Stripe and the events under History. Your receipt email has the same code. On the payment's page press Refund everything; the status becomes Refunded when Stripe confirms.
When this works, repeat steps 1–3 with live keys in a new Live set, and switch the product to it. The Stripe guide has the go-live checklist.
Add a subscription product with a free trial
You need a credential set in service for Stripe, PayPal or Authorize.net (Square does not offer trials). See Your first payment.
1. Create the product#
Products → New product: name "Pro", price type Fixed, status Active. Set the refund policy, for example a 14-day window with full refunds only.
2. Add the plans#
Add plan twice:
- "Pro monthly" — interval Monthly, price
19.00, trial days14; - "Pro annual" — interval Annual, price
190.00, trial days14.
Plans cannot be edited later; to change a price you add a new plan and archive the old one.
3. Choose the providers#
Under Pay with, choose your credential sets. Tiles that cannot take a trial are hidden on the pay page automatically.
4. Subscribe as a customer#
Open the pay page, choose "Pro monthly", pay with a test card. Before the trial ends nothing is charged; the subscription shows Trialing. The customer's account lists it under Subscriptions with the date the trial ends.
5. Watch a renewal#
When the trial ends, the provider charges the first month. A new payment with its own confirmation code appears, the subscription becomes Active, and the customer is emailed. In Stripe's sandbox you can move time forward with a test clock to see this at once.
6. Try the customer's actions#
In the customer's account, Manage the subscription: Change plan (applies at the next renewal), Pause, Resume, Cancel (access until the end of the paid period). Each action calls the provider, and the provider's webhook updates the status. Subscriptions explains every status.
Handle a dispute
A buyer's bank opened a chargeback. The money is held back until the bank decides, and you have until the evidence deadline to answer.
1. Open the dispute#
The email you received links to it; or open Disputes, where open cases are sorted by deadline. Note the reason (for example fraudulent, product not received, subscription canceled) and the deadline.
2. Decide whether to fight it#
If the buyer is right — a duplicate charge, a canceled subscription that renewed, a product that did not work — accepting is cheaper: refunding after a dispute does not stop it, but not contesting ends it quickly. For a fraud warning (Stripe), refund now; the warning then closes without a chargeback.
3. Gather evidence for the reason#
Open the payment from the dispute. Collect what answers the reason: the receipt and confirmation code, proof of delivery or use (downloads, license check-ins, sign-ins), your emails with the buyer, and your terms and refund policy as they were at the time of purchase.
4. Add files and a note#
On the dispute's page, add the files (PDF, PNG, JPEG or text, up to 5 MB each) and write a short note: what was bought, when, how it was delivered, and why the claim does not apply. Facts and dates only.
5. Submit#
- Stripe: press Submit. The note, the customer's email, the product description and the first file go to Stripe in one submission, so submit only when complete.
- PayPal or Square: submit the same material in the provider's dashboard, then press Submit here to record it.
The case becomes Submitted.
6. Wait for the decision#
Banks take from a few weeks to a few months. The decision arrives by webhook: Won returns the payment to Paid (flagged), Lost makes it a Chargeback and ends paid access. Either way you are emailed. Disputes and evidence has more on evidence and on keeping disputes rare.