Connecting your provider account
Connecting your own Stripe, PayPal or Square account without copying keys, what the connection statuses mean, and how to end a connection.
Where your platform offers it, Settings → Gateways shows Connect an account. Instead of copying API keys and registering a webhook, you sign in at the provider and allow the platform to take payments for your account.
- The money goes to your own provider account. The platform charges no fee.
- You enter your sign-in at the provider only; this site never sees it.
- Only owners can connect, continue or end a connection.
If the panel is missing, your platform has not set the connection up, or it manages gateways for your workspace. You can still add a set with your own keys: see Gateways.
Connect#
- Press Connect Stripe, Connect PayPal or Connect Square (Test first, if offered).
- A short page says where you are going, then the provider's pages open. Complete them.
- The provider sends you back to the new credential set.
The set goes into service on its own when the provider accepts payments on the account. Then choose it for that provider on your products (Products and plans).
Statuses#
Text description
A connected set starts as Onboarding while the workspace fills in the provider's own pages. When the provider knows the account but does not accept payments on it yet, the set is Restricted. When the provider accepts payments the set is Enabled and goes into service as Test or Live. An enabled account can become restricted again, which takes the set out of service and e-mails the owners. From any of the three the connection can end as Revoked: the workspace disconnects, or the provider reports that access was withdrawn. Revoked is final.
| Connection | What to do |
|---|---|
| Onboarding | The provider's pages were not completed. Continue at the provider. |
| Restricted | The provider needs something more — a document, a confirmed e-mail address, a location. The set's page says what. |
| Enabled | Nothing. The set is in service. |
| Revoked | The connection has ended. Connect again to get a new set. |
If an account that was Enabled becomes Restricted, the set leaves service, your products stop offering that provider, and the owners get an e-mail. It returns on its own when the provider is satisfied.
Check status now asks the provider at once. Otherwise the status follows the provider's own reports and an hourly check.
Provider notes#
- Stripe — bank payments (ACH) are offered through a connected set only when Stripe has activated them for your account; until then products show cards for that set.
- PayPal — you need a PayPal Business account with a confirmed e-mail address.
- Square — your account needs an active US-dollar location with card processing. With several locations, choose on the set's page where payments are taken.
- Authorize.net — has no connection of this kind. Open an Authorize.net account leads to its sign-up page; afterwards add the account's keys with Add credential set (Authorize.net guide).
Pause or end a connection#
- Disable for now takes the set out of service and keeps the connection. Re-enable brings it back.
- Disconnect is final for the set. Refunds and disputes of earlier payments can then no longer be handled from here, so settle them first. Your provider account is not closed.
One provider account can be connected to one workspace at a time.