Error Codes

semua error code yang mungkin dikembalikan Qrisy API.

Error Response Format

{
  "status": 404,
  "error": {
    "code": "TRANSACTION_NOT_FOUND",
    "message": "Transaction not found",
    "details": null
  }
}

Code Reference

Code	HTTP Status	Description
`INVALID_CREDENTIALS`	401	Email atau password salah
`TOKEN_INVALID`	401	JWT atau API key tidak valid
`TOKEN_EXPIRED`	401	Access token expired — refresh diperlukan
`ACCOUNT_DISABLED`	403	Akun dinonaktifkan
`EMAIL_ALREADY_USED`	409	Email sudah terdaftar
`API_KEY_REVOKED`	401	API key sudah di-revoke
`API_KEY_SCOPE_INSUFFICIENT`	403	API key tidak punya scope yang diperlukan
`QRIS_INVALID_FORMAT`	400	QRIS string tidak valid
`QRIS_DUPLICATE`	409	QRIS string sudah ada
`QRIS_MERCHANT_NOT_FOUND`	404	QRIS merchant tidak ditemukan
`TRANSACTION_NOT_FOUND`	404	Transaksi tidak ditemukan
`TRANSACTION_NOT_CANCELABLE`	409	Transaksi tidak dalam status pending
`TOO_MANY_PENDING_TRANSACTIONS`	429	Limit concurrent pending tercapai
`FREE_TIER_EXHAUSTED`	403	Free tier limit tercapai
`WEBHOOK_SIGNATURE_INVALID`	401	Webhook signature tidak valid
`WEBHOOK_ENDPOINT_NOT_FOUND`	404	Webhook endpoint tidak ditemukan
`WEBHOOK_EVENT_NOT_FOUND`	404	Webhook event tidak ditemukan
`PAYMENT_PAGE_NOT_FOUND`	404	Payment page tidak ditemukan
`VALIDATION_ERROR`	422	Request body/query tidak valid (Zod)
`RATE_LIMITED`	429	Rate limit exceeded
`INTERNAL_ERROR`	500	Internal server error

Handling Errors

Node.js

import { QrisyError } from '@qrisy/node';

try {
  await qrisy.checkStatus('txn_missing');
} catch (err) {
  if (err instanceof QrisyError) {
    console.log(err.code);   // TRANSACTION_NOT_FOUND
    console.log(err.status); // 404
    console.log(err.message);// Transaction not found
  }
}

Python

from qrisy import QrisyError

try:
    qrisy.check_status("txn_missing")
except QrisyError as e:
    print(e.code)    # TRANSACTION_NOT_FOUND
    print(e.status)  # 404
    print(e.message) # Transaction not found

PHP

use Qrisy\Exception\QrisyException;

try {
    $qrisy->checkStatus('txn_missing');
} catch (QrisyException $e) {
    echo $e->errorCode; // TRANSACTION_NOT_FOUND
    echo $e->getCode(); // 404
    echo $e->getMessage(); // Transaction not found
}