Cek status transaksi

GET

/check-status/{order_id}

Mencari satu transaksi berdasarkan trx_id atau reference_id — keduanya diterima pada parameter yang sama.

Gunakan ini untuk rekonsiliasi, bukan sebagai pengganti webhook. Status resmi tetap datang lewat webhook.

Authorization

bearerAuth

headerAuthorizationBearer <token>

Kirim kunci API sebagai bearer token pada header Authorization, dengan format Bearer YOUR_APIKEY.

Ada dua jenis kunci:

sk_live_ — produksi. Transaksi nyata, dan butuh KYC yang sudah disetujui.
sk_test_ — sandbox. Tanpa perpindahan dana, tanpa syarat KYC.

Ambil kunci di Dashboard Merchant, menu Settings lalu API Keys.

Kunci API adalah kredensial rahasia: simpan di environment variable atau secret manager. Jangan pernah menaruhnya di frontend, aplikasi mobile, atau repositori publik.

Path Parameters

order_id*string

trx_id Paymenku atau reference_id milik Anda.

Response Body

Detail transaksi.

application/json

response

status?string

data?

Example Request

curl -X GET 'https://paymenku.com/api/v1/check-status/SBOX202610270912228342'

Example Request

curl -X GET 'https://paymenku.com/api/v1/check-status/SBOX202610270912228342'

Example ResponseSchema

{
  "status": "success",
  "data": {
    "trx_id": "SBOX202610270912228342",
    "reference_id": "INV-20261027-001",
    "amount": "15305.00",
    "total_fee": "305.00",
    "amount_received": "15000.00",
    "status": "pending",
    "is_sandbox": true,
    "customer_name": "Uji Dokumentasi",
    "customer_email": "uji@example.com",
    "customer_phone": null,
    "order_items": [
      {
        "name": "Item Uji",
        "quantity": 1
      }
    ],
    "payment_channel": {
      "code": "qris",
      "name": "QRIS",
      "type": "qris"
    },
    "pay_url": "https://paymenku.com/pay/SBOX202610270912228342",
    "paid_at": null,
    "created_at": "2026-10-27T09:12:04+07:00",
    "updated_at": "2026-10-27T09:12:05+07:00"
  }
}

{  "status": "success",  "data": {    "trx_id": "SBOX202610270912228342",    "reference_id": "INV-20261027-001",    "amount": "15305.00",    "total_fee": "305.00",    "amount_received": "15000.00",    "status": "pending",    "is_sandbox": true,    "customer_name": "Uji Dokumentasi",    "customer_email": "uji@example.com",    "customer_phone": null,    "order_items": [      {        "name": "Item Uji",        "quantity": 1      }    ],    "payment_channel": {      "code": "qris",      "name": "QRIS",      "type": "qris"    },    "pay_url": "https://paymenku.com/pay/SBOX202610270912228342",    "paid_at": null,    "created_at": "2026-10-27T09:12:04+07:00",    "updated_at": "2026-10-27T09:12:05+07:00"  }}

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Path Parameters

Response Body