Overview

The Merchant API V1 is the recommended API for new integrations. It provides full access to payment collection, wallet disbursement, beneficiary management, and settlement reporting.

Base URL

https://api.nusio-saka.com

For Flypay (whitelabel aggregator):

https://api.flypay.asia

All endpoints are prefixed with /v1/. All requests and responses use Content-Type: application/json.

Amount Units

All monetary values in the V1 API use minor units:

• 100 minor units = IDR 1
• IDR 50,000 = 5000000 minor units
• IDR 1,000,000 = 100000000 minor units

This applies to all request fields (e.g., amount_minor) and all response fields. Integer arithmetic — never floats.

Response Format

Success

{
  "success": true,
  "data": { ... }
}

Paginated Success

{
  "success": true,
  "data": [ ... ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 47,
    "total_pages": 5
  }
}

Error

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}

Pagination

List endpoints accept:

Parameter	Default	Maximum	Description
page	1	—	Page number (1-based)
limit	10	50	Items per page

Idempotency

To prevent duplicate processing on network retries:

• Orders: Send the Idempotency-Key request header. Any subsequent request with the same key returns the original response.
• Disbursements: Include an idempotency_key field in the request body. Duplicate submissions with the same key return the existing disbursement.

POST /v1/orders
Idempotency-Key: order-2026-06-01-00123

Rate Limits

Rate limiting is enforced per API key. Contact your account manager for your specific limits. When exceeded, the API returns HTTP 429 Too Many Requests.

HTTP Status Codes

Code	Meaning
200	Success (GET, update operations)
201	Created (POST operations that create a resource)
400	Bad request — validation error or invalid input
401	Unauthorized — missing or invalid API key
403	Forbidden — valid key but insufficient permissions
404	Resource not found
409	Conflict — duplicate resource
422	Unprocessable entity — business rule violation
429	Rate limit exceeded
503	Service unavailable — vendor gateway issue