การผสาน Stripe Checkout สำหรับ E-Commerce ระหว่างประเทศ: Edge Cases และบทเรียน
Documentation ของ Stripe ดีอย่างแท้จริง และการผสานเริ่มต้นมักทำงานได้ในครั้งแรก แต่ในความเป็นจริง e-commerce ระหว่างประเทศแสดง problem class ที่ quickstart guide ไม่ครอบคลุม: ความน่าเชื่อถือของ webhook delivery ข้าม infrastructure restart, mechanics ที่ subtle ของ refund ในสกุลเงินที่ไม่ใช่ settlement และ operational overhead ของการจัดการ API key หลายตัวและ webhook endpoint สำหรับ entity ทางกฎหมายที่แตกต่างกัน
ความน่าเชื่อถือของ Webhook Delivery
Stripe ยืนยัน webhook delivery ด้วย exponential backoff จนถึงสาม วัน นั่นหมายความว่าถ้า endpoint ของคุณ down webhook จะ queue และ retry ไม่ใช่แค่ส่งครั้งเดียวและหายไป แต่มีสามสิ่งที่ทำให้นี่ซับซ้อนขึ้น: webhook สามารถมาถึงแบบ out of order, endpoint ของคุณอาจ respond 200 ก่อนที่จะดำเนินการ payload จริง ๆ ซึ่ง Stripe ตีความว่า success และ idempotency key ช่วยแต่ไม่แก้ปัญหาทุกอย่าง
Refund ในสกุลเงินที่ไม่ใช่ Settlement
ถ้าคุณ charge ใน EUR และ account ของคุณ settle ใน SGD, refund จะ issued ใน EUR ที่อัตราแลกเปลี่ยน ณ เวลาของ refund ไม่ใช่ ณ เวลาของ charge นี่คือ mechanics ที่ถูกต้องและ documentation ชัดเจนเกี่ยวกับเรื่องนี้