Skip to main content
After completing the commercial process and signing the contract, follow this flow to start accepting payments.

​
General flow

1. Credentials

Obtain the access details required to begin the integration.

2. Integration method

Choose how to integrate payments for your channel.

3. Configuration

Configure the integration and payment parameters.

4. Testing (Sandbox)

Validate the integration in the sandbox environment.

5. Preproduction

Validate the complete flow with production credentials.

6. Production

Activate live payments and begin operating.

​
Integration flow

1

Obtain your credentials

Obtain your access credentials (Client ID, Client Secret, and Merchant ID). The integration team will contact you and deliver them securely.You can use these credentials to authenticate API requests, identify your merchant in transactions, and configure the SANDBOX and PRODUCTION environments.Sandbox is used to test and validate an integration without affecting real transactions. Production is the live environment for processing real transactions.
2

Choose your integration method

Select the method that best fits your business (Web, Mobile, API, CMS, or POS) and define the payment methods you want to enable. Consider the sales channel, required customization, and available technical resources.
3

Configure your integration method

Follow the corresponding technical guide and implement authentication, transaction parameters, and required components.
  • Configure authentication (API key or tokens).
  • Define parameters such as amount, currency, and merchant_operation_number.
  • Configure return URLs and notifications (webhooks/S2S).
  • Integrate frontend components or an SDK when applicable.
4

Run tests

Execute sandbox transactions and validate payment states, responses, and error handling.
Test approved and declined scenarios and verify that notifications (webhooks/S2S) are received correctly.
Review Transaction states for more information about the transaction lifecycle.
5

Validate in preproduction

The integration team will validate your implementation and, if approved, provide your production credentials.Run controlled tests, validate the end-to-end flow—including notifications—and confirm that transactions are processed correctly. Complete the Technical certification checklist before continuing.
6

Activate production

Activate the live integration, process real transactions, and monitor system behavior and logs.
Review the General best practices to ensure a secure and robust implementation.

​
Run your first transaction

​
Direct integration

Mobile SDK (iOS / Android)

Test the payment flow from a mobile application.

Web Checkout (Flex)

Run a transaction using the hosted checkout.

​
E-commerce (CMS)

E-commerce introduction

Review the WooCommerce, PrestaShop, and VTEX options.

WooCommerce

Configure the plugin and run a test purchase.

PrestaShop

Activate the module and run a test transaction.

VTEX

Integrate and validate an e-commerce purchase.