ระบบส่งคำขอเพิ่มแต้มสองรายการไปยังพาร์ตเนอร์ ทั้งคู่จบด้วย connection reset by peer ขณะรอคำตอบ แต่เมื่อเอารหัสธุรกรรมไปเทียบกับข้อมูลของพาร์ตเนอร์ รายการ A เพิ่มแต้มสำเร็จแล้ว ส่วนรายการ B ยังค้นไม่พบในข้อมูลที่ตรวจรอบแรก
ถ้ากดส่งซ้ำทั้งคู่ รายการ A อาจได้แต้มสองครั้ง ถ้าปิดเคสทั้งคู่ รายการ B อาจตกหล่น ทั้งสองรายการในตัวอย่างนี้เป็นข้อมูลจำลอง และเริ่มจากข้อความผิดพลาดเดียวกัน
เมื่อคำตอบหาย สถานะธุรกรรมยังเปิดอยู่
ลองนึกถึงคำขอหนึ่งรายการที่ผ่านสามจังหวะ
- ต้นทางส่งคำขอเพิ่มแต้ม
- ปลายทางบันทึกการเพิ่มแต้ม
- ต้นทางได้รับคำตอบ
ถ้าการเชื่อมต่อหลุดระหว่างข้อ 2 กับข้อ 3 ต้นทางอาจเห็น error ทั้งที่ยอดแต้มเปลี่ยนแล้ว อีกกรณีคือการเชื่อมต่อหลุดก่อนปลายทางบันทึกอะไรเลย ต้นทางก็อาจเห็น error แบบเดียวกัน ลำดับนี้อธิบายได้ว่าทำไมสถานะ “ส่งแล้วไม่ได้คำตอบ” จึงต้องเก็บไว้แยกจากผลของธุรกรรม
ระหว่างตรวจ ให้ตั้งสถานะของรายการไว้ว่า รอยืนยันผล ถ้าระบบมีงานส่งซ้ำอัตโนมัติ ให้ตรวจด้วยว่างานนั้นกำลังจัดการรายการเดียวกันอยู่หรือเปล่า ก่อนเริ่มส่งด้วยมือ
ไล่จาก log ไปถึงรายการที่เปลี่ยนยอดจริง
เริ่มจาก รหัสอ้างอิงธุรกรรม ที่ทั้งสองฝั่งค้นได้ เก็บเวลาพร้อมเขตเวลา ประเภทคำขอ และจำนวนแต้มไว้ช่วยเทียบรายการ รหัสของการส่งแต่ละครั้งมีประโยชน์ตอนอ่าน log แต่ธุรกรรมเดียวอาจมีหลาย attempts และหนึ่ง attempt อาจถูกบันทึกในหลายจุด เช่น gateway กับตัวแอป ถ้าพบ error ห้าบรรทัด ให้รวมหลักฐานตามรหัสธุรกรรมก่อนนับผลกระทบ ส่วนบรรทัดที่ยังจับคู่ไม่ได้ให้เก็บไว้ตรวจต่อ
ฝั่งต้นทางให้ดูสถานะล่าสุด รวมถึงคิว งาน retry หรือ callback ที่อาจตามมาทีหลัง ฝั่งปลายทางให้ขอผลจากแหล่งที่ยืนยันได้ว่าธุรกรรมถูกบันทึกแล้ว เช่น API ตรวจสถานะที่ระบุผลสุดท้าย หรือรายการในบัญชีแต้ม ถ้าได้รับคำตอบว่า “ไม่พบ” ให้ถามต่อว่าค้นจากที่ไหน ครอบคลุมช่วงเวลาและรหัสที่ถูกต้องหรือยัง และอาจมีคำขอค้างประมวลผลอยู่หรือไม่ คำตอบจาก log ที่มีข้อมูลไม่ครบยังเปิดได้ทั้งสองทาง
ตัดสินใจทีละรายการ

