API Reference
About 2 min
API Reference
Before you integrate
Use Sandbox for testing, then switch gateway URLs and credentials for Production. See the integration guide and signature guide. Response code meanings are in error codes.
Environment
| Environment | Protocol | Media Type | Base URL |
|---|---|---|---|
| Sandbox | HTTPS | application/json | https://sandbox-gateway.smilepayz.com |
| Production | HTTPS | application/json | https://gateway.smilepayz.com |
All regional APIs share the same gateway hosts. Pick your market below for endpoints, request fields, and payment methods.
Asia
IndiaINR — UPI, bank transfer, pay-in and pay-out.Pay-in · Inquiry · MethodsIndonesiaIDR — QRIS, virtual account, and local rails.Pay-in · Inquiry · MethodsPhilippinesPHP — local pay-in, pay-out, and inquiry APIs.Pay-in · Inquiry · MethodsThailandTHB — QRPAY, bank transfer, receipt upload.Pay-in · Inquiry · MethodsVietnamVND — local pay-in, pay-out, and balance inquiry.Pay-in · Inquiry · Methods
North America
South America
BrazilBRL — PIX and bank transfer for pay-in and pay-out.Pay-in · Inquiry · MethodsChileCLP — pay-in, pay-out, refund, and inquiry.Pay-in · Inquiry · MethodsColombiaCOP — pay-in, pay-out, refund, and inquiry.Pay-in · Inquiry · MethodsPeruPEN — pay-in, pay-out, refund, and inquiry.Pay-in · Inquiry · Methods
Africa
Digital currency
Common API categories
Each region documents the same core building blocks where applicable:
| Category | Typical endpoints |
|---|---|
| Transaction | Pay-in (v2.0/transaction/pay-in), pay-out (v2.0/disbursement/pay-out) |
| Inquiry | Order status (v2.0/inquiry-status), balance inquiry |
| Payment methods | Supported rails and channel codes for that market |