ลงลายเซ็นและตรวจสอบ

กฎลายเซ็นคำขอ: เรียงพารามิเตอร์และคำนวณ MD5

ลงลายเซ็นบนเซิร์ฟเวอร์คุณโดยใช้พารามิเตอร์ที่ส่งจริงครั้งนี้ อย่าคัดลอกลายเซ็นตัวอย่างหรือทำ MD5 กับ JSON ทั้งข้อความโดยตรง การสร้างและสอบถามใช้กฎลายเซ็นพารามิเตอร์เดียวกัน

สารบัญบทความ

สร้าง sign ของคำขอในห้าขั้นตอน

  1. ประกอบพารามิเตอร์สุดท้าย ใส่ mchId ของคุณและ reqTime ปัจจุบัน โดยยังไม่ใส่ sign。
  2. ตัด sign และช่องว่างตามข้อกำหนด เก็บพารามิเตอร์อื่นที่ส่งจริงและไม่ว่าง
  3. เรียงชื่อช่องตาม ASCII จากน้อยไปมาก ประกอบแต่ละคู่เป็น ชื่อช่อง=ค่าช่อง แล้วใช้ & เชื่อมเข้าด้วยกัน
  4. ต่อท้ายด้วย &key= และกุญแจ API ผู้ค้า
  5. คำนวณ MD5 จากสตริง UTF-8 ใช้แฮชฐานสิบหกตัวพิมพ์เล็กเป็น sign แล้วเพิ่มในคำขอ

หัวข้อ รายละเอียด และ IP ลูกค้าที่เป็นทางเลือก ต้องร่วมลงลายเซ็นหากส่งจริงและไม่ว่าง หากแก้ยอด ที่อยู่แจ้ง หรือเวลาหลังลงลายเซ็น ต้องคำนวณใหม่ทั้งหมด

ตัวอย่างโครงสร้างข้อความก่อนลงลายเซ็น

MERCHANT_ID、CURRENT_TIME_MS และ MD5_SECRET ต้องถูกแทนค่าที่หลังบ้านทั้งหมด ห้ามส่งตามตัวอย่างโดยตรง

amount=1000&currencyCode=CNY&mchId=MERCHANT_ID&notifyUrl=https://merchant.example.com/pay/notify&outTradeNo=DEMO_COLLECT_001&reqTime=CURRENT_TIME_MS&wayCode=80001&key=MD5_SECRET

ตัวพิมพ์ใหญ่เล็ก ขีดล่าง และการสะกดมีผลต่อแฮช หากสอบถามใช้ platform_order_no ให้ใช้ชื่อนี้ลงลายเซ็น ไม่แทนด้วยชื่อในผลตอบกลับ platformOrderNo。

Python · เฉพาะลงลายเซ็นและตรวจสอบ
"""Example-only helpers for the documented flat collection signing protocol.

No HTTP calls or credentials are included. Configure secrets on your server.
The supported example input values are strings, integers and null. Confirm
additional value types, response signatures and channel limits during setup.
"""
from __future__ import annotations
import hashlib
import hmac
import re
from collections.abc import Mapping

def sign_collect(parameters: Mapping[str, object], secret: str) -> str:
    """Sort nonempty flat scalar fields, append the secret, return MD5 hex."""
    if not isinstance(secret, str) or not secret:
        raise ValueError("A server-side secret is required")
    values: dict[str, str] = {}
    for name, value in parameters.items():
        if not isinstance(name, str) or not re.fullmatch(r"[A-Za-z0-9_]+", name):
            raise ValueError("Use the exact documented ASCII field names")
        if name == "sign" or value is None or value == "":
            continue
        if isinstance(value, bool) or not isinstance(value, (str, int)):
            raise TypeError("This example accepts only strings and integers")
        values[name] = str(value)
    canonical = "&".join(name + "=" + values[name] for name in sorted(values))
    signed_text = canonical + "&key=" + secret
    return hashlib.md5(signed_text.encode("utf-8")).hexdigest()

def verify_collect_notification(
    parameters: Mapping[str, object],
    api_secret: str,
    callback_secret: str | None = None,
) -> bool:
    """Verify the JSON field signature, preserving all received string values."""
    if not isinstance(parameters, Mapping):
        return False
    supplied = parameters.get("sign")
    if not isinstance(supplied, str) or not re.fullmatch(r"[0-9a-f]{32}", supplied):
        return False
    secret = callback_secret or api_secret
    try:
        expected = sign_collect(parameters, secret)
    except (ValueError, TypeError):
        return False
    return hmac.compare_digest(expected, supplied)

ดาวน์โหลดตัวอย่างลายเซ็น Python

ตัวอย่างไม่มีเกตเวย์ บัญชี หรือกุญแจ และไม่ส่งคำขอ รองรับเพียงสตริง จำนวนเต็ม และค่าว่าง ไม่เดาการแปลงทศนิยม บูลีน หรือโครงสร้างซ้อนเป็นข้อความด้วยตัวเอง ชนิดอื่นให้ยืนยันตอนทดสอบร่วม

