Langkah demi langkah membaca log API PAYWISE untuk mencari masalah
Setiap request dengan API key Anda tercatat. Pelajari arti setiap kolom, arti kode status, dan cara menemukan penyebab request yang gagal.
Terbit 04 Oktober 2026 2 menit baca
Saat pembayaran tidak muncul, atau integrasi Anda tiba-tiba mengembalikan error, halaman Log API di dashboard adalah tempat pertama untuk dicek. Setiap request dengan API key Anda tercatat di sana.
Langkah 1: Buka log
Buka Log API di bagian Developer pada dashboard. Setiap baris adalah satu request, yang terbaru di atas, dengan enam kolom:
- Method dan Endpoint: apa yang dipanggil, misalnya
POST /api/v1/transactions. - Status: status HTTP yang dijawab PAYWISE, diberi warna sesuai jenisnya.
- Waktu respons: berapa lama PAYWISE menjawab.
- Request ID:
X-Request-Iddari respons tersebut. - Waktu: kapan request terjadi (WIB).
Log disimpan selama 60 hari.
Langkah 2: Baca kode status
- 2xx: berhasil.
201berarti pembayaran baru dibuat.200saat membuat pembayaran berarti Anda mengirimmerchant_referenceyang sudah ada dengan jumlah dan metode yang sama, sehingga pembayaran lama yang dikembalikan. - 4xx: ada yang harus diubah di request. Mengulang request yang sama tidak akan membantu.
- 5xx: provider pembayaran sedang bermasalah. Jarang terjadi, dan transaksinya ditandai gagal sehingga Anda bisa membuat yang baru.
Langkah 3: Cocokkan kode error
Body respons selalu berisi error.code. Yang paling sering:
| Status | Kode | Yang perlu dilakukan |
|---|---|---|
| 401 | INVALID_API_KEY |
Cek key dan header Authorization: Bearer |
| 401 | API_KEY_REVOKED |
Buat key baru; key ini sudah dicabut |
| 403 | IP_NOT_ALLOWED |
Tambahkan IP server Anda ke daftar IP key tersebut |
| 409 | DUPLICATE_REFERENCE |
merchant_reference sama dengan jumlah atau metode berbeda: pakai nomor baru |
| 422 | VALIDATION_ERROR |
Ada field yang kosong atau salah, misalnya customer_id atau amount |
| 429 | RATE_LIMITED |
Lebih dari 60 request per menit pada satu key: perlambat lalu ulangi |
| 502 / 504 | PROVIDER_ERROR / PROVIDER_TIMEOUT |
Provider menolak atau tidak menjawab: buat pembayaran baru |
Daftar lengkapnya ada di dokumentasi API.
Langkah 4: Lihat waktu respons
Sebagian besar request dijawab dengan cepat. Request pembuatan yang memakan beberapa detik biasanya berarti provider pembayaran sedang lambat. Jika banyak request lambat di waktu yang sama, cek halaman status.
Langkah 5: Gunakan request ID
Simpan header X-Request-Id di sistem Anda untuk setiap panggilan. Saat menghubungi support, kirimkan ID tersebut: ID itu menunjuk ke request yang persis, sehingga masalah bisa ditemukan dalam hitungan menit, bukan jam.
Tips
- Request sandbox dan live sama-sama tercatat, jadi Anda bisa mencari masalah sebelum live.
- Tidak ada baris sama sekali untuk sebuah request? Request itu tidak pernah sampai ke PAYWISE: cek jaringan, DNS, atau firewall server Anda.
- Masalah webhook ada di halaman lain: lihat Webhook untuk setiap percobaan pengiriman dan hasilnya.
