Penanganan Eror
Kesalahan Umum dalam Payout
Di bawah ini adalah daftar kesalahan umum yang mungkin Anda temui saat menggunakan API Pembayaran kami. Untuk pemahaman sederhana, kami telah membaginya menjadi 2 kategori:
- Kesalahan dalam membuat pembayaran
- Kesalahan dalam mengeksekusi pembayaran
Kesalahan Dalam Membuat Pembayaran
Jika Anda menerima kesalahan dalam respons API kami, ini berarti ada masalah saat membuat pembayaran karena input yang tidak valid atau masalah dengan server.
| Error Code | Explanation |
|---|---|
| API_VALIDATION_ERROR INVALID_JSON_FORMAT CHANNEL_CODE_NOT_SUPPORTED_ERROR RECIPIENT_ACCOUNT_NUMBER_ERROR | Beberapa input tertentu tidak memenuhi persyaratan API kami |
| RECIPIENT_AMOUNT_ERROR MAXIMUM_TRANSFER_LIMIT_ERROR | Setiap saluran memiliki jumlah transaksi minimum dan maksimum. Kami akan mengembalikan respons kesalahan jika jumlah transfer yang diminta tidak sesuai dengan batasan yang ditentukan. Lihat Batas Pencairan |
| DUPLICATE_TRANSACTION_ERROR | Kunci idempotensi telah digunakan sebelumnya. Gunakan kunci idempotensi unik dan coba lagi. Pelajari lebih lanjut di sini |
| REQUEST_FORBIDDEN_ERROR | Kunci API yang digunakan tidak memiliki izin yang diperlukan untuk melakukan permintaan. Harap tetapkan izin yang tepat untuk kunci tersebut. Pelajari lebih lanjut di sini |
| SERVER_ERROR | Terjadi kesalahan saat menyambung ke server kami saat Anda mencoba membuat permintaan pembayaran. Jika Anda menggunakan kunci idempotensi dalam permintaan asli, Anda dapat mencoba lagi ini dengan aman menggunakan kunci idempotensi yang sama. Jika tidak, harap periksa apakah pencairan telah dibuat di sistem kami sebelum memutuskan apakah akan mencoba lagi. Anda dapat melakukannya dengan memeriksa pencairan di Dashboard Anda atau melalui Get disbursement by external_id API. Jika pencairan belum dibuat, silakan coba lagi permintaan pencairan dalam 1-2 jam. |
Kesalahan Dalam Melakukan Pembayaran
Jika Anda menerima pembayaran yang gagal dalam panggilan balik, ini berarti kami mencoba memproses pembayaran dan gagal. Kami mengembalikan kode kegagalan dalam panggilan balik kami di mana pembayaran gagal karena alasan apa pun. Penting bagi Anda untuk memahami setiap kode kegagalan secara mendetail untuk memutuskan tindakan yang tepat untuk diambil. Di bawah ini adalah daftar lengkap kemungkinan kode kegagalan yang mungkin Anda terima, artinya dan tindakan yang kami sarankan terkait.
| Error Message | Deskripsi | Haruskah anda mencoba lagi? |
|---|---|---|
| INSUFFICIENT_BALANCE | Klien memiliki saldo yang tidak mencukupi untuk jumlah pembayaran. | Ya, coba lagi pembayaran setelah memastikan bahwa Anda memiliki saldo yang cukup di akun Anda. |
| INVALID_DESTINATION | Akun tujuan tidak ada/tidak valid. | Anda tidak mungkin berhasil jika mencoba kembali permintaan pembayaran. Harap konfirmasi dengan penerima apakah akun tujuan benar |
| REJECTED_BY_CHANNEL | Pembayaran gagal karena kesalahan dari saluran tujuan. Ini biasanya karena masalah jaringan yang terkait dengan bank tujuan atau masalah pengkreditan dana ke rekening bank tujuan | Ya, coba lagi pembayaran setelah memvalidasi bahwa nomor rekening bank tujuan aktif dan dapat menerima dana dalam mata uang pilihan Anda. |
| TEMPORARY_TRANSFER_ERROR | Jaringan saluran mengalami kesalahan sementara. Coba lagi pembayaran dalam 1-3 jam. | Ya, coba lagi pembayaran dalam 1-3 jam. |
| TRANSFER_ERROR | Kami mengalami kesalahan fatal saat memproses pembayaran ini. Biasanya, ini berarti bahwa bidang API tertentu dalam permintaan Anda tidak valid. | Tidak mungkin permintaan pencairan yang sama akan berhasil jika Anda mencoba lagi. |
| UNKNOWN_BANK_NETWORK_ERROR | Bank telah menyampaikan kesalahan yang belum mereka dokumentasikan. Menurut definisi, ini berarti bank tidak mengetahui masalah tersebut. | Sayangnya, kami tidak dapat memprediksi apakah pencairan akan berhasil jika Anda mencoba lagi permintaan pencairan yang sama.Namun Anda dapat memilih untuk mencoba kembali permintaan pencairan yang sama setidaknya satu jam setelah menerima panggilan balik kami atas kebijakan Anda sendiri. |
Last Updated on 2023-06-30