ลำดับการลงลายเซ็นกับเข้ารหัสขณะส่ง

กรณีวิธีจัดการที่ถูกต้อง
POST JSONลงลายเซ็นพารามิเตอร์ธุรกิจก่อน แล้วแปลงพารามิเตอร์ที่มี sign เป็น JSON กฎนี้ไม่ลงลายเซ็นข้อความ JSON ดิบโดยตรง
สอบถาม GETลงลายเซ็นจากค่าพารามิเตอร์ต้นฉบับก่อน แล้วใช้ตัวเข้ารหัส URL ประกอบสตริงคำถาม
จำนวนเงินและเวลาในตัวอย่างสร้างคำสั่งซื้อ amount และ reqTime เป็นจำนวนเต็ม อย่าให้กลายเป็นข้อความมีจุดทศนิยม
พารามิเตอร์ทางเลือกพารามิเตอร์ที่ลงลายเซ็นต้องตรงกับที่ส่ง อย่าเติมค่าเริ่มต้นเพียงฝั่งเดียว
ค่าพิเศษข้อความมีแต่ช่องว่าง บูลีน ชนิดซับซ้อน และกรณีขอบเขตของอักขระพิเศษ ให้ฝ่ายเทคนิคยืนยันตอนทดสอบร่วม

แนะนำรวมการเตรียมพารามิเตอร์ ลงลายเซ็น และส่งไว้ในโมดูลหลังบ้านเดียวกัน การดีบักบันทึกชื่อช่องกับสรุปที่ปกปิดแล้ว ไม่บันทึกข้อความก่อนลงลายเซ็นที่มีกุญแจเต็มต่อท้าย และไม่วางฟังก์ชันลายเซ็นบนหน้าเว็บ

สร้างเวลาปัจจุบันหน่วยมิลลิวินาทีทุกคำขอ

reqTime เป็นเวลา Unix หน่วยมิลลิวินาที ค่าเริ่มต้นยอมให้คลาดจากนาฬิกาเซิร์ฟเวอร์ 5 นาที เวลาแบบวินาที เวลาคงที่ในตัวอย่าง หรือใช้ลายเซ็นเก่าหลังรอในคิวอาจทำให้ล้มเหลว

รักษาเวลาของเซิร์ฟเวอร์ให้ตรงกัน เมื่อสอบถามใหม่ให้สร้างเวลาใหม่และคำนวณลายเซ็นใหม่ แต่ยังใช้หมายเลขเดิมค้นคำสั่งซื้อ สร้างรายการหมดเวลารอให้สอบถามเดิมก่อน การลองสร้างใหม่ได้อย่างปลอดภัยหรือไม่ขึ้นกับผลสอบถามและกฎที่ยืนยันในการเชื่อมต่อ

ตรวจลายเซ็น callback และตรวจผลตอบกลับ

ใน JSON Body ของ callback มาตรฐาน ช่อง sign ใช้การเรียงและเชื่อมช่องไม่ว่างกับ MD5 ตัวพิมพ์เล็กเช่นกัน แต่เลือกกุญแจแยกที่ตั้งไว้ก่อนคือ CALLBACK_SECRET หากไม่ได้ตั้งค่าจึงใช้ MD5_SECRET ดูรายละเอียดที่ ตรวจลายเซ็น callback และส่งมอบแบบป้องกันผลซ้ำ。

เก็บค่าช่องที่ได้รับเดิมเพื่อตรวจลายเซ็นก่อน แล้วค่อยแปลงทางธุรกิจ อย่าแปลงสตริง 00 เป็นตัวเลข 0 หรือเปลี่ยน 10.00 เป็น 10。

ช่องในผลตอบกลับ sign และวิธีจัดการส่วนหัวลายเซ็น callback เพื่อความเข้ากันได้ ให้ฝ่ายเทคนิคยืนยันตอนเปิดและทดสอบบริการ ผลตอบกลับที่มีโครงสร้างซ้อน data ห้ามสมมติว่าใช้ฟังก์ชันคำขอแบบแบนได้ตรง ๆ และอย่าอนุมานอัลกอริทึมส่วนหัวที่เข้ากันได้เอง

บทความนี้เรียบเรียงตามข้อกำหนดเชื่อมต่อ 稳付pay ก่อนใช้งานจริง ให้ใช้พารามิเตอร์ทดสอบที่ปกปิดข้อมูลชุดเดียวกันตรวจข้อความก่อนลงลายเซ็นและค่าแฮชกับฝ่ายเทคนิค เพื่อให้แน่ใจว่าสองฝั่งทำตรงกัน

ยืนยันการเชื่อมต่อให้ตรงธุรกิจของคุณ

แจ้งสินค้า ปริมาณคำสั่งซื้อ วิธีชำระเงิน และความต้องการชำระยอด เพื่อยืนยัน API เส้นทางเงิน และการจัดการปัญหาทีละข้อ

ติดต่อ 稳付pay ↗