## **數據格式及數據簽名說明** **通知數據** - 采 用 HTTP 標 準 的 POST 協 議 （ 請 使 用 application/x-www-form-urlencoded 此Content-Type 接收通知消息），為了保證數據正確性、準確性，數據必須驗證簽名。 - 返回數據(支付成功通知如下) ``` <leshua> <error_code>0<error_code> <amount>1<amount> <attach>0<attach> <bank_type>ALIPAYACCOUNT<bank_type> <buyer_pay_amount><buyer_pay_amount> <channel_datetime>2018-12-07 22:42:39<channel_datetime> <channel_order_id>7551000001201812073279154152<channel_order_id> <coupon>0<coupon> <discount_amount>0<discount_amount> <goods_tag><goods_tag> <leshua_order_id>1812072242293655<leshua_order_id> <merchant_id>0000000018<merchant_id> <openid>2088032562556921<openid> <out_transaction_id>2018120722001456935441223102<out_transaction_id> <pay_time>2018-12-07 22:42:39<pay_time> <pay_way>ZFBZF<pay_way> <royalty>0<royalty> <settlement_amount>1<settlement_amount> <sign>0b574d40e722ec76b55d4e8795f71182<sign> <status>2<status> <sub_openid><sub_openid> <third_order_id>20181207224223102101<third_order_id> <trade_type>NATIVE<trade_type> <leshua> ``` ---- **數據簽名** - 為了保證數據傳輸過程中的數據真實性和完整性，我們需要對數據進行數字簽名，在接收簽名數據之后進行簽名校驗。 - 數字簽名有兩個步驟，先按一定規則拼接要簽名的原始串，再選擇具體的算法和密鑰計算出簽名結果。 **簽名數據規則如下**： - 簽名原始串按以下方式組裝成字符串（不包含簽名 Key）： 1. 請求：除 sign 字段外，所有參數按照字段名的 ascii 碼從小到大排序后使用QueryString 的格式（即 key1=value1&key2=value2…）拼接而成，空值不傳遞，不參與簽名組串。 2. 應答：除 sign、leshua、resp\_code 字段外，所有參數按照字段名的 ascii 碼從小到大排序后使用 QueryString 的格式（即 key1=value1&key2=value2…）拼接而成，空值參與簽名組串。 3. 簽名原始串中，字段名和字段值都采用原始值，不進行 URL Encode。 **簽名算法如下**： - 目前只支持 MD5 簽名算法。 - 交易報文 MD5 計算：sign = MD5(3.1 組裝的字符串&key=商戶交易密鑰).toUpperCase()。 - 通知報文 MD5 計算：sign = MD5(3.1 組裝的字符串&key=商戶通知密鑰).toLowerCase()。 **注**: - 所有涉及到金額的單位都位分，幣種為 RMB，最小為 1 分，不允許出現小數。 - 返回參數中必填為是的參數是一定會返回的，必填為否的參數則不一定返回，因升級或配置等情況實際返回參數可能不會跟文檔完全一致，必須以實際接收到的參數為準。