Introduction
Welcome to the iPaymu API v2 documentation.
API ENVIRONMENT
Base URL
https://sandbox.ipaymu.com/api/v2Use credentials from the selected environment. Sandbox and Production credentials are separate.
Welcome to the iPaymu API v2 documentation. This API allows you to integrate iPaymu's payment gateway services into your application.
Base URLs
- Production/Live:
https://my.ipaymu.com - Development/Sandbox:
https://sandbox.ipaymu.com
⚠
Important Notes
- VA (Virtual Account) and API Key can be found in the Integration menu on your iPaymu dashboard. * VA and API Key for Sandbox/Development mode are different from those for Production/Live mode. * If you encounter integration issues, please contact support@ipaymu.com or via WhatsApp here.
Authentication
iPaymu API v2 uses Signature-based authentication. Every request must include the following headers:
| Header | Type | Example | Description |
|---|---|---|---|
va | string | YOUR_VA | Virtual Account number from the Integration menu in Production or Sandbox. Use the VA for the request environment. |
signature | string (64 hexadecimal characters) | GENERATED_SIGNATURE | HMAC-SHA256 value generated for this request using the API Key from Production or Sandbox. The API Key itself is not this header value. See Signature Generation. |
timestamp | string (14 digits) | 20260102153045 | Request time in YYYYMMDDHHmmss format (2 January 2026 at 15:30:45). Follow the endpoint guide if it requires ISO 8601. |
Sample Code
You can find official sample code in various languages here:
- PHP: ipaymu-payment-v2-sample-php
- NodeJS: ipaymu-payment-v2-sample-nodejs
- Python: ipaymu-payment-v2-sample-python
- Golang: ipaymu-payment-v2-sample-go
- Dotnet C#: ipaymu-payment-v2-sample-dotnet
- Ruby: ipaymu-payment-v2-sample-ruby
- Java: ipaymu-payment-v2-sample-java