Integrate Stripe with Kubo for use in the Marketplace

To use Stripe as a payment method in the Marketplace, you must integrate it with Kubo.

Prerequisites

Before you begin, check that:

• Your company has an active Stripe account.

• The account registration is complete and approved.

• The production environment is enabled.

Instructions

Step 1: obtain the Stripe Key and Stripe Secret credentials

1. Access the Stripe dashboard

2. Go to Developers > API Keys

3. Turn off Test Mode and make sure you are in the Production environment

4. Copy the Public Key, which begins with pk_live_

5. Copy the Secret Key, which begins with sk_live_
   If necessary, click to reveal it.

Step 2: configure the Stripe Key and Stripe Secret credentials in Kubo

1. Access the Marketplace > Configuration menu

2. Click on the Payment tab

3. In Payment method, activate the Enable option for Stripe

4. Fill in the Stripe Key and Stripe Secret fields with the credentials obtained in Step 1

5. Click the Save button

Step 3: configure the notification URL (Webhook)

1. Access the Marketplace > Configuration

2. Click on the Payment tab

3. In Payment method > Stripe, copy the URL displayed in the Webhook field

4. Access the Stripe panel

5. Access Developers > Webhooks

6. Click Add Endpoint

7. In the Endpoint URL field, paste the URL copied from Kubo in Step 3

8. Under Select events to listen for, select the billing and payment events (charge.succeeded, charge.failed, payment_intent.succeeded, etc.)

9. Click Add Endpoint to save

Step 4: test the integration

1. Generate a test transaction via credit card, with a minimum value of R$ 1.00, on the platform

2. Verify that the purchase status in Kubo has been automatically updated to Paid

This test allows you to verify that the integration is working correctly and that payments are automatically posted.

Last updated: August 06, 2026