Appearance
Onboarding
How you become a Maytes merchant and get everything the rest of this documentation assumes: your merchant account, your API credentials, and a payment-ready payout account.
Onboarding is email-based today — you work through it with the Maytes team — and will become self-served in the near future. The steps below are the same either way; what changes is who clicks the buttons.
The steps
1. Contact Maytes
Reach out to the Maytes team by email to start onboarding. We'll collect your business details — registered name, contact email, country, and payout currency.
2. Maytes creates your merchant account
The Maytes team provisions, in one step:
- Your merchant account in Maytes.
- Your OAuth client credentials (
client_id+client_secret) — what your backend uses for every API call. Separate pairs are issued for the sandbox and production. - A dedicated Stripe connected account for your business. This account is yours: every payment your customers make flows through it, keeping you the merchant of record, and it's where your settlements are paid from.
3. Complete your Stripe account setup
You'll receive a Stripe-hosted onboarding link to finish setting up the connected account — verifying your business identity and connecting your bank account for payouts. This happens on Stripe's secure pages; Maytes never sees or stores those details.
Onboarding links are single-use and expire in minutes
The Stripe setup link is single-use and expires minutes after it's generated — that's a Stripe security property, not a configurable timeout. Don't bookmark it or forward it for later.
An expired link never loses progress: generate a fresh link on demand from the merchant portal — each one picks up exactly where you left off on the same account.
Until this step is complete, your account can't process payments — checkouts can be created, but customers can't pay.
4. Integrate
With credentials in hand and Stripe setup complete, you're ready for the rest of this documentation:
- How it works — pick your integration flow.
- Quickstart — a working integration against the sandbox.
- Go live — the pre-launch checklist.
What you end up with
| Artifact | Where it lives | Used for |
|---|---|---|
| Merchant account | Maytes | Everything — your checkouts, settlements, portal access. |
client_id / client_secret (per environment) | Your server config | Authenticating every API call. |
| Stripe connected account | Stripe (managed via Maytes) | Processing your customers' payments and paying out your settlements. You remain the merchant of record. |
| Merchant portal access | portal | Settlements dashboard, webhook configuration, credentials. |
Next
- Merchant portal — where your settlements and configuration live.
- Quickstart — start integrating.
