Colombia API Introduction

Environment Configuration

Environment	Protocol	MediaType	Base URL
SandBox	https	application/json	https://sandbox-gateway.smilepayz.com
Production	https	application/json	https://gateway.smilepayz.com

Colombia Market Overview

Colombia represents one of Latin America's most dynamic digital payment markets, characterized by rapid fintech adoption, strong banking infrastructure, and innovative payment solutions. Our comprehensive API suite is specifically designed to address the unique requirements of the Colombian market.

Key Market Characteristics

1. Strong Banking Infrastructure: Colombia boasts a robust banking system with high penetration rates and widespread digital adoption
2. Diverse Payment Methods: Support for major Colombian banks including Bancolombia, Banco de Bogotá, Davivienda, and other leading financial institutions
3. Cash Payment Integration: Traditional cash payment methods remain essential, supported through our CASHIER_CO system
4. Comprehensive Identity Verification: Full support for Colombian identity documents including CC (Cédula de Ciudadanía) and CE (Cédula de Extranjería)
5. Real-Time Processing: Advanced payment processing capabilities with immediate transaction confirmation
6. Regulatory Compliance: Full compliance with Colombian financial regulations and Superintendencia Financiera requirements

Supported Payment Solutions

• Bank Transfers: Direct integration with major Colombian banks for secure and efficient fund transfers
• Cash Payments: Traditional cash payment collection through authorized payment centers
• Digital Banking: Integration with Colombia's advanced digital banking platforms
• Cross-Border Transactions: Support for international payment processing
• Real-Time Settlement: Immediate transaction processing and settlement capabilities

API Features

• Multi-Bank Support: Seamless integration with Colombia's leading banking institutions
• Identity Verification: Comprehensive support for Colombian identity document types
• Account Type Flexibility: Support for both current (CORRIENTE) and savings (AHORROS) accounts
• Local Currency Processing: Native support for Colombian Peso (COP) transactions
• Timezone Optimization: All timestamps optimized for Colombia's UTC-5 timezone
• Security Standards: Bank-grade security with RSA digital signatures and encryption

Development Resources

GitHub Code Examples

java demo

• PayInRequestDemo.java - Complete pay-in transaction implementation
• PayoutRequestDemo.java - Comprehensive pay-out transaction processing
• InquiryBalanceDemo.java - Real-time account balance inquiry
• InquiryOrderStatusDemo.java - Transaction status monitoring
• SignatureUtils.java - Digital signature utilities including minify(body), sha256RsaSignature, and checkSha256RsaSignature methods

python demo

• pay_in_request_demo.py - Pay-in transaction implementation
• pay_out_request_demo.py - Pay-out transaction processing
• balance_inquiry.py - Account balance inquiry functionality
• status_inquiry.py - Transaction status monitoring
• Tool_Sign.py - Digital signature utilities with minify(body), sha256RsaSignature, and checkSha256RsaSignature methods

node.js demo

• pay_in_request_demo.js - Pay-in transaction implementation
• pay_out_request_demo.js - Pay-out transaction processing
• inquiry_balance_demo.js - Account balance inquiry functionality
• inquiry_order_status.js - Transaction status monitoring
• SignatureUtils.js - Digital signature utilities with minify(body), sha256RsaSignature, and checkSha256RsaSignature methods

php demo

• PayInRequestDemo.php - Pay-in transaction implementation
• PayoutRequestDemo.php - Pay-out transaction processing
• InquiryBalanceDemo.php - Account balance inquiry functionality
• InquiryOrderStatusDemo.php - Transaction status monitoring
• Signature.php - Digital signature utilities with minify(body), sha256RsaSignature, and checkSha256RsaSignature methods

c# demo

• PayInRequestDemo.cs - Pay-in transaction implementation
• PayOutRequestDemo.cs - Pay-out transaction processing
• BalanceInquiryDemo.cs - Account balance inquiry functionality
• OrderStatusInquiryDemo.cs - Transaction status monitoring
• SignatureUtils.cs - Digital signature utilities with minify(body), sha256RsaSignature, and checkSha256RsaSignature methods

golang demo

• /v2/PayInRequestDemoV2.go - Pay-in transaction implementation
• /v2/PayoutRequestDemov2.go - Pay-out transaction processing
• /v2/BalanceInquiryDemoV2.go - Account balance inquiry functionality
• /v2/OrderStatusInquiryDemoV2.go - Transaction status monitoring
• /common/SignatureUtils.go - Digital signature utilities with minify(body), sha256RsaSignature, and checkSha256RsaSignature methods

The current document version is above 1.0.5 (including 1.0.5). Please download 1.0.5 and install it before payment

• Download Plugin V1.0.5

Installation Guide

WooCommerce Plugin Installation

1. Plugin Discovery: Search for the plugin in the WordPress plugin directory
2. Installation: Click "Install Now" to begin the installation process
3. Activation: Activate the plugin after successful installation
4. Manual Upload: Alternatively, use the "Upload Plugin" option at the top of the page
5. File Selection: Click "Choose File" and locate the plugin file
6. Completion: Click "Activate Plugin" after installation is complete

Configuration Setup

Step 1: Merchant Configuration

Configure your merchant credentials including MerchantID and MerchantSecret

Step 2: Payment Method Activation

Enable the desired payment methods for your store