Frequently Asked Questions

Welcome to the SmilePayz FAQ section. Here you'll find answers to the most common questions about our payment gateway services.

---

🔧 Account Management

How to get production account number?

Production Account Setup

Follow these steps to obtain your production account number from the merchant backend.

1. Login to merchant backend
2. Navigate to Finance → Balance menu
3. Switch between Payin and Payout tables to get different account numbers
4. Pay-in Account: Used to collect funds from all pay-in transactions
5. Account Structure: Each merchant has two accounts per currency (pay-in and pay-out)
6. Account Transfer: You can transfer money between pay-in and pay-out accounts
   • See Transfer Guide for detailed instructions

---

📋 API Parameters

What do M, C, and O mean in request parameters?

Symbol	Meaning	Description
M	Mandatory	Required parameter for all requests
C	Condition	Required in certain scenarios only
O	Optional	Optional parameter

What is minify(body)?

JSON Minification

minify(requestBody) converts request parameters to a JSON string and removes line breaks, spaces, and other escape characters.

• Purpose: Creates a compact JSON string for signature generation
• Implementation: We provide minify demos for various programming languages
• Reference: See Signature Tools for implementation examples

---

🇧🇷 Brazil Payment Methods

What is PIX?

Instant Payment System

PIX is Brazil's instant payment system launched by the Central Bank of Brazil.

• Type: Instant payment method for Brazil
• Features:
  • Real-time fund transfers 24/7
  • QR code payment completion
  • Instant settlement
• Availability: 24 hours a day, including weekends and holidays

What are CPF and CNPJ?

Document Type	Full Name	Description	Format
CPF	Cadastro de Pessoas Físicas	Individual taxpayer ID	11 digits
CNPJ	Cadastro Nacional da Pessoa Jurídica	Corporate taxpayer ID	14 digits

References:

• CPF Wikipedia
• CNPJ Wikipedia

Format of payment methods in Brazil

Method	Format	Example	Description
PHONE	+55 + 11 digits	+5511999999999	Mobile phone number
CPF	11 digits	12345678909	Personal identification
CNPJ	14 digits	12345678000199	Corporate identification
EMAIL	Email format	[email protected]	Email address

---

🚀 Environment Migration

How to migrate from sandbox to production?

Migration Prerequisites

Ensure your sandbox integration is complete and callbacks are working normally before migrating to production.

Migration Steps:

1. Update Domain

   - https://sandbox-gateway.smilepayz.com
   + https://gateway.smilepayz.com
   

2. Update Credentials

   • Switch merchant ID from sandbox to production
   • Switch MerchantSecret from sandbox to production

3. Security Configuration

   • Reconfigure RSA keys for production
   • Add production server IP to allowlist

Best Practice

Test thoroughly in sandbox before migrating to production to ensure smooth transition.

---

🛒 Checkout Page Development

How to create your own checkout page?

Custom Checkout Implementation

Create a personalized checkout experience while using SmilePayz payment processing.

Implementation Steps:

1. Purpose: Checkout page is for pay-in transactions
2. Ignore Payment URL: Do not use the payment URL returned by the API
3. Extract Data: Get qrString or Va number from API response
4. Create Interface: Build your own checkout page design
5. Display Payment Info: Show QR code or VA number with payment instructions
6. Complete: Your custom checkout is ready!

---

🇮🇩 Indonesia Special Cases

Special handling for Mandiri VA in Indonesia

Mandiri VA Processing

Mandiri VA requires special processing to avoid payment failures.

API Mode Implementation

If you choose API mode and directly obtain VA for your checkout page, please note:

Original VA Format: 146156926294

Payment Methods:

Payment Method	VA Format	Instructions
M-Banking Mandiri	146156926294	Choose Multipayment → "i+Pay or 70017"
Other M-Banking	88017146156926294	Add 88017 prefix, choose Transfer Bank → Bank Mandiri (008)

Important Note

Only Bank Mandiri can process the original VA format. Other banks require the 88017 prefix.