Callback การชำระเงิน: ตรวจลายเซ็น ตรวจคำสั่งซื้อ และส่งมอบแบบป้องกันผลซ้ำ
Callback อาจล่าช้าหรือถูกส่งซ้ำ เซิร์ฟเวอร์ของคุณต้องรับ JSON ตรวจลายเซ็น ตรวจคำสั่งซื้อ และบันทึกสถานะสำเร็จอย่างเชื่อถือได้ ก่อนนำผลเข้าสู่กระบวนการส่งมอบที่ลองใหม่ได้อย่างปลอดภัย
สารบัญบทความ
การแจ้งถูกส่งถึงเซิร์ฟเวอร์คุณเมื่อใด
หลังแพลตฟอร์มได้รับการแจ้งชำระเงินสำเร็จจากช่องทางและอัปเดตคำสั่งซื้อรับชำระแทนแล้ว จะส่งไปยัง notifyUrl แบบอะซิงโครนัส POST,Content-Type เป็น application/json หากคำสั่งซื้อไม่มีที่อยู่แจ้งเตือน จะใช้ที่อยู่เริ่มต้นของผู้ค้า แต่เมื่อสร้างคำสั่งซื้อยังควรส่ง notifyUrl。
ปลายทางรับการแจ้งต้องเข้าถึงได้จากอินเทอร์เน็ตและไม่อาศัยสถานะล็อกอินในเบราว์เซอร์ ข้อมูลที่รับเป็นรูปแบบกลางของ 稳付pay ไม่ต้องแยกพารามิเตอร์ต้นฉบับจากช่องทางต้นน้ำ หน้าสำเร็จในเบราว์เซอร์และภาพที่ลูกค้าส่งมาใช้แทนการตรวจที่เซิร์ฟเวอร์ไม่ได้
15 ช่องข้อมูลในการแจ้งมาตรฐาน
| ช่องข้อมูล | ความหมายและวิธีตรวจ |
|---|---|
bizType | สำหรับรับชำระแทน ค่าคงที่คือ collect。 |
mchId | ต้องตรงกับผู้ค้าที่เป็นเจ้าของคำสั่งซื้อในระบบคุณ |
platformOrderNo | หมายเลขคำสั่งซื้อแพลตฟอร์ม เชื่อมกับบันทึกการชำระเงินในระบบ |
outTradeNo | หมายเลขคำสั่งซื้อผู้ค้าที่ส่งตอนสร้างคำสั่งซื้อ |
merchantOrderNo | ช่องข้อมูลเพื่อความเข้ากันได้ มีค่าเหมือน outTradeNo |
transactionId | หมายเลขธุรกรรมช่องทาง หากช่องทางไม่ส่งกลับจะใช้หมายเลขคำสั่งซื้อแพลตฟอร์ม |
amount | จำนวนเงินหน่วยเฟิน เช่นสตริง 1000。 |
amountYuan | จำนวนเงินหน่วยหยวน ทศนิยมสองตำแหน่ง เช่น 10.00。 |
currencyCode | สกุลเงิน เช่น CNY。 |
orderStatus | สถานะคำสั่งซื้อ ตัวอย่างแจ้งสำเร็จใช้สตริง 1。 |
tradeState | รับชำระแทนสำเร็จคือ SUCCESS。 |
returnCode | 00 หมายถึงธุรกิจสำเร็จ |
successTime | เวลาสำเร็จ รูปแบบ yyyy-MM-dd HH:mm:ss。 |
notifyTime | เวลาของการแจ้งครั้งนี้ ใช้รูปแบบเดียวกับด้านบน |
sign | ลายเซ็นธุรกิจ ไม่รวมตัวเองในการคำนวณลายเซ็น |
ตัวอย่างการแจ้งใช้สตริงทุกช่อง เก็บค่าที่รับมาเดิมเพื่อตรวจลายเซ็นก่อน โดยเฉพาะ 00 และ 10.00 อย่าจัดรูปแบบ ตัดเลขศูนย์ หรือแปลงเป็นตัวเลขก่อนตรวจลายเซ็น
ตรวจลายเซ็นก่อน แล้วตรวจคำสั่งซื้อและผลการชำระเงิน
- อ่าน JSON คงค่าช่องข้อมูลเดิม และดึงจาก Body ช่อง
sign。 - ใช้
CALLBACK_SECRETก่อน หากไม่ได้กำหนดแยกจึงใช้MD5_SECRET。 - ตัด sign และช่องว่าง เรียงชื่อช่องตาม ASCII จากน้อยไปมากแล้วเชื่อม ต่อท้าย
&key=SECRETคำนวณ MD5 แบบตัวพิมพ์เล็กแล้วเปรียบเทียบ - เมื่อลายเซ็นผ่าน ให้ตรวจหมายเลขผู้ค้า ประเภทธุรกิจ หมายเลขคำสั่งซื้อผู้ค้า และหมายเลขแพลตฟอร์ม เพื่อหาคำสั่งซื้อจริงในระบบ
- ตรวจจำนวนเงินหน่วยเฟิน สกุลเงิน และสถานะชำระเงินสำเร็จก่อนเข้าสู่การประมวลผลแบบป้องกันผลซ้ำ
อย่าส่งมอบเพียงเพราะเห็น returnCode=00 หรือ orderStatus=1 ต้องผ่านทั้งลายเซ็น ตัวตนคำสั่งซื้อ จำนวนเงิน สกุลเงิน และสถานะสำเร็จ หากไม่ตรงให้หยุดส่งมอบและบันทึกความผิดปกติ
กฎของส่วนหัวเพื่อความเข้ากันได้ X-Plat-Signature ให้ฝ่ายเทคนิคยืนยันแยก หน้านี้ใช้ลายเซ็นธุรกิจมาตรฐานใน Body ไม่ใช่คำนวณ MD5 จากข้อความ JSON ทั้งก้อนโดยตรง
import json
import os
from wenfupay_collect_sign import verify_collect_notification
try:
notice = json.loads(raw_request_body)
except (ValueError, UnicodeDecodeError):
return http_response(400, "INVALID_JSON")
if not isinstance(notice, dict):
return http_response(400, "INVALID_JSON_OBJECT")
verified = verify_collect_notification(
notice,
api_secret=os.environ["MD5_SECRET"],
callback_secret=os.environ.get("CALLBACK_SECRET"),
)
if not verified:
return http_response(400, "INVALID_SIGNATURE")
# Business-specific pseudocode: implement these durable operations.
with database_transaction():
order = lock_order(notice["outTradeNo"])
match_merchant_currency_and_amount_in_cents(order, notice)
require_documented_success_fields(notice)
record_payment_once(order, notice["platformOrderNo"])
enqueue_fulfillment_once(order)
# Only after successful durable acceptance:
return http_response(200, "OK", content_type="text/plain")ฟังก์ชันธุรกิจเป็นตัวอย่างขั้นตอน ต้องเชื่อมกับคำสั่งซื้อและฐานข้อมูลผู้ค้า หากบันทึกถาวรไม่สำเร็จ ลายเซ็นผิด หรือจำนวนเงินไม่ตรง ห้ามตอบสำเร็จก่อน การแจ้งซ้ำที่รับไว้อย่างเชื่อถือได้แล้วสามารถตรวจสอบและตอบโดยตรงเป็น OK。
บันทึกการชำระเงินและส่งมอบคำสั่งซื้อเดียวเพียงครั้งเดียว
- ตรวจสอบและค้นหาคำสั่งซื้อตรวจลายเซ็น จำนวนเงิน และสกุลเงิน แล้วหาบันทึกชำระเงินของผู้ค้ารายเดียวกัน
- อัปเดตสถานะภายในธุรกรรมล็อกคำสั่งซื้อหรืออัปเดตแบบมีเงื่อนไข ไม่บันทึกซ้ำเมื่อมีการแจ้งสำเร็จแล้ว
- บันทึกงานส่งมอบที่ไม่ซ้ำใช้คีย์เฉพาะคำสั่งซื้อบันทึกงานส่งรหัส เติมเงิน หรือจัดส่ง
- ยืนยันหลัง commitตอบ OK เมื่อบันทึกสถานะและงานไว้อย่างเชื่อถือได้แล้ว งานส่งมอบยังลองใหม่ต่อได้
รับการแจ้ง
ลายเซ็นผิด: ปฏิเสธการประมวลผล ไม่ตอบรับสำเร็จ
ผู้ค้า คำสั่งซื้อ จำนวนเงิน หรือสกุลเงินไม่ตรง: บันทึกความผิดปกติ ไม่ส่งมอบ
เริ่มธุรกรรมฐานข้อมูล
สอบถามและล็อกคำสั่งซื้อในระบบ
หากยังไม่สำเร็จ: อัปเดตสถานะชำระเงินสำเร็จ
ทำให้แน่ใจว่ามีงานส่งมอบ คีย์ธุรกิจเฉพาะ = ID คำสั่งซื้อในระบบ
Commit ธุรกรรมฐานข้อมูล
ตอบ HTTP 200 และข้อความธรรมดา OK
งานส่งมอบ
หากคีย์ธุรกิจเฉพาะส่งมอบเสร็จแล้ว: จบ
มิฉะนั้นส่งมอบอย่างปลอดภัยหนึ่งครั้งและบันทึกผล
ผิดพลาดชั่วคราว: เก็บงานและลองใหม่ตามกฎธุรกิจนี่คือรหัสเทียมของกระบวนการธุรกิจ ไม่ใช่ธุรกรรมที่รันได้ทันที หากส่งมอบสินค้าในธุรกรรมเดียวกันไม่ได้ ให้ใช้งานที่บันทึกถาวรและบันทึกส่งมอบเฉพาะ เพื่อไม่ให้ชำระเงินสำเร็จแล้วแต่ไม่ส่งสินค้าตลอดไปเมื่อโปรเซสเริ่มใหม่
ตอบ OK ให้ถูกต้องและจัดการการลองส่งใหม่
การตอบรับสำเร็จต้องมีทั้ง HTTP 200 และ Body ตอบกลับที่มี success、ok หรือ OK แนะนำให้ตอบโดยตรงเป็น ข้อความธรรมดา OK ไม่ใช้หน้าล็อกอิน เทมเพลต HTML หรือ JSON ห่อหุ้มเริ่มต้นของเฟรมเวิร์ก
การแจ้งซ้ำที่ตรวจแล้วว่าประมวลผลสำเร็จก็ตอบ OK เช่นกัน หากฐานข้อมูลใช้งานไม่ได้ ลายเซ็นผิด หรือธุรกิจยังตรวจไม่ผ่าน ห้ามตอบสำเร็จเพียงเพื่อหยุดการลองใหม่
การแจ้งที่ล้มเหลวจะลองใหม่แบบอะซิงโครนัส แจ้งรวมสูงสุด 3 ครั้ง รวมการส่งครั้งแรก หลังสองครั้งแรกล้มเหลว จะลองใหม่หลังประมาณ 60 และ 300 วินาทีตามลำดับ ไม่ใช่ลองไม่จำกัดหรือส่งเพิ่มสามครั้งนอกเหนือจากครั้งแรก
สอบถามรายการเชิงรุกเพื่อชดเชยเมื่อไม่ได้รับการแจ้ง
ข้อกำหนดระบุการแจ้งหลังชำระเงินสำเร็จ ไม่ควรสมมติว่าสถานะล้มเหลว ปิด หรือหมดอายุจะถูกส่งเสมอ เซิร์ฟเวอร์ต้องสอบถามคำสั่งซื้อที่รอชำระนาน สร้างแล้วหมดเวลารอ หรือประมวลผลการแจ้งผิดปกติเอง
เมื่อสอบถามแล้วยืนยันสำเร็จ ให้เข้าสู่กระบวนการส่งมอบแบบป้องกันผลซ้ำเดียวกับ callback อย่าเพิ่มเส้นทางส่งสินค้าที่ข้ามการตรวจจำนวนเงิน ยืนยันหน่วยเงินในผลสอบถามตอนเปิดบริการก่อนแปลงมาเปรียบเทียบ ผลที่ไม่ชัดเจนให้รอตรวจสอบต่อ
ทดสอบอย่างน้อยการแจ้งซ้ำ สอบถามก่อน callback, callback ก่อนสอบถาม ฐานข้อมูลล้มเหลวชั่วคราว และลองส่งมอบใหม่หลังชำระสำเร็จ ฝ่ายเทคนิคจะช่วยยืนยันการตั้งค่าและวิธีจัดการปัญหาเฉพาะ
บทความนี้เรียบเรียงตามข้อกำหนดการเชื่อมต่อ 稳付pay กลับไป ภาพรวมการเชื่อมต่อ หรือดู ช่องข้อมูลสร้างคำสั่งซื้อและสอบถาม。
ยืนยันการเชื่อมต่อให้ตรงธุรกิจของคุณ
แจ้งสินค้า ปริมาณคำสั่งซื้อ วิธีชำระเงิน และความต้องการชำระยอด เพื่อยืนยัน API เส้นทางเงิน และการจัดการปัญหาทีละข้อ
ติดต่อ 稳付pay ↗