| สิ่งที่ตรวจได้ | ทำต่ออย่างไร |
|---|---|
| ปลายทางยืนยันว่ารายการสำเร็จและรายละเอียดตรงกัน | กระทบยอดสถานะต้นทางกับผลปลายทาง แล้วปิดงานส่งซ้ำของรายการนั้น |
| ยังยืนยันผลไม่ได้ หรือคำขอเดิมอาจค้างอยู่ | คงสถานะรอยืนยัน ตรวจจากข้อมูลที่ครอบคลุมขึ้น และกำหนดเจ้าของกับเวลาตรวจรอบถัดไป |
| ยืนยันว่าไม่มีผลของรายการเดิม จัดการคำขอที่อาจค้างแล้ว และเงื่อนไขของ API รองรับการส่งซ้ำ | ส่งตามวิธีที่ตกลงกัน บันทึก attempt ใหม่ผูกกับธุรกรรมเดิม แล้วตรวจผลทั้งสองฝั่ง |
รายการ A ไปแถวแรกทันทีเมื่อเทียบรหัสและยอดตรงกัน ส่วนรายการ B ยังอยู่แถวกลางหลังการค้นรอบแรก สมมติว่าต่อมาพาร์ตเนอร์ตรวจบัญชีแต้มและคิวแล้ว ต้นทางตรวจว่าไม่มีงาน retry แข่งกัน และทั้งสองฝั่งยืนยันวิธีส่งซ้ำได้ รายการ B จึงไปแถวสุดท้าย หลังส่งให้ตรวจผลสุดท้ายอีกครั้ง โดยเฉพาะ API ที่ตอบรับคำขอก่อนประมวลผลเสร็จ
ตรวจว่า API กันการทำรายการซ้ำอย่างไร
รหัสอ้างอิงช่วยให้สองทีมคุยถึงธุรกรรมเดียวกัน ส่วน idempotency key ใช้ระบุคำขอซ้ำกับ API ที่รองรับ เพื่อให้การส่งซ้ำมีผลที่ตั้งใจไว้เท่ากับการส่งครั้งเดียว ถ้า API ระบุให้ใช้ key เดิมกับคำขอเดิม ให้ตรวจด้วยว่าการรับประกันครอบคลุม endpoint นี้นานเท่าไร ต้องใช้ข้อมูลชุดเดิมหรือไม่ และระบบทำอย่างไรเมื่อคำขอแรกยังประมวลผลอยู่ หากหมดช่วงที่ปลายทางจำ key ได้ ให้กลับไปตรวจสถานะธุรกรรมก่อนตัดสินใจอีกครั้ง
สำหรับการตั้งค่า retry อัตโนมัติ มาตรฐาน HTTP ระบุว่าฝั่ง client ควรส่งคำขอที่อาจเกิดผลซ้ำโดยอัตโนมัติเฉพาะเมื่อรู้ว่าคำขอนั้นมีคุณสมบัติ idempotent หรือมีวิธีตรวจได้ว่าคำขอเดิมยังไม่ถูกนำไปใช้ ให้ยึดเงื่อนไขของ API ที่ใช้งานจริง เช่น Stripe API v1 มีเงื่อนไขเรื่องการเก็บ key และการเทียบพารามิเตอร์ของคำขอเดิมกับคำขอที่ส่งซ้ำ RFC 9110 §9.2.2 · Stripe API — Idempotent requests
ก่อนกดส่งซ้ำ ให้เขียนเหตุผลลงในบันทึก incident สั้น ๆ หนึ่งบรรทัด เช่น “รายการ B ตรวจบัญชีแต้มและคิวทั้งสองฝั่งแล้ว ยืนยันว่าคำขอเดิมไม่ค้างและยังไม่มีการเพิ่มแต้ม จะส่งด้วย key เดิมตามข้อตกลง แล้วตรวจยอดหลังประมวลผล” บันทึกนี้ช่วยให้คนที่มารับช่วงต่อรู้ว่าตรวจอะไรไปแล้ว และรู้ว่าต้องรอหลักฐานอะไรจึงจะปิดรายการได้