Penanganan error API booking engine: tiga kegagalan yang memakan biaya

Tiket dukungan masuk pada Kamis malam. Pelanggan sudah membayar, halaman berputar, lalu menampilkan error umum. Kartunya terdebit. Log Anda menunjukkan POST ke supplier yang tidak pernah mendapat respons. Apakah maskapai menahan kursi? Tidak ada yang bisa memastikan, dan pelanggan menunggu. Penanganan error API booking engine yang baik sebagian besar adalah pekerjaan agar Anda tidak pernah berada di posisi itu, atau setidaknya tahu persis apa yang harus dilakukan saat terjadi.
Kebanyakan panduan integrasi memperlakukan error sebagai katalog kode status. Dalam booking, kode status adalah bagian yang mudah. Yang memakan biaya adalah segelintir situasi di mana request tampak gagal padahal dunia nyata berubah, atau tampak berhasil padahal dunia nyata tidak berubah. Tiga di antaranya lebih penting daripada sisanya.
Kegagalan pertama: harga bergeser antara pencarian dan booking
Hasil pencarian adalah penawaran, bukan kontrak. Tarif di-cache, inventori dipakai bersama oleh semua kanal yang dijual supplier, dan angka yang Anda tampilkan pukul 14.02 bisa basi beberapa menit kemudian. Supplier memberi tahu Anda pada langkah create-booking, kadang dengan respons bersih "fare changed", kadang dengan diam-diam mengembalikan total berbeda di dalam respons yang tampak sukses.
Jenis kedua yang berbahaya. Jika kode Anda membaca konfirmasi, menyimpan booking, lalu menagih pelanggan sebesar yang ia lihat, selisihnya keluar dari margin Anda, atau nanti dari ADM. Jadi aturannya sederhana: bandingkan total yang dikonfirmasi supplier dengan total yang disetujui pelanggan, setiap kali, di dalam kode, sebelum Anda menangkap pembayaran.
Apa yang dilakukan saat berbeda bergantung pada besar selisih dan siapa yang menanggungnya. Pembulatan beberapa sen antar mata uang adalah toleransi yang Anda atur sekali. Apa pun yang lebih besar kembali ke pelanggan sebagai harga baru dengan tombol setuju yang eksplisit. Jangan pernah menyerapnya otomatis, dan jangan pernah menagihnya otomatis.
Kegagalan kedua: sudah di-booking, tapi belum diterbitkan tiketnya
Adanya PNR tidak sama dengan adanya tiket. Banyak alur membuat reservasi lebih dulu dan menerbitkan e-ticket sebagai langkah terpisah, dengan batas waktu di antaranya. Jika pembayaran berhasil dan penerbitan gagal, Anda memegang uang pelanggan dan reservasi yang akan kedaluwarsa menurut jamnya sendiri.
Kegagalan ini jarang berisik. Panggilan issue mengembalikan error atau timeout, dan booking berada di status yang di database Anda berlabel "paid" sementara supplier masih menyebut "held". Sementara itu batas waktu ticketing berjalan, dan tidak seperti antrean dukungan Anda, maskapai tidak menunggu.
Tangani sebagai status tersendiri, bukan varian dari sukses atau gagal. Booking membutuhkan setidaknya status ini: created, held, payment captured, issuing, ticketed, failed-and-refundable. "Payment captured, issuing" adalah status yang butuh timer: ketika booking terlalu lama di sana, sebuah job harus membaca ulang reservasi dari supplier dan memutuskan, bukan menunggu manusia menyadarinya. Keputusannya murah bila Anda tahu batas waktu supplier, karena itu memberi tahu seberapa lama retry aman sebelum Anda harus me-refund.
Kegagalan ketiga: timeout dengan hasil yang tidak diketahui
Inilah tiket Kamis malam tadi. Request Anda berangkat, respons tidak kembali, koneksi putus atau gateway menyerah. Supplier mungkin sudah memprosesnya sepenuhnya, sebagian, atau sama sekali tidak.
Godaannya adalah retry. Jangan retry panggilan create-booking secara buta, karena percobaan kedua bisa menghasilkan reservasi kedua, dan duplikat adalah biaya nyata: dua kursi tertahan, mungkin dua tiket terbit, dan sengketa refund pada salah satunya.
Urutan yang aman: berhenti, baca, lalu putuskan. Hentikan alur di sisi pelanggan dengan status jujur "kami sedang mengonfirmasi booking Anda". Baca sisi supplier dengan mencari booking memakai referensi yang Anda buat sebelum panggilan (itulah alasan Anda membuat referensi klien sendiri lebih dulu dan mengirimkannya jika supplier menerimanya). Baru kemudian putuskan: ditemukan berarti lanjut dari status sebenarnya; tidak ditemukan setelah jendela pemrosesan supplier berarti aman untuk retry satu kali.
Jika supplier tidak memberi cara mencari berdasarkan referensi Anda, cari berdasarkan nama penumpang, rute, dan tanggal dalam jendela sempit, dan anggap kecocokan sebagai ditemukan. Jelek, tetapi jauh lebih murah daripada duplikat.
Tabel keputusan yang boleh Anda bantah
| Yang Anda lihat | Yang Anda tahu | Yang dilakukan | Yang tidak dilakukan |
|---|---|---|---|
| Supplier mengembalikan "fare changed" | Belum ada yang di-booking | Tampilkan total baru, minta persetujuan, jalankan ulang create | Jalankan ulang dengan harga lama dan berharap lolos |
| Sukses, tetapi total berbeda dari yang disetujui pelanggan | Booking ada dengan harga baru | Tahan pembayaran, tanyakan pelanggan, void booking jika menolak | Tagih jumlah lama dan tanggung selisihnya |
| Pembayaran tertangkap, panggilan issue error | PNR ada, status tiket tak diketahui | Baca ulang reservasi, retry issue dalam batas waktu, refund setelahnya | Tandai booking gagal dan lupakan PNR |
| Timeout pada create | Hasil tak diketahui | Cari dengan referensi Anda, lalu lanjut atau retry satu kali | Retry buta seketika |
| Timeout pada cancel | Anda mungkin masih bertanggung jawab atas segmen | Baca ulang status sebelum memberi tahu pelanggan apa pun | Menampilkan "cancelled" karena tombol sudah diklik |
Satu baris yang mungkin Anda bantah: sebagian tim me-refund pada error issuance pertama agar pelanggan tenang. Itu bisa dibela untuk tiket murah dan kebiasaan buruk untuk tiket mahal, sebab Anda bisa kehilangan tarif yang semenit kemudian masih bisa diselamatkan.
Berapa harganya bila salah
Setiap kegagalan punya tagihan berbeda. Perubahan harga yang terlewat adalah margin hilang pada setiap booking yang terkena, sering tak terlihat sampai rekonsiliasi. Booked-not-ticketed adalah pelanggan yang tiba di bandara dengan reservasi yang sudah lapse dan tagihan di kartunya, yaitu chargeback sekaligus masalah reputasi. Retry buta saat timeout adalah reservasi ganda, dan maskapai mengaudit duplikat; pola kasus seperti itu adalah jenis hal yang berujung ADM.
Tidak satu pun ini eksotis. Ini pekerjaan perpipaan yang tidak glamor, yang membedakan demo dari sesuatu yang bisa Anda tinggal berjalan selama akhir pekan.
Bangun job rekonsiliasi sebelum Anda membutuhkannya
Ketiga kegagalan berakhir sama: database Anda dan database supplier tidak sepakat. Maka tulis job yang membandingkannya sebelum insiden pertama, bukan sesudahnya. Jalan malam hari adalah minimum; setiap beberapa menit untuk apa pun di status transisi lebih baik. Job itu mendaftar booking yang tersangkut di held, issuing, atau unknown, bertanya kepada supplier, lalu memperbaiki catatan atau membuka tiket dengan bukti terlampir.
Simpan setiap request dan respons untuk panggilan booking, termasuk timeout, bersama referensi yang Anda kirim. Saat pelanggan menyengketakan tagihan, log itu adalah argumen Anda. Ia juga menjaga diskusi latensi tetap jujur: lihat apa yang bisa dan tidak bisa Anda perbaiki dari latensi API untuk memahami mengapa timeout adalah fakta hidup, bukan bug yang bisa dihapus.
Jika Anda masih memutuskan cara menyambungkan koneksi supplier itu sendiri, panduan di integrasi API booking penerbangan membahas urutan panggilan yang diasumsikan artikel ini. Dan jika ingin membahas bagaimana status-status ini dipetakan ke API penerbangan dan hotel kami, aksesnya dimulai dengan percakapan: lihat halaman API travel.