Menagih ulang pembeli yang tautannya kedaluwarsa: nomor Virtual Account lama yang masih bisa dibayar berjam-jam kemudian, pembatalan yang hanya diterima sebelum jamnya habis, dan slot jatah yang tidak pernah kembali

Menerbitkan ulang bukan memperpanjang. Tagihan pengganti adalah permintaan pembayaran yang benar-benar baru: id baru, kode QR atau nomor Virtual Account baru, dan penghitung waktu yang mulai dari nol. Tidak ada operasi yang menghidupkan kembali tautan yang sudah mati, dan masa berlaku hanya bisa ditentukan pada saat tagihan dibuat.

Yang membuat urutannya penting bukan itu, melainkan satu hal yang jarang disadari sampai uangnya datang dua kali: tagihan yang sudah kedaluwarsa masih bisa berubah menjadi berhasil, dan pada titik itu ia sudah tidak bisa lagi dibatalkan. Jadi keputusan yang sesungguhnya bukan cara menerbitkan ulang, melainkan kapan.

Urutannya lebih dulu, alasannya sesudah

1. Periksa status tagihan lamanya sebelum menyentuh apa pun. Yang menentukan langkah berikutnya hanya satu hal: masih pending, atau sudah expired.
2. Kalau masih menunggu dan nomornya sudah beredar di chat, batalkan lebih dulu, baru terbitkan penggantinya. Pembatalan menutup halaman pembayarannya dan, pada akun yang belum terverifikasi, mengembalikan slot jatahnya, tetapi tidak menarik kembali QR atau nomor yang sudah dipegang pembeli.
3. Kalau sudah kedaluwarsa, terbitkan penggantinya dan catat di sistem sendiri bahwa satu pesanan kini punya dua baris yang keduanya masih mungkin berakhir berhasil.
4. Kirim tautan penggantinya dengan satu kalimat yang meminta pembeli tidak membayar nomor lama. Tanpa kalimat itu, pembeli yang membuka chat dari atas akan membayar nomor yang pertama ditemukan.

Pintu yang hanya dimiliki tagihan kedaluwarsa

Status akhir biasanya berarti selesai. Ada pengecualian, dan pengecualian itulah yang membuat penagihan ulang berisiko: pembayaran yang sebenarnya sudah diterima sesaat sebelum penghitung berhenti, lalu konfirmasinya baru sampai setelahnya, tetap memindahkan tagihan dari expired menjadi succeeded. Uang menang atas jam, karena memberi tahu penjual bahwa dirinya tidak dibayar padahal uangnya sudah masuk adalah kesalahan yang jauh lebih mahal daripada menutup tagihan terlambat.

Satu hal lain memperpanjang jarak buta itu. Kasera Pay mengirim webhook payment.expired saat tagihan mati, tetapi endpoint yang dibuat sebelum pilihan event tersedia hanya menerima payment.paid sampai event itu dicentang di dashboard. Sistem penjual yang belum berlangganan hanya bisa mengetahuinya dari expires_at yang sudah dipegang sejak tagihan dibuat, dan yang sudah berlangganan tetap harus siap menerima payment.paid sesudahnya. Pemilihan masa berlakunya sendiri dibahas terpisah di tulisan tentang masa berlaku tagihan.

Membatalkan hanya bisa sebelum jamnya habis

Tagihan yang dibatalkan juga tidak sepenuhnya tertutup. Membatalkan hanya mengubah status di Kasera Pay. QR atau nomor Virtual Account yang sudah terbit tidak ikut ditarik, dan kalau pembeli tetap membayarnya, tagihan berpindah dari canceled menjadi succeeded, sama seperti konfirmasi terlambat pada tagihan kedaluwarsa. Jadi pembatalan bukan cara menghentikan pembeli yang memegang nomor lama. Yang menghentikannya adalah kalimat yang dikirim bersama tautan pengganti.

Masalahnya, pembatalan punya syarat waktu yang tidak bisa ditawar: hanya permintaan yang masih menunggu yang bisa dibatalkan. Permintaan pembatalan atas tagihan yang sudah kedaluwarsa dijawab 409 not_cancelable, dan itu bukan galat sementara yang perlu dicoba ulang. Konsekuensinya satu kalimat: manfaat membatalkan, yaitu halaman pembayaran yang tertutup dan slot jatah yang kembali, hanya tersedia sebelum tagihannya kedaluwarsa, tidak pernah sesudahnya. Perbandingan lengkap kedua jalur mengakhiri tagihan ada di tulisan tentang membatalkan tagihan.

Dari situ turun aturan praktis. Penjual yang tahu pembeli sudah tidak akan membayar sebaiknya membatalkan lebih awal alih-alih menunggu jam enam puluh menit berjalan sampai habis. Kalau ternyata pembeli tetap membayar nomor lama, uangnya tercatat berhasil dan diselesaikan seperti pembayaran ganda: pesanan dikirim sekali, kelebihannya dikembalikan.

Satu pesanan, dua baris, dan pembukuan yang tetap masuk akal

