Skip to main content
This document provides a comprehensive guide for integrating the TumiPay API into your systems or applications, enabling simple and secure transactions. It includes all the technical information and best practices needed for API integration.

​
Overview of APIs

Tumipay provides three main API services:
  1. PayIn API: Process payment collections through various payment methods.
  2. PayOut API: Handle disbursements to bank accounts and digital wallets.
  3. Merchant API: Retrieve merchant balance and search transactions.

​
Country-Specific Information

Our services are available in multiple countries. Each country has its own set of supported payment methods, document types, and other specific configurations. Please refer to the documentation for each country for detailed information.

Colombia

Specific information for Colombia

Peru

Specific information for Peru

​
Authorization

The Authorization section explains how to include authentication details in your API requests. TumiPay uses Basic Authentication, which requires a username and password for secure access, represented as {{user}} and {{password}}, respectively.

​
Request Headers

The “Request Headers” section outlines how to include additional information in your API requests. For example, a header named Token-Top is used to provide an authentication token. Tumipay’s API offers a wide range of functionalities, empowering you to manage various actions available through the platform efficiently. To request the necessary credentials for access and use of our APIs, please send an email to the address provided. This step is essential for the generation and assignment of your personal credentials: [email protected], [email protected]

​
Environments

Test your integration using the Sandbox environment, which does not involve real monetary transactions. Once your integration is complete and you are ready for production, contact the TumiPay team for approval. To perform payouts, you can create a successful payin within the same Sandbox environment. This will add funds to your balance, allowing you to proceed with the necessary payouts.

​
Sandbox

For certification and testing purposes, we provide a dedicated staging environment. This allows you to test your integration without affecting production systems. 
https://api-empresas.staging.tumipay.co/production/api
When testing payment flows in the sandbox environment, you can use specific parameters to generate approved or rejected transactions. For example, to test the PayIn API with different statuses, select the payment method PSE and complete the form:
  • For approved transactions: Use the e-mail address “[email protected]”.
  • For rejected transactions: Use any other email.
During the integration phase, you can use the sandbox environment to simulate transactions. This allows you to test your implementation thoroughly before moving to production.