Skip to main content

​
API Reference

This section contains endpoint-level documentation. For conceptual overviews and country-specific configuration, see the Overview page and country configuration pages: Colombia and Peru.

​
Authentication

All API requests require authentication. Tumipay uses two methods of authentication: Basic Authentication requires a username and a password for secure access: 
Authorization: Basic base64(username:password)
These credentials are provided when you register as a Tumipay merchant. In addition to Basic Authentication, most endpoints require a token in the request headers: 
Token-Top: your_access_token
This token is unique to your merchant account and should be kept secure.

​
API Overview

Tumipay offers three main API categories to handle different aspects of payment processing:

Merchant API

Retrieve balance and search transaction history

PayIn API

Process incoming payments with multiple methods

PayOut API

Execute disbursements and bank transfers

​
Getting Started

To obtain the necessary credentials for accessing and using our APIs, please send an email to [email protected]. This process is required for the secure generation and assignment of your personal API credentials.

​
Environments

​
Staging Environment

During development, use our Staging (Sandbox) environment for testing. This environment simulates real operations but does not process actual monetary transactions. 
Base URL: https://api-empresas.staging.tumipay.co/production/api
In the Sandbox environment:
  • To perform payouts, you must first create a successful payin to add funds to your test balance.
  • Test transactions can be simulated using specific test parameters provided in this documentation.
  • No real money is processed or transferred.
Once your integration is complete and thoroughly tested:
  1. Send us an email with your test results to [email protected] for review.
  2. After approval, request your production credentials.
  3. Update your API base URL to the production endpoint.