Setelah penerbitan ulang, satu pesanan diwakili dua permintaan pembayaran. Keduanya nyata, keduanya punya id sendiri, dan keduanya muncul di daftar transaksi. external_id dan merchant_ref membantu mencocokkan keduanya ke pesanan yang sama, tetapi keduanya label: label tidak menjamin keunikan dan tidak pernah menggabungkan dua permintaan menjadi satu pembayaran. Kebiasaan penamaan yang menyelamatkan rekonsiliasi adalah menuliskan percobaannya, misalnya ORD-1042-2 untuk penerbitan kedua, sehingga dua baris yang berdekatan bisa dibaca tanpa membuka keduanya.

Kalau keduanya benar-benar berakhir succeeded, yang terjadi bukan kesalahan sistem melainkan pembeli yang membayar dua kali, dan penyelesaiannya keputusan manusia: mengembalikan salah satunya atau menyimpannya sebagai saldo untuk pesanan berikutnya. Bentuk kejadiannya dibahas di tulisan tentang pembayaran yang masuk dua kali.

Kunci idempotency wajib baru, justru supaya tidak berlipat

Header Idempotency-Key adalah satu-satunya hal yang membuat dua permintaan create dianggap satu pembayaran, dan kuncinya disimpan permanen. Mengirim penerbitan ulang dengan kunci lama dan isi yang sama tidak menghasilkan tagihan baru: yang dijawab adalah tagihan lama yang statusnya sudah kedaluwarsa, sehingga yang sampai ke pembeli adalah tautan yang langsung mati. Karena itu kunci penerbitan ulang wajib baru, dan bentuk yang aman adalah menurunkannya dari percobaan penerbitan, bukan dari nomor pesanan. Pembahasan kuncinya, termasuk bentuk yang justru membuka celah tagihan ganda, ada di tulisan tentang Idempotency-Key.

Jatah sebelum verifikasi: satu slot hangus, satu bagian kembali

Pada akun yang verifikasinya belum selesai, penerbitan ulang punya harga yang tidak terlihat di mana pun pada layar penjualan. Jatah sebelum verifikasi berlaku seumur akun dan tidak pernah reset, dan dua komponennya berperilaku berlawanan atas tagihan yang sama:

• Jumlah permintaan, bawaan 10. Yang dihitung adalah setiap permintaan yang pernah dibuat kecuali yang canceled. Yang kedaluwarsa dan yang gagal tetap dihitung. Satu tagihan yang dibiarkan mati lalu diterbitkan ulang berarti dua slot terpakai untuk satu pesanan, dan slot yang pertama tidak pernah kembali. Melewatinya dijawab 429 unverified_count_cap.
• Total nominal, bawaan Rp 1.000.000. Yang dihitung hanya uang yang diterima atau masih mungkin diterima. Tagihan yang kedaluwarsa, gagal, atau dibatalkan melepaskan kembali bagiannya, jadi nominal tagihan mati tidak menumpuk. Melewatinya dijawab 429 unverified_amount_cap.

Gabungan keduanya memberi alasan yang bisa dihitung untuk membatalkan lebih awal: pada akun baru, membatalkan sebelum jamnya habis adalah satu-satunya cara mengembalikan slot jumlahnya. Sepuluh slot habis lebih cepat dari dugaan siapa pun yang menagih ulang dua atau tiga kali per pembeli. Angka dan semantik penghitungannya ada di referensi batas API.

Kapan berhenti menerbitkan ulang

Pembeli yang sama melewatkan tenggat dua kali bukan pembeli yang lalai, melainkan tanda bahwa bentuk tagihannya salah untuk cara jualannya. Dua jalan keluar menghapus siklus penagihan ulang alih-alih mempercepatnya.

Yang pertama, meminta masa berlaku yang lebih panjang saat tagihan dibuat. Bawaannya 60 menit dan plafonnya 24 jam, dan angka yang lebih panjang masuk akal persis pada kasus yang paling sering kedaluwarsa: nomor Virtual Account yang dibayar di mesin ATM atau esok paginya, bukan saat itu juga.

Yang kedua, berhenti memakai tautan yang punya tenggat. Pada halaman pembayaran yang dipakai berulang, penghitung waktu baru mulai berjalan ketika pembeli menekan bayar, bukan ketika penjual membuat tagihannya, sehingga kedaluwarsa sebelum dibaca tidak lagi mungkin. Cara menyiapkannya ada di panduan halaman pembayaran yang dipakai berulang. Yang hilang darinya adalah nominal yang dikunci per pesanan, jadi ini pertukaran, bukan peningkatan.

Ringkasnya

• Menerbitkan ulang selalu berarti tagihan baru dengan id, nomor, dan jam sendiri.
• Tagihan kedaluwarsa masih bisa menjadi berhasil karena konfirmasi terlambat; tagihan yang dibatalkan juga bisa, karena QR atau nomor yang sudah terbit tetap bisa dibayar, dan membatalkan hanya diterima selama status masih pending.
• Penerbitan ulang wajib memakai Idempotency-Key baru, diturunkan dari percobaannya.
• Pada akun belum terverifikasi, tagihan kedaluwarsa menghabiskan satu slot selamanya sementara bagian nominalnya kembali.
• Dua kali kedaluwarsa pada pembeli yang sama berarti bentuk tagihannya yang diganti.

Pertanyaan yang sering muncul