全部產品
Search
文件中心

Mobile Platform as a Service:trade.create

更新時間:Sep 02, 2025

建立交易,擷取交易號,使用小程式方法(my.tradePay)完成支付流程。

公用請求參數

參數

類型

是否必選

最大長度

描述

樣本值

app_id

String

必選

32

小程式 id

2014072300007148

method

String

必選

128

介面名稱

trade.create

format

String

可選

40

僅支援 JSON

JSON

charset

String

必選

10

請求使用的編碼格式,如 utf-8,gbk,gb2312 等

utf-8

sign_type

String

必選

10

商戶產生簽名字串所使用的簽名演算法類型,目前支援 RSA2 和 RSA,推薦使用 RSA2

RSA2

sign

String

必選

344

商戶請求參數的簽名串,詳見簽名

詳見樣本

timestamp

String

必選

19

發送請求的時間,格式 yyyy-MM-dd HH:mm:ss

2014-07-24 03:07:50

version

String

必選

3

調用的介面版本,固定為:1.0

1.0

biz_content

String

必選

-

請求參數的集合,最大長度不限,除公用參數外所有請求參數都必須放在這個參數中傳遞,具體參照各產品快速接入文檔

-

業務請求參數

參數

類型

是否必選

最大長度

描述

樣本值

out_trade_no

String

必選

64

商戶訂單號,由商家自訂,64 個字元以內,僅支援字母、數字、底線且需保證在商戶端不重複

20150320010101001

total_amount

String

必選

9

訂單總金額。

單位為元,精確到小數點後兩位,取值範圍:[0.01,100000000]

88.88

subject

String

必選

256

訂單標題。

重要

不可使用特殊字元,如 /,=,& 等。

iPhone6 16G

product_code

String

必選

64

小程式情境支付:JSAPI_PAY

JSAPI_PAY

op_app_id

String

必選

32

小程式支付中,商戶實際經營主體的小程式應用的 appid,也即最終喚起收銀台支付所在的小程式的應用id

2014072300007148

buyer_open_id

String

必選

128

買家使用者唯一標識

074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5

body

string

可選

128

訂單附加資訊。

如果請求時傳遞了該參數,將在非同步通知、對賬單中原樣返回,同時會在商戶和使用者的 pc 賬單詳情中作為交易描述展示

iPhone6 16G

常見請求樣本

預設樣本:

curl 'https://xxxx/gateway.do?charset=UTF-8&method=trade.create&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=RSA2&timestamp=${now}' \
 -F 'biz_content={
	"out_trade_no":"20150320010101001",
	"product_code":"JSAPI_PAY",
	"op_app_id":"2014072300007148",
	"total_amount":"88.88",
	"subject":"iphone6 16G",
	"body":"iphone6 16G",
	"buyer_open_id":"074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5"
}' 
說明

本樣本僅供參考。

公用響應參數

參數

類型

是否必選

最大長度

描述

樣本值

code

String

必選

-

網關返回碼

40004

msg

String

必選

-

網關返回碼描述

Business Failed

sub_code

String

可選

-

業務返回碼,參見具體的 API 介面文檔

ACQ.TRADE_HAS_SUCCESS

sub_msg

String

可選

-

業務返回碼描述,參見具體的 API 介面文檔

交易已被支付

sign

String

必選

-

簽名

DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo=

業務響應參數

參數

類型

是否必選

最大長度

描述

樣本值

out_trade_no

String

必選

64

商戶訂單號

20150423001001

trade_no

String

必選

64

Payme 交易號

2015042321001004720200028594

響應樣本

{
    "trade_create_response": {
        "code": "10000",
        "msg": "Success",
        "out_trade_no": "20150423001001",
        "trade_no": "2015042321001004720200028594"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}