获取支付订单信息接口

接口地址: http://www.damaijia168.com/vv/external/getOrderDetail

---

请求方式：POST

---

传参方式：JSON

---

返回格式：JSON

请求头参数

参数	类型	必选	值	示例
Authorization	string	是	授权 access_token	1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数	类型	必选	描述
orderNumber	string	是	订单编号 商户自己定义的订单号(relationOrderNumber)或平台订单号(orderNumber)
merchantNum	string	是	商户号 此字段唯一，每个商户号只对应一种收款方式(收款方式包含:支付宝收款，微信收款，银联收款等等)
type	string	是	订单编号类型 1:商户自己定义的订单号(relationOrderNumber) 2:平台订单号(orderNumber)

请求示例

{
    "orderNumber":"21************423",
    "merchantNum":"2*****",
    "type":"2"
}

请求示例代码

cURL请求代码示例

curl --location --request POST 'http://www.damaijia168.com/vv/external/getOrderDetail' --header 'Authorization: 493d131b9e696dc897a4233e7ab8****' --header 'Content-Type: application/json' --data-raw '{
    "orderNumber":"21************423",
    "merchantNum":"2*****",
    "type":"2"
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://www.damaijia168.com/vv/external/getOrderDetail',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "orderNumber":"21************423",
    "merchantNum":"2*****",
    "type":"2"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: 493d131b9e696dc897a4233e7ab8****',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"orderNumber\":\"21************423\",\r\n    \"merchantNum\":\"2*****\",\r\n    \"type\":\"2\"\r\n}");
Request request = new Request.Builder()
  .url("http://www.damaijia168.com/vv/external/getOrderDetail")
  .method("POST", body)
  .addHeader("Authorization", "493d131b9e696dc897a4233e7ab8****")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

Python请求代码示例

import requests
import json

url = "http://www.damaijia168.com/vv/external/getOrderDetail"

payload = json.dumps({
    "orderNumber":"21************423",
    "merchantNum":"2*****",
    "type":"2"
})
headers = {
  'Authorization': '1798c6aadec33d1bc2f5b707f1049aefexxxx',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

返回数据

参数名	返回值类型	备注	其他信息
status	string	返回码描述
data	object []	数据信息	返回失败为空字符的字符串类型，成功则是数组
----merchantNum	string	商户号	同入参商户号
----merchantName	string	商户名称
----terminalNum	string	终端号	需要绑定收款设备
----cashierNum	string	收银员编号	需要绑定收款设备
----transCardNum	string	用户标识	微信为openid，支付宝为交易卡号
----channelType	string	通道名称
----promotionDetail	string	微信回传优惠信息
----alipayCoupon_detail	string	支付宝回传优惠信息
----attach	string	附件信息
----relationOrderNumber	string	商户订单号	商户自己定义的订单号
----orderNumber	string	平台订单号
----orderPrice	number	订单金额	单位:分
----orderRealyPrice	number	用户实付金额	单位:分
----orderStatus	number	订单状态	0未支付 1已支付 2已退款 3已取消
----orderType	number	订单类型	1微信 2支付宝 3百度钱包 4沃支付 5翼支付 6云闪付 7刷卡 8QQ钱包
----orderNotifyUrl	string	订单回调地址	回调地址需要通过运营进行绑定或在后台进行绑定
----orderNotifyStatus	number	回调状态	0未回调 1已回调
----officialOrderNumber	string	官方交易编号	包含支付宝交易编号，微信交易编号，银行交易编号
----orderPayAt	string	支付时间	格式yyyy-MM-dd HH:mm:ss
----createdAt	string	创建时间	格式yyyy-MM-dd HH:mm:ss
----orderTitle	string	订单标题
----amount	int	消耗点券	单位:点券

返回示例代码

json格式返回代码示例

{
    "data": {
        "relationOrderNumber": "tes****3",
        "orderNumber": "202105171******1487493",
        "orderPrice": 1,
        "orderRealyPrice": 0,
        "orderStatus": 0,
        "orderType": 2,
        "orderNotifyUrl": "http://test-pay.vv-tool.com/********y/2",
        "orderNotifyStatus": 0,
        "officialOrderNumber": "****",
        "orderPayAt": null,
        "createdAt": "2021-05-17T03:18:07.000000Z",
        "orderTitle": "测试",
        "merchantNum": "22****2",
        "merchantName": "***",
        "terminalNum": "***",
        "cashierNum": "*2***",
        "transCardNum": "**42***",
        "channelType": "****",
        "promotionDetail": "*****",
        "alipayCouponDetail": "****",
        "attach": "******"
    },
    "status": 0
}

错误码

状态码	错误说明
20001	支付订单不存在
1003	用户不存在
132	请求格式必须为JSON
422	参数列表不合法，在err中会给出提示
200	认证失败
202	商品id不合法
203	仓库id不合法
228	订单来源不合法
217	创建订单失败
212	包裹id不合法
209	账户余额不足