交易查询

查询正式交易接口

get

查询正式交易接口

Required scopes

This endpoint requires the following scopes:

Authorizations

Authorization

AuthorizationstringRequired

Query parameters

endTimestring(19)Required

结束时间，开始时间与结束时间最大不能超过半年的时间间隔；固定长度为19，如：2022-01-01T23:59:59

gatewayNointeger(8)Optional

网关号；固定长度8位，如：10001001

orderNostring(64)Optional

商户订单号；当流水订单号为空时，则该字段时必须的；最小长度为1，最大长度为64，如：12167001000000000001

pageIndexinteger(10)Optional

当前页，默认第一页；最大长度为10，如：1

pageSizeinteger(10)Optional

每页大小，默认每页100条数据，最大1000条；最大长度为10，如：100

startTimestring(19)Required

交易开始时间，开始时间与结束时间最大不能超过半年的时间间隔；固定长度为19，如：2022-01-01T00:00:00

tradeNostring(64)Optional

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

uploadGoodsFlaginteger(1)Optional

是否上传商品信息（0：否，1：是）；固定长度为 1

uploadLogisticsFlaginteger(1)Optional

是否上传物流标识（0：否，1：是）；固定长度为 1

Header parameters

authorizationanyRequired

ACCESS_TOKEN，格式：Bearer ACCESS_TOKEN

request-idstring(20)Required

请求id，最小长度为1，最大长度为20，30分钟之内唯一

request-timestring(19)Required

请求时间，时间格式为 yyyy-MM-dd'T'HH:mm:ss ，请求误差不能超过30分钟

Responses

200

OK

*/*response body

get

/openApi/transactions

HTTPcURLJavaScriptPython

GET /openApi/transactions?endTime=null&startTime=null HTTP/1.1
Host: {openApiUrl}
Authorization: YOUR_API_KEY
authorization: null
request-id: null
request-time: null
Accept: */*

200

OK

{
  "data": {
    "list": [
      [
        {
          "authStatus": 3,
          "gatewayNo": 10001001,
          "goods": {
            "goodsName": "iPhone13 红色",
            "goodsNum": 2,
            "goodsPrice": 6499
          },
          "isUploadReceipt": 1,
          "logistics": {
            "lcCode": "TWTH",
            "logisticsStatus": "Delivered",
            "trackingNo": 1223212312,
            "trackingWeb": "https://abc.com"
          },
          "merNo": 10001,
          "orderNo": 12167001000000000000,
          "sourceWebSite": "www.asiabill.com",
          "tradeAmount": 100.12,
          "tradeCurrency": "USD",
          "tradeDate": "2021-04-12T00:00:00",
          "tradeInfo": "tradeInfo",
          "tradeNo": 2.0210507155918938e+21,
          "tradeStatus": 1
        }
      ]
    ],
    "page": {
      "pageIndex": 1,
      "pageSize": 100,
      "total": 1000
    }
  },
  "result": {
    "code": "text",
    "message": "text"
  }
}

交易流水查询请求报文示例

transaction.sh

curl --request GET\
  --url https://{openApiUrl}/openApi/transactions?gatewayNo=12345001&endTime=2022-05-21T23:59:59&pageIndex=1&pageSize=1000&startTime=2022-02-21T00:00:00&tradeNo=&uploadGoodsFlag=&uploadLogisticsFlag=&orderNo= \
  --header 'request-id: 58675' \
  --header 'request-time: 2022-05-21T23:59:59' \
  --header 'authorization:Bearer 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822'

结果对象属性描述

property name	type	description
result	Object	请求响应对象
code	String	响应码
message	String	响应信息
data	Object	数据体
page	Object	分页对象
total	Integer	总记录条数
pageSize	Integer	每页记录条数
currentPageNo	Integer	当前页
list	Array	列表
merNo	Integer	商户号
gatewayNo	Integer	网关号
orderNo	String	商户订单号
tradeNo	String	交易流水号
tradeDate	String	交易时间（时间格式为：yyyy-MM-dd'T'HH:mm:ss）
tradeAmount	double	交易金额
tradeCurrency	String	交易币种
sourceWebSite	String	来源网址
authStatus	String	预授权状态 0：普通交易 1：预授权取消 2：预授权待处理 3：预授权完成
isUploadReceipt	String	是否上传物流订单号：yes、no
isUploadGoods	String	是否上传商品信息：yes、no
tradeStatus	String	交易状态： pending：待处理 fail：失败 success：成功
tradeInfo	String	交易信息
goods	Object	商品对象
goodsName	String	商品名称
goodsNum	String	商品数量
goodsPrice	String	商品单价
logistics	Object	物流对象
lcCode	String	物流运输商编号
logisticsStatus	String	物流状态，Pending待查询、NotFound 查询不到 、InfoReceived 预报发货 、InTransit 运输途中 、ArrivedDelivery 到达待取 、Delivering 派送途中、Delivered 成功派送、Exception 包裹异常、DeliveryFailure 投递失败、Return 包裹退回、NotOnline 未上线、 Timeout 轨迹超时
trackingNo	String	物流订单号
trackingWeb	String	物流网址

