Peru 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

API Overview

Peru represents a dynamic and rapidly evolving digital payment ecosystem characterized by innovation, financial inclusion, and robust growth. Our comprehensive API solutions are specifically designed to address the unique characteristics of the Peruvian market.

Key Features

1. Comprehensive Payment Solutions: Support for multiple payment methods including cash payments through authorized payment centers (CASHIER_PE) and extensive bank network integration
2. Local Market Adaptation: Tailored solutions for Peruvian banking regulations, currency (PEN), and local payment preferences
3. Security and Compliance: Full compliance with Peruvian financial regulations and international security standards
4. Real-Time Processing: Instant transaction processing and status updates for enhanced user experience
5. Cross-Border Capabilities: Support for international transactions while maintaining local compliance
6. Developer-Friendly: Comprehensive SDKs, detailed documentation, and extensive code examples

Peruvian Market Characteristics

• Currency: Peruvian Sol (PEN)
• Timezone: UTC-5 (Peru Standard Time)
• Banking System: Extensive network of commercial banks, savings banks, and specialized financial institutions
• Payment Preferences: Strong preference for cash payments and traditional banking methods
• Regulatory Framework: Compliance with SBS (Superintendencia de Banca, Seguros y AFP) regulations

Development Resources

GitHub Repositories

java demo

• PayInRequestDemo.java - Pay-in transaction implementation
• PayoutRequestDemo.java - Pay-out transaction implementation
• InquiryBalanceDemo.java - Balance inquiry implementation
• InquiryOrderStatusDemo.java - Order status inquiry implementation
• SignatureUtils.java - Signature generation and verification utilities

python demo

• pay_in_request_demo.py - Pay-in transaction implementation
• pay_out_request_demo.py - Pay-out transaction implementation
• balance_inquiry.py - Balance inquiry implementation
• status_inquiry.py - Order status inquiry implementation
• Tool_Sign.py - Signature generation and verification utilities

node.js demo

• pay_in_request_demo.js - Pay-in transaction implementation
• pay_out_request_demo.js - Pay-out transaction implementation
• inquiry_balance_demo.js - Balance inquiry implementation
• inquiry_order_status.js - Order status inquiry implementation
• SignatureUtils.js - Signature generation and verification utilities

php demo

• PayInRequestDemo.php - Pay-in transaction implementation
• PayoutRequestDemo.php - Pay-out transaction implementation
• InquiryBalanceDemo.php - Balance inquiry implementation
• InquiryOrderStatusDemo.php - Order status inquiry implementation
• Signature.php - Signature generation and verification utilities

c# demo

• PayInRequestDemo.cs - Pay-in transaction implementation
• PayOutRequestDemo.cs - Pay-out transaction implementation
• BalanceInquiryDemo.cs - Balance inquiry implementation
• OrderStatusInquiryDemo.cs - Order status inquiry implementation
• SignatureUtils.cs - Signature generation and verification utilities

golang demo

• PayInRequestDemoV2.go - Pay-in transaction implementation
• PayoutRequestDemoV2.go - Pay-out transaction implementation
• BalanceInquiryDemoV2.go - Balance inquiry implementation
• OrderStatusInquiryDemoV2.go - Order status inquiry implementation
• SignatureUtils.go - Signature generation and verification utilities

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