Smilepayz API Docs

Multi-region pay-in and pay-out APIs — sandbox, signing, and callbacks.

Start integration API Reference Signature guide Website

Secure signing

RSA request signing and callback verification on every API call.

Multi-region

Fiat rails across Asia, Americas, Africa, plus USDT stablecoin pay-in.

Multi-Env

Test end-to-end in sandbox before switching gateway URLs and credentials.

Real-time callbacks

HTTPS webhooks for pay-in, pay-out, and inquiry status updates.

Quick links

Getting StartedSign in to the merchant backend and explore the dashboard.Account · Dashboard · 2FA Integration FlowSandbox credentials, callbacks, RSA keys, and your first API call.Sandbox → Production Product ReferenceSignature rules, data models, error codes, and API overview.Signature · Models · Errors FAQCommon integration questions, troubleshooting, and best practices.Search · Answers

Integration in 3 steps

Get sandbox credentials

Sign in to the merchant backendopen in new window, open the Sandbox tab, and copy your Merchant ID, Merchant Secret, and Platform Public Key. See Step 1 in the integration guide.

Sign your requests

Every pay-in, pay-out, and inquiry call requires X-TIMESTAMP, X-SIGNATURE, and X-PARTNER-ID headers. Follow the signature guide to minify the JSON body and sign with your RSA private key.

Call your first API

Point your client at https://sandbox-gateway.smilepayz.com and create a pay-in order for your region—for example India Pay-in. A response code of 00 means the order was accepted.

Browse API by region

Popular entry points below. Use the API Reference menu in the navbar for the full list (14 regions + USDT).

IndiaINR — UPI, bank transfer, pay-in and pay-out.Pay-in · Inquiry · Methods IndonesiaIDR — QRIS, virtual account, and local rails.Pay-in · Inquiry · Methods ThailandTHB — QRPAY, bank transfer, and settlement docs.Pay-in · Inquiry · Methods BrazilBRL — PIX and bank transfer for pay-in and pay-out.Pay-in · Inquiry · Methods MexicoMXN — SPEI and bank transfer APIs.Pay-in · Inquiry · Methods USDTStablecoin pay-in on TRC20 — balance and status inquiry.Pay-in · Inquiry · Methods

Support & resources

Join the merchant community for integration tips and announcements.

Telegram Bot guide →

Merchant account

Self-service registration is not available. Contact your Business Development representative to obtain credentials.

Get Started →

Sandbox gateway

Base URL for integration tests (HTTPS, JSON, API v2.0):

https://sandbox-gateway.smilepayz.com