Authorization

授权确认以及取消

预授权完成/撤销接口

V2022-03预授权确认接口

post

/V2022-03/AuthorizeInterface

Header parameters

gateway-nostring(16)required

网关号

request-idstring(64)required

请求id，30分钟之内唯一

request-timestring(16)required

时间戳，以毫秒（ms）为单位，请求误差不能超过10分钟

sign-infostring(255)required

验签字段，具体加签方式请参阅数据签名过程章节

Body

authTypestring(1)required

授权类型； 2：表示撤销授权; 1：表示完成授权；固定长度为1，如：1

Example: 1

operatorstring(20)

操作者；最大长度为20，如：admin

Example: admin

remarkstring(500)

备注；最大长度为500，如：capture

Example: capture

tradeNostring(64)required

交易流水号；最小长度为1，最大长度为64，如：2022022416544064513805

Example: 2022022416544064513805

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'http://{paymentApiUrl}/V2022-03/AuthorizeInterface' \
  --header 'gateway-no: null' \
  --header 'request-id: null' \
  --header 'request-time: null' \
  --header 'sign-info: null' \
  --header 'Content-Type: application/json' \
  --data '{
    "authType": 1,
    "operator": "admin",
    "remark": "capture",
    "tradeNo": "2022022416544064513805"
  }'

200

200

{
  "code": "success",
  "message": "message response",
  "data": {
    "orderInfo": "is a success order",
    "orderNo": 12167001000000000000,
    "orderStatus": "success",
    "tradeNo": "2022022416544064513805"
  }
}

OK

预授权完成/撤销接口请求报文示例

curl --request POST \
  --url https://{paymentApiUrl}/V2022-03/AuthorizeInterface \
  --header 'Content-Type: application/json' \
  --header 'request-id: 58675' \
  --header 'request-time: 1651888520935' \
  --header 'gateway-no: 12345001' \
  --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \
  --data '{
    "authType": "2",
    "operator": "jmtest01",
    "remark": "remark1",
    "tradeNo": "2022051812003328329425"
}'

结果对象属性描述

property name	type	description
code	String	返回码
message	String	返回信息
data
tradeNo	String	交易流水号
orderNo	String	商户订单号
orderStatus	String	【授权状态】 待处理：pending 成功：success 失败：fail
orderInfo	String	授权操作返回信息