Search docs

Search the API documentation

GET

Get Payment

/v1/payments/:id

Retrieve the current state of a payment transaction. Requires the X-API-Key header.

Path Parameters

idstringrequired

Any of: the transaction ID, the payment link id or slug returned by Create Payment, your own merchantOrderId, or the Duitku reference.

Response

idstring

Transaction ID.

merchantOrderIdstring

Internal Artos order ID (e.g. PL-inv-xxxx).

clientMerchantOrderIdstring | null

Your merchantOrderId from Create Payment, or null if the payment was not created via the API.

referencestring

Payment provider (Duitku) reference.

duitkuReferencestring

Same as reference; kept for backward compatibility.

amountinteger

Payment amount in IDR.

paymentMethodstring

Payment method code (e.g. SP for QRIS).

statusstring

One of pending, paid, failed, expired. See Payment Status.

customerEmailstring | null

Customer email.

customerNamestring | null

Customer name.

productDetailsstring

Product description.

qrStringstring | null

QRIS payload, when applicable.

vaNumberstring | null

Virtual account number, when applicable.

paymentUrlstring | null

Payment URL.

feestring | null

Provider fee, if known.

paidAtstring | null

Time the payment was completed (ISO 8601).

expiredAtstring | null

Expiry time (ISO 8601).

createdAtstring

Creation time (ISO 8601).

updatedAtstring

Last update time (ISO 8601).

Examples

curl
curl https://api-artos.kasir.ai/v1/payments/ORDER-001 \
  -H "X-API-Key: art_live_your_api_key"
200 — Success
{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "merchantOrderId": "PL-inv-a1B2c3D4e5",
    "clientMerchantOrderId": "ORDER-001",
    "reference": "DS1234525ABCDEFGH",
    "duitkuReference": "DS1234525ABCDEFGH",
    "amount": 50000,
    "paymentMethod": "SP",
    "status": "paid",
    "customerEmail": "[email protected]",
    "customerName": "Budi Santoso",
    "productDetails": "Premium Plan",
    "qrString": "00020101021226...",
    "vaNumber": null,
    "paymentUrl": "https://artos.dev/pay/inv-a1B2c3D4e5",
    "fee": "1500",
    "paidAt": "2025-01-01T00:05:00.000Z",
    "expiredAt": "2025-01-01T01:00:00.000Z",
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-01-01T00:05:00.000Z"
  }
}
404 — Not found
{ "success": false, "error": "Transaction not found" }