Batalkan transaksi

POST

/transaction/cancel

Membatalkan transaksi yang masih pending.

Hanya transaksi pending yang dapat dibatalkan; status lain dibalas 422.
Di produksi, pembatalan hanya tersedia untuk sebagian transaksi QRIS. Kanal lain dibalas 422.
Transaksi sandbox dibatalkan secara lokal tanpa memanggil penyedia.

Status berubah menjadi cancelled. Webhook payment.status_updated tetap menjadi sumber status resmi.

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.

Request Body

application/json

body

trx_id*string

ID transaksi Paymenku (prefix IDP atau SBOX).

Response Body

Transaksi dibatalkan.

application/json

response

status?string

message?string

data?

Example Request

curl -X POST 'https://paymenku.com/api/v1/transaction/cancel' \
  -H 'Content-Type: application/json' \
  -d '{
  "trx_id": "IDP202610271005522956"
}'

Example Request

curl -X POST 'https://paymenku.com/api/v1/transaction/cancel' \  -H 'Content-Type: application/json' \  -d '{  "trx_id": "IDP202610271005522956"}'

Example ResponseSchema

{
  "status": "success",
  "message": "Transaction cancelled successfully",
  "data": {
    "trx_id": "IDP202610271005522956",
    "status": "cancelled"
  }
}

{  "status": "success",  "message": "Transaction cancelled successfully",  "data": {    "trx_id": "IDP202610271005522956",    "status": "cancelled"  }}

AuthorizationCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Request Body

Response Body