订单信息请求报文示例

paymentMethodInfo.sh

curl --request GET\
  --url https://{openApiUrl}/openApi/paymentMethodInfo/2022051810582957553787 \
  --header 'request-id: 58675' \
  --header 'request-time: 2022-05-21T23:59:59' \
  --header 'authorization:Bearer 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822'

支付方式信息查询

get

Required scopes

This endpoint requires the following scopes:

Authorizations

Authorization

AuthorizationstringRequired

Path parameters

tradeNostring(64)Required

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

Header parameters

authorizationanyRequired

ACCESS_TOKEN，格式：Bearer ACCESS_TOKEN

request-idstring(20)Required

请求id，最小长度为1，最大长度为20，30分钟之内唯一

request-timestring(19)Required

请求时间，时间格式为 yyyy-MM-dd'T'HH:mm:ss ，请求误差不能超过30分钟

Responses

200

OK

*/*response body

get

/openApi/paymentMethodInfo/{tradeNo}

HTTPcURLJavaScriptPython

GET /openApi/paymentMethodInfo/{tradeNo} HTTP/1.1
Host: {openApiUrl}
Authorization: YOUR_API_KEY
authorization: null
request-id: null
request-time: null
Accept: */*

200

OK

{
  "data": {
    "billAddress": "billAddress",
    "billCity": "billCity",
    "billCountry": "US",
    "billDescriptor": "shipLastName",
    "billEmail": "[e-mail]",
    "billPostcode": 81000000,
    "billState": "billState",
    "binCountry": "US",
    "cardNo": "404881******2341",
    "cardType": 1,
    "crossCountryPayment": "yes",
    "firstName": "firstName",
    "gatewayNo": 10001001,
    "highRiskCountry": 0,
    "ipAddress": "10.25.36.35",
    "ipCity": "ipCity",
    "ipCountry": "US",
    "issuingBank": "Test",
    "lastName": "lastName",
    "localPaymentLink": "shipLastName",
    "merNo": 10001,
    "paymentMethod": "Credit Card",
    "phone": 1545487565144,
    "platform": "shipLastName",
    "shipAddress": "shipAddress",
    "shipCity": "shipCity",
    "shipCountry": "US",
    "shipFirstName": "shipFirstName",
    "shipLastName": "shipLastName",
    "shipPhone": 1545487565144,
    "shipPostcode": "shipLastName",
    "shipState": "shipState",
    "sourceWebSite": "www.asiabill.com",
    "tradeNo": 2.0210507155918938e+21
  },
  "result": {
    "code": "text",
    "message": "text"
  }
}

结果对象属性描述

code	String	响应码
message	String	响应信息
data	Object	数据体
tradeNo	String	流水订单号
phone	String	客户电话
firstName	String	客户名
lastName	String	客户姓
billCountry	String	账单国
billState	String	州
billCity	String	城市
billAddress	String	地址
billEmail	String	邮箱
billPostcode	String	客户邮编
ipAddress	String	IP地址
ipCountry	String	IP国家
ipCity	String	IP城市
sourceWebSite	String	交易网址
cardType	String	支付卡种: VISA,MASTER,JCB,AE,DiSCOVER,UNIONPAY
cardNo	String	卡号
issuingBank	String	发卡行
crossCountryPayment	Integer	跨国支付, 0:否 1:是
highRiskCountry	Integer	高风险国家 0:否 1:是
binCountry	String	真实发卡国
paymentMethod	String	支付方式
shipFirstName	String	收件人名
shipLastName	String	收件人姓
shipPhone	String	收件人电话
shipCountry	String	收件人国家
shipState	String	收件人州
shipCity	String	收件人城市
shipAddress	String	收件人地址
shipPostcode	String	收件人邮编
localPaymentLink	String	本地支付链接
billDescriptor	String	账单地址
platform	String	商户平台