For AI agents: the complete documentation index is available at https://docs.clickmax.io/en/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/en/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/en/features/integrations/stripe.md.
  • English

      • Integrate Stripe

      With the Stripe integration, sales from your Stripe account reach ClickMax and create or update the contact by the buyer's email. It also unlocks the Stripe Checkout block in the page editor, which needs the publishable key and the webhook signing secret.

      Before you start

      • You need access to the Developers area of your Stripe account.
      • Both keys must be in the same mode: both live or both test.

      Step by step

      1. Create the restricted key in Stripe

      1. In Stripe, open Developers → API keys and click Create restricted key.
      2. Under Choose how this key will be used, select Sharing with an external service.
      3. Fill in:
        • Vendor name: ClickMax;
        • URL: https://clickmax.io.
      4. Under Assign permissions to your key, choose Standard. It already covers everything ClickMax uses: creating the checkout, listing prices and products, and receiving payments, refunds and disputes.
      5. Create the key and copy its value (it starts with rk_).

      2. Create the integration in ClickMax

      1. In ClickMax, open Integrations, pick Stripe and paste the key into Secret or restricted key.
      2. In Stripe, under Developers → API keys, copy the Publishable key (it starts with pk_) and paste it into Publishable key.
      3. Give the integration a name, set the status and click Create integration.
      4. Copy the webhook URL ClickMax shows.

      3. Register the webhook in Stripe

      1. In Stripe, open Webhooks → Add destination and select the events:
        • checkout.session.completed
        • checkout.session.async_payment_succeeded
        • checkout.session.async_payment_failed
        • invoice.payment_succeeded
        • invoice.payment_failed
        • charge.refunded
        • charge.dispute.created
        • charge.dispute.closed
      2. Choose Webhook endpoint, paste the ClickMax URL and click Add destination.
      3. Open the new destination and copy the Signing secret (it starts with whsec_).
      4. Go back to ClickMax, paste the secret into Webhook signing secret and click Finish integration.

      With the signing secret, ClickMax only accepts webhooks sent by your Stripe account.

      What arrives in ClickMax

      In StripeIn ClickMax
      Payment approvedPaid sale, with the total and the Stripe currency
      Boleto, bank debit or another payment that settles laterPending sale; it becomes paid when Stripe confirms, or failed if the payment doesn't go through
      SubscriptionOne sale per paid invoice. The first invoice and the checkout that created it count as a single sale. A declined charge shows as failed and becomes paid if Stripe collects it later
      Full refundThe sale becomes refunded and leaves revenue. A partial refund keeps the sale paid
      Dispute (chargeback)The sale becomes a chargeback. If you win the dispute, it goes back to paid

      Extra items in the same order show up as additional products of the sale.

      If it didn't work

      • The field turns red: the key you pasted is not the requested type. The secret key starts with sk_, the restricted key with rk_, the publishable key with pk_ and the signing secret with whsec_.
      • Error creating integration (or Error completing integration) shows up: check that:
        • both keys are in the same mode (both live or both test);
        • the restricted key was created with the Standard permissions;
        • the key was not deleted or rolled in Stripe.
      • Prices don't show in the editor or the checkout doesn't load: the restricted key is missing a permission. In Stripe, open the key, click Edit on the permissions and use Standard.
      • Sales don't arrive, or refunds and disputes don't change the sale: in Stripe, under Webhooks, check that the destination has the eight events from step 3 and that deliveries succeed. If you rolled the signing secret in Stripe, paste the new one in ClickMax.