REST API

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.

Base URL
All paths below are relative to this host.
Authentication
Generate and rotate keys in Settings, then Account.
Quick start
Create your first payment in one request.
curl -X POST https://qriskuu.com/payments \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"amount": 150000, "method": "gopay"}'
01

Merchant

2 endpoints
02

Payments

6 endpoints
03

System

1 endpoints
04

Guides

Verify webhook signatures
Register your endpoint in Settings, then Webhooks. Compare the signature header against an HMAC of the raw body before trusting a delivery.
EventWhen it fires
payment.paidPayment settled successfully.
payment.expiredPayment link expired unpaid.
payment.canceledMerchant or payer canceled it.
payment.refundedA 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.

05

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.