V兔API开放平台

电商工具接口电商导购接口物流发货接口

全平台ERP 仓库WMS 线上支付电商周边

全部

在线测试

获取支付订单信息接口

接口地址： http://api.vv-tool.com/tool/accounts/merchant-order-detail

接口介绍： 该接口是主动查询，通过平台支付订单编号查询订单记录(支付金额，支付编号，支付方式等等)，可以联系运行填写支付的回调地址。点击查看详情

请求方式： GET

返回格式： JSON

接口收费： 开通一次秘钥，终身免费

频率限制： 10 次/秒

请求头参数

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

请求参数

参数名	是否必须	返回值类型	备注	其他信息
order_number	是	string	订单编号	商户自己定义的订单号或平台订单号
merchant_num	是	string	商户号	唯一识别，每个商户 id 对应的收款方式是唯一的(收款方式包含：支付宝收款，微信收款，银联收款)
type	是	订单编号类型	string	1.商户自己定义的订单号，对应的字段：relationOrderNumber 2.平台订单号，对应的字段：order_number

请求示例

order_number:3xxxxxxx
merchant_num:1xxxxx
type:1

请求示例代码

cURL请求代码示例

curl --location --request GET 'http://api.vv-tool.com/tool/accounts/merchant-order-detail?order_number=3xxxxxxx&merchant_num=1xxxxx&type=1' \
--header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx' \
--header 'Cookie: PHPSESSID=mth4t5m7isi67jnmo0bht71bll; _csrf=d8c9c7bc48a9600c3ff852d8034415f4112edad8caf619d926926d74cfbf046ba%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22GksmKP3g33mSMU3Sctbnra3GYQ_eLefl%22%3B%7D'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/accounts/merchant-order-detail?order_number=3xxxxxxx&merchant_num=1xxxxx&type=1',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx',
    'Cookie: PHPSESSID=mth4t5m7isi67jnmo0bht71bll; _csrf=d8c9c7bc48a9600c3ff852d8034415f4112edad8caf619d926926d74cfbf046ba%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22GksmKP3g33mSMU3Sctbnra3GYQ_eLefl%22%3B%7D'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/accounts/merchant-order-detail?order_number=3xxxxxxx&merchant_num=1xxxxx&type=1")
  .method("GET", null)
  .addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Cookie", "PHPSESSID=mth4t5m7isi67jnmo0bht71bll; _csrf=d8c9c7bc48a9600c3ff852d8034415f4112edad8caf619d926926d74cfbf046ba%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22GksmKP3g33mSMU3Sctbnra3GYQ_eLefl%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数名	返回值类型	备注	其他信息
code	int	返回状态码	0 表示成功
msg	string	返回码描述
msec	int	接口执行时间
time	int	接口返回时间
data	object []	数据信息	返回失败为空字符的字符串类型，成功则是数组
----merchant_num	string	商户编号
----merchant_name	string	商户名称
----terminal_num	string	终端号	绑定收款设备
----cashier_num	string	收银员编号	绑定收款设备
----trans_card_num	string	用户标识，微信为 openid，支付宝为交易卡号
----channel_type	string	通道名称
----promotion_detail	string	微信回传优惠信息
----alipay_coupon_detail	string	支付宝回传优惠信息
----attach	string	附件信息
----relation_order_number	string	商户订单号	商户自己定义的订单号
----order_number	string	平台订单号
----order_price	number	订单金额	单位：分
----order_realy_price	number	用户实付金额	单位：分
----order_status	number	订单状态	0 未支付 1 已支付 2 已退款 3 已取消
----order_type	number	订单类型	1 微信 2 支付宝 3 百度钱包 4 沃支付 5 翼支付 6 云闪付 7 刷卡 8QQ 钱包
----order_notify_url	string	订单回调地址	用户回调地址找运营进行绑定或在后台进行绑定
----order_notify_status	number	回调状态	0 未回调 1 已回调
----official_order_number	string	官方交易编号	包含支付宝交易编号，微信交易编号，银行交易编号
----order_pay_at	string	支付时间	格式 yyyy-MM-dd HH:mm:ss
----created_at	string	创建时间	格式 yyyy-MM-dd HH:mm:ss
----order_title	string	订单标题

返回数据

{
    "code": 0,
    "msg": "成功",
    "msec": 1324,
    "time": 1621322843,
    "data": {
        "relation_order_number": "3xxxxxxx",
        "order_number": "202105151321162105xxxxxx",
        "order_price": 1,
        "order_realy_price": 0,
        "order_status": 0,
        "order_type": 3,
        "order_notify_url": "http://www.baidu.com",
        "order_notify_status": 0,
        "official_order_number": "",
        "order_pay_at": null,
        "created_at": "2021-05-15T05:21:49.000000Z",
        "order_title": "充值",
        "merchant_num": "1xxxxx",
        "merchant_name": "xx",
        "terminal_num": "xx",
        "cashier_num": "xx",
        "trans_card_num": "xx",
        "channel_type": "xx",
        "promotion_detail": "xx",
        "alipay_coupon_detail": "xx",
        "attach": "xx",
        "withholding_money": 0
    }
}

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
202	系统错误，请稍后再试	稍后重试，或者联系对接群
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
401	身份凭证无效	在请求头中添加 access_token，重新更新 token
404	请求路径或请求方式错误	请更换请求方式或者检查路径是否正确