Plans & billing
Payment providers
This page is where you set up how your club collects money. You enable one or more payment providers -- manual SEPA, Stripe, or Asaas (PIX for Brazilian clubs) -- and, per provider, choose which payment methods are available to your members. These settings determine which options a member is offered when signing up or adding a payment method in the portal.
Navigate to Settings > Payment providers to configure your providers.
Not the same as a member's payment methods
This is the admin settings page where you define the available providers and methods for your whole club. It is distinct from the member-facing page where an individual member stores their own bank details or SEPA mandate.
Payment providers
Each provider is shown as a card with its logo, a short description, and a toggle to enable it. Only enable the providers your club actually uses.
| Provider | Description |
|---|---|
| Manual (SEPA) | You generate SEPA XML files and submit the direct debits to your bank yourself. No external connection is required; this provider is available with no setup. |
| Stripe | Managed SEPA direct debits through Stripe. Stripe handles collection and reports payment status back automatically. |
| Asaas | PIX payments for Brazilian clubs (see below). Only shown in the relevant regions. |
Payment methods per provider
Within each provider card, you use checkboxes to choose which payment methods that provider offers to your members. The methods available depend on the provider:
| Provider | Methods |
|---|---|
| Manual / Stripe | SEPA direct debit. |
| Asaas | PIX (a one-off QR code the member scans manually) and PIX Automático (a mandate scanned once that authorizes future charges automatically). |
Only checked methods appear for members. After changing anything on a provider, click Save to apply the selection.
Connecting Stripe
Stripe requires a one-time onboarding before it can collect payments. Enable the Stripe provider and click Connect -- you'll be redirected to Stripe to set up and verify your account. Once complete, you return to Omoplata and the provider shows a Connected status.
- When onboarding is complete, a green "Connected" badge appears. Use Re-onboard to repeat the onboarding if needed.
- If onboarding isn't completed, the provider stays in the not-connected state and prompts you to reconnect. Stripe can only collect payments once the status reads "Connected".
Manual SEPA needs no onboarding
The manual SEPA provider is available immediately because you submit the direct debit files to your bank yourself. Only providers with an external connection (like Stripe or Asaas) go through a connection step.
Asaas (PIX) for Brazilian clubs
Asaas is a Brazilian payment platform for PIX payments. It offers two methods:
| Method | Description |
|---|---|
| PIX | A one-off charge. Asaas generates a QR code the member scans in their banking app to pay each invoice. |
| PIX Automático | A recurring mandate. The member scans a combined QR code once that pays the first invoice and authorizes future charges at the same time -- after that, collection runs automatically. |
The Asaas credentials (API key, environment, webhook token, QR code expiry) are managed separately under Settings > Billing in the Asaas section. To fully enable Asaas:
- Under Billing > Asaas, enter the API key and set the webhook token in the Asaas dashboard.
- On this page, enable the PIX and/or PIX Automático methods.
- Enable the Asaas provider and save.
How these settings affect billing
Regardless of the provider you choose, Omoplata remains the single source of truth for the billing schedule: transactions are generated from the membership's recurring rules, and an invoice is created for each billing cycle. The provider only determines how that invoice is actually collected:
| Provider | Description |
|---|---|
| Manual | You export a SEPA XML file and submit it to your bank. |
| Stripe | The direct debit is triggered automatically and the status is reported back. |
| Asaas | One PIX charge is created per billing cycle; webhooks update the payment status automatically. |
When you disable a provider or hide a method, it only affects new selections -- existing memberships with a payment method already on file continue to be billed as usual.