Breadcrumbs

Integrate Asaas with Kubo for use in the Marketplace

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

Prerequisites

Before you begin, check that:

  • Your company has an active Asaas account.

  • The account registration is complete.

  • The company documents have been approved.

  • The bank account for withdrawals has been validated.

Instructions

Step 1: obtain the Asaas API key

  1. Access the Asaas panel with your login

  2. Click the gear icon in the upper-right corner

  3. Go to the Integrations menu

  4. Locate the Generate API Key or API Key section

  5. Copy the generated API Key (access token)

Store this credential in a safe place and never share it publicly.

Step 2: configure the API key in Kubo

  1. Access the Marketplace > Configuration menu

  2. Click on the Payment tab

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

  4. Fill in the API Key field with the credential obtained in Step 1

For guidance on the other configuration fields, access Configure payment.

  1. 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 > Asaas, copy the URL displayed in the Webhook field

  4. Access the Asaas panel

  5. Access Settings > Integrations

  6. Locate the Webhooks section and set up a new webhook

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

  8. In the event queue, select the options related to status updates (Payment Received, Overdue Payment, etc.)

  9. Save the configurations in Asaas

Step 4: test the integration

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

  2. Complete the payment

  3. Verify that the order status in Kubo has been updated to Paid within a few moments

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

Last updated: