API documentation
Create payment links, monitor transaction status and receive webhook notifications. Send your key in the X-API-Key header on every authenticated call.
{ success, code, message, data, meta }curl -X POST https://qriskuu.com/payments \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{"amount": 150000, "method": "gopay"}'Merchant
Payments
System
Guides
| Event | When it fires |
|---|---|
payment.paid | Payment settled successfully. |
payment.expired | Payment link expired unpaid. |
payment.canceled | Merchant or payer canceled it. |
payment.refunded | A refund was issued. |
Signature check
$raw = file_get_contents("php://input");
$signature = $_SERVER["HTTP_X_QRISKUU_SIGNATURE"] ?? "";
$expected = hash_hmac("sha256", $raw, getenv("QRISKUU_WEBHOOK_SECRET"));
if (!hash_equals($expected, $signature)) {
http_response_code(401);
exit;
}
$event = json_decode($raw, true);Failed deliveries are retried with backoff, and every attempt is recorded in the delivery log so you can inspect the exact HTTP response.
Error codes
- 400
Bad Request
Invalid payload, for example an amount outside 1–1,000,000,000 or QRIS not set up.
- 401
Unauthorized
X-API-Key header missing, empty, or not registered.
- 403
Forbidden
Email not verified. Verify via the link in your email before using the API.
- 404
Not Found
Route not found, or no transaction exists with that trxid.
- 429
Too Many Requests
Plan rate limit exceeded (Starter 100, Pro 500, Business 2000 requests per minute), or 5 auth attempts per minute.
- 500
Internal Server Error
An error occurred on the server.