秘鲁 API 介绍

接入提示

联调请使用沙盒环境，上线前再切换至生产。商户凭据与环境切换步骤见 集成流程；请求签名见 签名生成。

接口文档导航

模块	文档
交易	收款（Pay-in） · 付款（Pay-out）
查询	交易状态 · 余额查询
结算	结算说明 · 结算 SLA
支付方式	支付方式

环境配置

环境	协议	媒体类型	基础 URL
沙盒	HTTPS	application/json	https://sandbox-gateway.smilepayz.com
生产	HTTPS	application/json	https://gateway.smilepayz.com

API 概述

秘鲁 代表了一个充满活力且快速发展的数字支付生态系统，具有创新、普惠金融和强劲增长的特点。我们的综合 API 解决方案专门针对秘鲁市场的独特特征而设计。

主要特点

1. 全面的支付解决方案：支持多种支付方式，包括通过授权支付中心的现金支付（CASHIER_PE）和广泛的银行网络集成
2. 本地市场适配：针对秘鲁银行法规、货币（PEN）和本地支付偏好量身定制的解决方案
3. 安全性和合规性：完全符合秘鲁金融法规和国际安全标准
4. 实时处理：即时交易处理和状态更新，提升用户体验
5. 跨境能力：支持国际交易，同时保持本地合规性
6. 开发者友好：全面的 SDK、详细文档和丰富的代码示例

秘鲁市场特征

• 货币：秘鲁索尔（PEN）
• 时区：UTC-5（秘鲁标准时间）
• 银行系统：广泛的商业银行、储蓄银行和专业金融机构网络
• 支付偏好：强烈偏好现金支付和传统银行方式
• 监管框架：符合 SBS（银行、保险和养老金监管局）法规

开发资源

代码示例

smilepayz-demo-java →

• PayInRequestDemo.java — 收款
• PayoutRequestDemo.java — 付款
• InquiryBalanceDemo.java — 余额查询
• InquiryOrderStatusDemo.java — 订单与交易状态
• SignatureUtils.java — 签名辅助（minify、RSA-SHA256）

smilepayz-demo-python →

• pay_in_request_demo.py — 收款
• pay_out_request_demo.py — 付款
• balance_inquiry.py — 余额查询
• status_inquiry.py — 订单与交易状态
• Tool_Sign.py — 签名辅助（minify、RSA-SHA256）

smilepayz-demo-node.js →

• pay_in_request_demo.js — 收款
• pay_out_request_demo.js — 付款
• inquiry_balance_demo.js — 余额查询
• inquiry_order_status.js — 订单与交易状态
• SignatureUtils.js — 签名辅助（minify、RSA-SHA256）

smilepayz-sdk-php →

• PayInRequestDemo.php — 收款
• PayoutRequestDemo.php — 付款
• InquiryBalanceDemo.php — 余额查询
• InquiryOrderStatusDemo.php — 订单与交易状态
• Signature.php — 签名辅助（minify、RSA-SHA256）

smilepayz-demo-cs →

• PayInRequestDemo.cs — 收款
• PayOutRequestDemo.cs — 付款
• BalanceInquiryDemo.cs — 余额查询
• OrderStatusInquiryDemo.cs — 订单与交易状态
• SignatureUtils.cs — 签名辅助（minify、RSA-SHA256）

smilepayz-demo-golang →

• PayInRequestDemoV2.go — 收款
• PayoutRequestDemoV2.go — 付款
• BalanceInquiryDemoV2.go — 余额查询
• OrderStatusInquiryDemoV2.go — 订单与交易状态
• SignatureUtils.go — 签名辅助（minify、RSA-SHA256）