Kode Respons

Setiap layanan yang Anda gunakan akan menghasilkan atau memerlukan kode respons. Kode respons ini hanya berlaku untuk layanan yang tercantum dalam tabel Layanan.

Format Respons
Kode Respons Keterangan
responseCode
Format:
Kode HTTP + Kode Layanan + Kode Error / (200+24+00)

Contoh:
2002400
responseMessage
Deskripsi respons.
Kode Layanan
Nama Layanan Kode Layanan
Inquiry
24
Payment
25
Payment Host to Host
54
QRIS
47
Inquiry Status
26
Delete VA
31
Kode Respons
Kode HTTP Kode Layanan Kode Kasus Pesan Respons Deskripsi Cara Penanganan
200
any
00
Successful
Transaksi berhasil.
Tidak ada tindakan yang diperlukan.
400
any
01
Invalid / Missing Field Format {field name}
Format data pada field {field name} tidak sesuai.
Periksa kembali aturan format pada dokumentasi API dan sesuaikan nilai yang Anda kirim.
400
any
02
Invalid Mandatory Field {field name}
Beberapa parameter wajib (mandatory) belum diisi atau formatnya tidak sesuai.
Pastikan seluruh parameter mandatory sudah diisi dan mengikuti format yang benar.
401
any
00
Unauthorized. [reason]
Autentikasi gagal.
Periksa API Key, Client ID, Client Secret, Signature, atau URL API yang digunakan. Pastikan semua credential sesuai, masih aktif, dan proses generate signature sudah sesuai dengan format.
401
any
01
Invalid Token (B2B)
Token yang digunakan pada request tidak valid atau sudah tidak berlaku.
Generate Access Token yang baru dan pastikan token digunakan dengan benar di header Authorization.
401
any
02
Invalid Customer Token
Token customer tidak valid atau sudah kedaluwarsa.
Pastikan token customer didapatkan melalui proses login yang benar, masih aktif, dan digunakan sesuai peruntukannya.
401
any
03
Token Not Found (B2B)
Token tidak ditemukan di sistem.
Pastikan token yang digunakan valid, berasal dari proses generate resmi, sesuai environment (Sandbox / Production), dan belum expired.
404
any
00
Invalid Transaction Status
Status transaksi saat ini tidak sesuai untuk proses yang Anda lakukan.
Pastikan status transaksi sudah sesuai sebelum melakukan action.
404
any
01
Transaction Not Found
Transaksi tidak ditemukan.
Pastikan Order ID atau parameter yang digunakan sudah benar, berasal dari proses create transaksi, dan sesuai dengan API yang digunakan.
404
any
12
Invalid Bill / Virtual Account [Reason]
Nomor VA atau tagihan tidak ditemukan atau sedang diblokir.
Pastikan nomor VA atau nomor tagihan yang digunakan sudah benar, masih aktif, dan belum pernah dibayar.
404
any
13
Invalid Amount.
Jumlah pembayaran tidak sesuai.
Pastikan nominal amount yang digunakan sama persis dengan data tagihan yang valid dari proses inquiry.
404
any
14
Bill has been paid
Tagihan sudah dibayar sebelumnya.
Cek kembali status transaksi. Jika pembayaran sudah berhasil, tidak perlu melakukan pembayaran ulang.
404
any
19
Invalid Bill / Virtual Account
Tagihan atau Virtual Account yang digunakan sudah tidak aktif.
Buat ulang tagihan untuk melanjutkan pembayaran.
409
any
00
Conflict
Transaksi dengan X-EXTERNAL-ID yang sama sudah pernah diproses hari ini.
Gunakan X-EXTERNAL-ID berbeda untuk transaksi baru, atau lakukan pengecekan status transaksi sebelumnya.
409
any
01
Duplicate partnerReferenceNo
Transaksi dengan partnerReferenceNo yang sama sudah pernah diproses dan sukses.
Gunakan partnerReferenceNo berbeda untuk transaksi baru atau lakukan pengecekan status transaksi existing terlebih dahulu.
500
any
00
General Error
Terjadi kesalahan umum saat memproses transaksi.
Periksa kembali format request dan koneksi jaringan. Jika masih berulang, hubungi tim Espay untuk pengecekan lebih lanjut.
500
any
01
Internal Server Error
Terjadi kendala internal saat memproses transaksi.
Coba ulang proses beberapa saat lagi. Jika masih berulang, hubungi tim Espay untuk pengecekan lebih lanjut.
500
any
02
External Server Error
Terjadi gangguan sistem backend saat memproses transaksi.
Coba ulang proses beberapa saat lagi. Jika masih berulang, hubungi tim Espay untuk pengecekan lebih lanjut.
504
any
00
Timeout
Permintaan transaksi ke bank atau issuer membutuhkan waktu lebih lama dari biasanya.
Lakukan pengecekan status transaksi, atau ulangi proses jika diperlukan. Jika masih berulang, hubungi tim Espay untuk pengecekan lebih lanjut.
Kode HTTP Kode Layanan Kode Error Deskripsi Respons Keterangan
200
any
00
Successful
Successful
400
any
01
Duplicate referenceNo / paymentRequestId
Transaction has previously been processed indicates the same partnerReferenceNo already success.
400
any
02
Invalid mandatory field.
Missing or invalid format on mandatory field.
401
any
00
Unauthorized. [reason]
General unauthorized error (No Interface Def, API is Invalid, Oauth Failed, Verify Client Secret Fail, Client Forbidden Access API, Unknown Client, Key not Found)
401
any
01
Unknown Internal Server Failure, please retry the process again
Unknown Internal Server Failure, Please retry the process again.
401
any
01
Invalid token (B2B)
Token found in request is invalid (Access Token Not Exist, Access TokenExpiry).
404
any
12
Invalid Bill / Virtual Account.
The bill is blocked / suspended / not found.

Virtual account is suspend / not found.
404
any
13
Invalid Amount. The amount doesn’t match with what supposed to
The amount doesn't match with what supposed to.
404
any
14
Bill has been paid
The bill has been paid.
409
any
00
Conflict
Cannot use same X- EXTERNAL-ID in same day.
500
any
00
General Error
General Error.
500
any
01
Internal Server Error
Unknown Internal Server Failure, Please retry the process again.
500
any
02
External Server Error
Backend system failure, etc.
504
any
00
Timeout
Timeout from the issuer.
Scroll to Top