ข้ามไปยังเนื้อหา
เดโมสด
บล็อก

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

กองบรรณาธิการ Tekravel
เขียนโดยใช้ AI ช่วย

ตั๋วซัพพอร์ตเข้ามาในเย็นวันพฤหัสบดี ลูกค้าจ่ายเงินแล้ว หน้าจอหมุนอยู่พักหนึ่ง แล้วแสดงข้อผิดพลาดทั่วไป บัตรถูกตัดเงินไปแล้ว ล็อกของคุณแสดง 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 ท่องเที่ยว

กองบรรณาธิการ Tekravel

โต๊ะข่าวเทคโนโลยีท่องเที่ยว

โต๊ะข่าวเทคโนโลยีท่องเที่ยวของ Tekravel เขียนให้คนในวงการ ทั้งเจ้าของเอเจนซี ผู้รวบรวมตั๋ว และนักพัฒนาที่เชื่อมต่อระบบให้พวกเขา ทุกบทความถูกตรวจสอบกับแพลตฟอร์มที่กล่าวถึงก่อนเผยแพร่