API Documentation

Authentication

Semua request API memerlukan API Key yang dikirim via header X-API-Key.

Convert QRIS

POST /api/v1/convert

Headers

Header	Required	Description
X-API-Key	Yes	Your API key
Content-Type	Yes	`application/json`

Request Body

{
  "qris_string": "000201010211...",
  "amount": 50000,
  "fee": 0,
  "expires_minutes": 15
}

Field	Required	Description
qris_string	Yes	QRIS EMV string dari QR statis
amount	Yes	Nominal dalam Rupiah (integer)
fee	No	Biaya tambahan (opsional)
expires_minutes	No	Masa berlaku QR (default: 15 menit)

Success Response (200)

{
  "success": true,
  "data": {
    "qris_string": "000201010211...540550000...6304ABCD",
    "qris_image": "data:image/png;base64,iVBOR...",
    "amount": 50000,
    "expires_at": "2026-07-06T14:30:00Z"
  }
}

Error Responses

Status	Error Message	Skenario
400	invalid_qris_format	QRIS string tidak valid
400	invalid_amount	Amount <= 0
401	unauthorized	API key tidak valid
429	quota_exceeded	Quota harian habis
500	internal_error	Server error