KiPaydocs
Dokumentasi/API Reference

API REFERENCE

Simulasikan pembayaran sandbox

Mengubah transaksi sandbox dari pending menjadi paid tanpa pembayaran nyata.

API CONSOLE

Kirim request langsung dan baca response dengan jelas

Masukkan API key sandbox, periksa parameter, lalu jalankan endpoint dari halaman ini. Credential hanya diteruskan untuk request tersebut dan tidak disimpan.

POSThttps://api.kipay.biz.id/api/pay/{apiKey}/transactions/SBX-20260825-VG57V5/simulate
Simulasikan pembayaran sandbox
Contoh response
RequestSandbox
Authentication

API key diteruskan satu kali melalui server KiPay dan tidak disimpan oleh konsol.

Headers
Acceptapplication/jsonContent-Typeapplication/json
Path parameters
Request body
Responseapplication/json
CONTOHPreview bodyBelum dikirim
1{2  "trx_id": "SBX-20260825-VG57V5",3  "mode": "sandbox",4  "amount": 285215,5  "status": "paid",6  "provider": "shopeepay",7  "matched_at": "2026-08-26 06:35:14"8}
Contoh kode
curl --request POST \
  --url https://api.kipay.biz.id/api/pay/$KIPAY_API_KEY/transactions/SBX-20260825-VG57V5/simulate \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"provider":"shopeepay"}'
PERBANDINGAN ENVIRONMENTKontrak sama, sumber konfirmasi berbeda.
Perbandingan sandbox dan productionSandbox dan production memakai struktur request, resource transaksi, renderer QR, dan webhook handler yang sama. Hanya sandbox yang memiliki endpoint simulate. Production menerima konfirmasi dari jaringan QRIS.SANDBOXPRODUCTIONkonfirmasi terkendalikonfirmasi jaringan nyatastruktur requestkontrak samafield transaksikontrak samarender QRkontrak samawebhook handlerkontrak samaPOST /simulate mengubah statusjaringan QRIS mengubah status
01

Request

POST/api/pay/{apiKey}/transactions/{trxId}/simulate
FieldTipeWajibNilai
providerstringTidakshopeepay atau gopay
request.sh
cURL
curl --request POST \
  --url https://api.kipay.biz.id/api/pay/apg_your_project_key/transactions/SBX-20260825-VG57V5/simulate \
  --header "Content-Type: application/json" \
  --data '{ "provider": "shopeepay" }'
02

200 OK

response.json
JSON
{
  "trx_id": "SBX-20260825-VG57V5",
  "mode": "sandbox",
  "requested_amount": 285000,
  "unique_code": 215,
  "amount": 285215,
  "fee_amount": 2925,
  "fee_bearer": "merchant",
  "status": "paid",
  "provider": "shopeepay",
  "note": "order_nusa_2048",
  "qr_payload": "0002010102122661...",
  "qr_url": "https://api.kipay.biz.id/api/pay/apg_your_project_key/transactions/SBX-20260825-VG57V5/qr.png",
  "matched_at": "2026-08-26 06:35:14",
  "created_at": "2026-08-26 06:35:08",
  "expires_at": "2026-08-26 06:50:08"
}
03

Error

StatusKondisi
400Project production, transaksi tidak berstatus pending, atau transaksi tidak ditemukan
404Project tidak ditemukan
Khusus sandbox

Production selalu menolak endpoint ini. Jangan masukkan simulasi ke workflow production.