1. 创建订单

简要描述

• 当J&T确认支付完成后，向Swifood发送创建订单请求，Swifood会为商户创建订单，并向已连接的打印机推送打印支付小票的指令。

HTTP请求信息

请求URL

• {domain}/open-api/order/jt/create

请求方式

• POST

请求头

参数名	是否必填	类型	说明
Content-Type	是	string	application/json

请求体参数

参数名	是否必填	类型	长度	示例	说明
appId	是	string	-	45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892	应用 id （Swifood 提供）
storeKey	是	string	100	CVIEIYUNHTS0	店铺标识 （Swifood 提供）
param	是	string	-	-	请求参数字符串
sign	是	string	-		param 的RSA签名

Param 参数

参数名	是否必填	类型	长度	示例	说明
productName	是	string	1 - 50	coffee	商品名称
price	是	integer	1 - 1000000	100	商品单价 单位分
quantity	是	integer	1 - 1000	1	商品数量
customPrintContext	否	string	-	Test	商户自定义打印内容
paymentWay	是	string	-	1	支付方式 1：线上 2：线下 （线上方式暂不支持）
paymentChannel	否	string	1 - 200	QRPH_DYNAMIC_QR	支付渠道（线上交易必填）Payment channel list
paymentTransactionId	否	string	1 - 50		支付交易id （PayCools系统 merchantOrderId号 线上交易必填）
paymentAmount	否	integer	1 - 100000000	100	支付金额（实付金额）单位分
discountAmount	否	integer	1 - 100000000	10	折扣金额 单位分

请求体示例

{
  "appId": "123456",
  "storeKey": "123456",
  "sign": "abcdef",
  "param": "{\"productName\":\"item\",\"price\":100,\"quantity\": 1,\"customPrintContext\":\"test custom\",\"paymentWay\": 1,\"paymentTransaction\": \"ON12384876123\",\"paymentAmount\": 100,\"discountAmount\":10}"
}

响应示例

状态码 Refer to this list

响应参数

参数名	类型	示 例	说明
code	integer	10000	状态码 Refer to List
message	string	success	状态码说明
data	string	-	返回的参数

{
  "code": 10000,
  "message": "success",
  "data": "{\"orderNo\":\"TB*******431\"}"
}

失败响应示例

{
    "code":21000,
    "message":"Service error, please contact administrator",
    "data":null
}

支付渠道

渠道名称	渠道 code
QRPH	QRPH_DYNAMIC_QR
GCash WebPay	GCASH_URL
Grab WebPay	GRPY_URL
UnionBank	UBPB_URL
BPI	BPIA_URL
Maya	PAYMAYA_URL
ShopeePay	SHOPEE_URL
UnionBank	UBPB_URL
WechatPay	WECHAT_URL
Alipay	ZFB_URL
GCash QR	GCASH_DYNAMIC_QR
GCash Scan QR	GCASH_CPM
GCash QR	GCASH_DYNAMIC_QR