การจัดการข้อผิดพลาด API ระบบจอง: สามความล้มเหลวที่ทำให้เสียเงิน

ตั๋วซัพพอร์ตเข้ามาในเย็นวันพฤหัสบดี ลูกค้าจ่ายเงินแล้ว หน้าจอหมุนอยู่พักหนึ่ง แล้วแสดงข้อผิดพลาดทั่วไป บัตรถูกตัดเงินไปแล้ว ล็อกของคุณแสดง POST ไปยังซัพพลายเออร์ที่ไม่เคยได้รับคำตอบกลับ สายการบินกันที่นั่งไว้หรือเปล่า ไม่มีใครตอบได้ และลูกค้ากำลังรออยู่ การจัดการข้อผิดพลาด API ระบบจองที่ดีส่วนใหญ่คืองานที่ทำให้คุณไม่ต้องไปอยู่ในจุดนั้น หรืออย่างน้อยก็รู้แน่ชัดว่าต้องทำอะไรเมื่อไปอยู่ในจุดนั้นแล้ว
คู่มือการเชื่อมต่อส่วนใหญ่มองข้อผิดพลาดเป็นแค็ตตาล็อกของรหัสสถานะ ในงานจอง รหัสสถานะเป็นส่วนที่ง่าย สิ่งที่ทำให้เสียเงินคือสถานการณ์จำนวนน้อยที่คำขอดูเหมือนล้มเหลวแต่โลกจริงเปลี่ยนไปแล้ว หรือดูเหมือนสำเร็จแต่โลกจริงไม่ได้เปลี่ยน สามกรณีต่อไปนี้สำคัญกว่ากรณีอื่น
ความล้มเหลวที่หนึ่ง: ราคาขยับระหว่างค้นหากับจอง
ผลการค้นหาคือใบเสนอราคา ไม่ใช่สัญญา ค่าโดยสารถูกแคช สต็อกที่นั่งถูกใช้ร่วมกันทุกช่องทางที่ซัพพลายเออร์ขาย และตัวเลขที่คุณแสดงตอน 14:02 อาจล้าสมัยภายในไม่กี่นาที ซัพพลายเออร์จะบอกคุณในขั้นตอน create-booking บางครั้งด้วยการตอบ "fare changed" อย่างชัดเจน บางครั้งด้วยการส่งยอดรวมที่ต่างออกไปกลับมาเงียบ ๆ ในการตอบที่ดูเหมือนสำเร็จ
แบบที่สองคืออันตราย ถ้าโค้ดของคุณอ่านการยืนยัน บันทึกการจอง แล้วเรียกเก็บลูกค้าตามจำนวนที่เขาเห็น ส่วนต่างจะถูกหักจากมาร์จิ้นของคุณ หรือต่อมาจะกลายเป็น ADM กฎจึงเรียบง่าย: เปรียบเทียบยอดรวมที่ซัพพลายเออร์ยืนยันกับยอดรวมที่ลูกค้ายอมรับ ทุกครั้ง ในโค้ด ก่อนที่คุณจะ capture การชำระเงิน
เมื่อสองยอดต่างกัน จะทำอย่างไรขึ้นกับขนาดของส่วนต่างและใครเป็นผู้รับภาระ การปัดเศษไม่กี่เซนต์ระหว่างสกุลเงินคือค่าเผื่อที่ตั้งไว้ครั้งเดียว ส่วนที่ใหญ่กว่านั้นต้องกลับไปหาลูกค้าเป็นราคาใหม่พร้อมปุ่มยอมรับที่ชัดเจน อย่ารับส่วนต่างเองโดยอัตโนมัติ และอย่าเรียกเก็บเพิ่มโดยอัตโนมัติ
ความล้มเหลวที่สอง: จองแล้ว แต่ยังไม่ออกตั๋ว
การมี PNR ไม่เหมือนกับการมีตั๋ว หลายโฟลว์สร้างการสำรองที่นั่งก่อน แล้วออก e-ticket เป็นอีกขั้นตอนหนึ่ง โดยมีเวลาจำกัดคั่นอยู่ ถ้าชำระเงินสำเร็จแต่การออกตั๋วล้มเหลว คุณกำลังถือเงินของลูกค้าและการสำรองที่นั่งที่จะหมดอายุตามนาฬิกาของมันเอง
ความล้มเหลวแบบนี้ไม่ค่อยส่งเสียงดัง การเรียก issue ส่งข้อผิดพลาดหรือ timeout กลับมา และการจองค้างอยู่ในสถานะที่ฐานข้อมูลของคุณติดป้ายว่า "paid" ขณะที่ซัพพลายเออร์ยังบอกว่า "held" ในเวลาเดียวกัน เวลาจำกัดการออกตั๋วก็เดินอยู่ และไม่เหมือนคิวซัพพอร์ตของคุณ สายการบินไม่รอ
จัดการมันเป็นสถานะของตัวเอง ไม่ใช่แค่รูปแบบหนึ่งของความสำเร็จหรือความล้มเหลว การจองต้องมีอย่างน้อยสถานะเหล่านี้: created, held, payment captured, issuing, ticketed, failed-and-refundable สถานะ "payment captured, issuing" ต้องมีตัวจับเวลา: เมื่อการจองค้างอยู่ตรงนั้นนานเกินไป งานเบื้องหลังควรอ่านการสำรองที่นั่งจากซัพพลายเออร์ซ้ำและตัดสินใจ แทนที่จะรอให้คนมาสังเกตเห็น การตัดสินใจนี้ถูกเมื่อคุณรู้เวลาจำกัดของซัพพลายเออร์ เพราะมันบอกว่าคุณลองซ้ำได้อย่างปลอดภัยนานเท่าใดก่อนต้องคืนเงิน
ความล้มเหลวที่สาม: timeout ที่ไม่รู้ผลลัพธ์
นี่คือตั๋วเย็นวันพฤหัสบดี คำขอของคุณออกไปแล้ว ไม่มีคำตอบกลับมา การเชื่อมต่อขาดหรือเกตเวย์ยอมแพ้ ซัพพลายเออร์อาจประมวลผลไปครบ บางส่วน หรือไม่เลย
สิ่งยั่วยวนคือการลองซ้ำ อย่าลองซ้ำการเรียก create-booking แบบมืดบอด เพราะความพยายามครั้งที่สองอาจสร้างการสำรองที่นั่งที่สอง และการซ้ำซ้อนคือต้นทุนจริง: กันที่นั่งสองที่ อาจออกตั๋วสองใบ และมีข้อพิพาทเรื่องการคืนเงินในหนึ่งในนั้น
ลำดับที่ปลอดภัยคือ หยุด อ่าน แล้วจึงตัดสินใจ หยุดโฟลว์ฝั่งลูกค้าด้วยสถานะที่ตรงไปตรงมา "เรากำลังยืนยันการจองของคุณ" อ่านฝั่งซัพพลายเออร์โดยค้นหาการจองด้วยหมายเลขอ้างอิงที่คุณสร้างไว้ก่อนเรียก (นี่คือเหตุผลที่คุณสร้างหมายเลขอ้างอิงฝั่งไคลเอนต์ของตัวเองก่อน และส่งไปด้วยถ้าซัพพลายเออร์รับ) แล้วค่อยตัดสินใจ: ถ้าพบ ให้ทำต่อจากสถานะจริง ถ้าไม่พบหลังพ้นช่วงเวลาประมวลผลของซัพพลายเออร์เอง การลองซ้ำหนึ่งครั้งถือว่าปลอดภัย
ถ้าซัพพลายเออร์ไม่มีวิธีค้นหาด้วยหมายเลขอ้างอิงของคุณ ให้ค้นหาด้วยชื่อผู้โดยสาร เส้นทาง และวันที่ในช่วงเวลาแคบ ๆ แล้วถือว่าที่ตรงกันคือพบแล้ว ไม่สวย แต่ถูกกว่าการซ้ำซ้อนมาก
ตารางตัดสินใจที่คุณโต้แย้งได้
| สิ่งที่คุณเห็น | สิ่งที่คุณรู้ | สิ่งที่ควรทำ | สิ่งที่ไม่ควรทำ |
|---|---|---|---|
| ซัพพลายเออร์ตอบ "fare changed" | ยังไม่มีอะไรถูกจอง | แสดงยอดใหม่ ขอการยอมรับ แล้วรัน create ใหม่ | รันใหม่ด้วยราคาเดิมแล้วหวังว่าจะผ่าน |
| สำเร็จ แต่ยอดรวมต่างจากที่ลูกค้ายอมรับ | การจองมีอยู่ในราคาใหม่ | พักการชำระเงิน ถามลูกค้า และ void การจองถ้าลูกค้าปฏิเสธ | capture ยอดเดิมแล้วรับส่วนต่างเอง |
| capture เงินแล้ว แต่การเรียก issue เกิดข้อผิดพลาด | มี PNR แต่สถานะตั๋วไม่ทราบ | อ่านการสำรองที่นั่งซ้ำ ลอง issue ใหม่ภายในเวลาจำกัด แล้วคืนเงินหลังจากนั้น | ทำเครื่องหมายว่าการจองล้มเหลวแล้วลืม PNR |
| timeout ตอน create | ผลลัพธ์ไม่ทราบ | ค้นหาด้วยหมายเลขอ้างอิงของคุณ แล้วทำต่อหรือลองซ้ำหนึ่งครั้ง | ลองซ้ำแบบมืดบอดทันที |
| timeout ตอน cancel | คุณอาจยังต้องรับผิดชอบต่อเซกเมนต์ | อ่านสถานะซ้ำก่อนบอกลูกค้าอะไร | แสดง "cancelled" เพียงเพราะมีการกดปุ่ม |
มีแถวหนึ่งที่คุณอาจไม่เห็นด้วย: บางทีมคืนเงินทันทีเมื่อเกิดข้อผิดพลาดการออกตั๋วครั้งแรกเพื่อให้ลูกค้าสบายใจ สำหรับตั๋วราคาต่ำพอแก้ตัวได้ แต่สำหรับตั๋วราคาสูงเป็นนิสัยที่ไม่ดี เพราะคุณอาจเสียค่าโดยสารที่อีกหนึ่งนาทีต่อมายังช่วยไว้ได้
ถ้าทำผิดต้องเสียเท่าไร
แต่ละความล้มเหลวมีใบแจ้งหนี้ต่างกัน การเปลี่ยนราคาที่พลาดไปคือมาร์จิ้นที่หายในทุกการจองที่ได้รับผลกระทบ และมักไม่มีใครสังเกตจนถึงการกระทบยอด กรณีจองแล้วแต่ไม่ออกตั๋วคือลูกค้าที่ไปถึงสนามบินพร้อมการสำรองที่นั่งที่หมดอายุและยอดตัดบนบัตร ซึ่งเป็นทั้ง chargeback และปัญหาชื่อเสียงพร้อมกัน การลองซ้ำแบบมืดบอดเมื่อ timeout คือการสำรองที่นั่งซ้ำ และสายการบินตรวจสอบรายการซ้ำ รูปแบบของกรณีเช่นนี้เป็นเรื่องที่จบลงที่ ADM
ไม่มีอะไรในนี้แปลกใหม่ มันคืองานวางท่อที่ไม่หวือหวาซึ่งแยกเดโมออกจากสิ่งที่คุณปล่อยให้ทำงานได้ตลอดสุดสัปดาห์
สร้างงานกระทบยอดก่อนที่จะต้องใช้
ความล้มเหลวทั้งสามจบลงเหมือนกัน: ฐานข้อมูลของคุณกับของซัพพลายเออร์ไม่ตรงกัน ดังนั้นเขียนงานที่เปรียบเทียบทั้งสองก่อนเหตุการณ์แรก ไม่ใช่หลังจากนั้น รันทุกคืนคือขั้นต่ำ ทุกไม่กี่นาทีสำหรับรายการที่อยู่ในสถานะเปลี่ยนผ่านจะดีกว่า งานนี้แสดงรายการจองที่ค้างใน held, issuing หรือ unknown ถามซัพพลายเออร์ แล้วซ่อมแซมระเบียนหรือเปิดตั๋วพร้อมหลักฐานแนบ
เก็บทุกคำขอและคำตอบของการเรียกที่เกี่ยวกับการจอง รวมถึง timeout พร้อมหมายเลขอ้างอิงที่คุณส่งไป เมื่อลูกค้าโต้แย้งการตัดเงิน ล็อกนั้นคือข้อโต้แย้งของคุณ มันยังช่วยให้การคุยเรื่อง latency อยู่บนความจริง: ดูสิ่งที่คุณแก้ได้และแก้ไม่ได้เกี่ยวกับ latency ของ API เพื่อเข้าใจว่าทำไม timeout จึงเป็นข้อเท็จจริงของชีวิต ไม่ใช่บั๊กที่ต้องกำจัด
ถ้าคุณยังตัดสินใจอยู่ว่าจะเชื่อมต่อซัพพลายเออร์อย่างไร คู่มือในการเชื่อมต่อ API จองตั๋วเครื่องบินครอบคลุมลำดับการเรียกที่บทความนี้สมมติไว้ และถ้าต้องการคุยว่าสถานะเหล่านี้แมปกับ API เที่ยวบินและโรงแรมของเราอย่างไร การเข้าถึงเริ่มต้นด้วยการสนทนา: ดูหน้า API ท่องเที่ยว