Developer Supports

This section helps developers quickly set up their environment, test API endpoints, and verify integration before going live.

1. Postman Collection

You can import the official Postman Collection to explore all available API endpoints.

Downloads:

• Postman Collection (JSON)
• Environment Variables (JSON)

Includes:

• Example headers (Authorization, Content-Type).
• Pre-configured requests for cloudECR APIs.
• Pre-request scripts for automatic token injection.

💡 Tip: Duplicate the collection into your own workspace, then update the cloudecr_base_url in the environment variables. Don’t forget to fill in the secretKey, posId, merchantId, and deviceId in the collection variables.

2. Fiuu POS Simulator

We’ve built a POS Simulator application to help you better understand and test the full integration flow. Head over to Fiuu POS Simulator and follow the on-screen steps to simulate real POS transactions.

Simulator Features

The POS Simulator supports the following features:

• Bind Terminal – Simulate binding a terminal to your POS account.
• Fetch Terminals – Retrieve a list of all bound terminals.
• Fetch E-wallet Channels – Get the supported e-wallet payment channels.
• Sale and Void Transaction – Perform a sale transaction or void an existing one.
• Transaction History – View the history of all simulated transactions.

3. Rate Limiting and Retry Policy

To ensure fair use and stability:

Policy	Description
Rate Limit	Each client is allowed up to 100 requests per minute per IP.
Retry Policy	For transient errors (5xx), retry with exponential backoff (e.g., 1s → 2s → 4s).

4. Testing Checklist

Step	What to Verify
✅ Authentication	You can successfully log in and refresh tokens.
✅ Terminal Binding APIs	Prebind terminals API successfully register your terminals for prebind. Bind Terminal Key API returns a valid QR Code or Key for terminal binding.
✅ Terminals API	Terminal list returns valid terminals bound to the POS system.
✅ e-Wallet Channels API	Channel list matches your merchant configuration.
✅ Transfer API	Returns transaction data and valid status.
✅ Error Handling	Invalid tokens or missing parameters return proper error codes.

5. Monitoring & Logging

During testing:

• Log all request and response bodies for debugging.
• Capture the HTTP status code and response time.
• Ensure sensitive data (tokens, passwords) are masked in logs.

6. Going Live

Before moving to production:

1. Switch to production credentials under registered merchant account.
2. Validate signature or token flow once in production mode.
3. Stop logging raw responses containing sensitive information.

7. Supports

If you experience integration issues, follow the steps below:

1. Check Logs – Review your request and response logs.
2. Validate Credentials – Confirm tokens and keys are current.
3. Retry with Backoff – For transient or 5xx errors.
4. Contact Support – If the issue persists, you may reach out to our support channels at .

Support Channel	Details
Email	support@fiuu.com
Telegram	Fiuu Developer Forum
Availability	Monday–Friday, 9:00 AM–6:00 PM (GMT+8)
Expected Response Time	Within 1-3 business days