V兔API开放平台

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

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

全部

在线测试

获取支付收款码

接口地址： http://api.vv-tool.com/tool/accounts/payment-qr-code

接口介绍： 每个商户 id（商户号）对应的收款方式是唯一的(收款方式包含：支付宝收款，微信收款，银联收款等等) 点击查看详情

请求方式： GET

返回格式： JSON

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

频率限制： 10 次/秒

请求头参数

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

请求参数

名称	类型	是否必须	备注	其他信息
order_price	string	必须	支付价格	单位:分比如：100 代表支付1元
merchant_num	string	必须	商户号	唯一识别，每个商户id对应的收款方式是唯一的(收款方式包含:支付宝收款，微信收款，银联收款等等)
relation_order_number	string	必须	订单编号，客户自定义，6-32位字符串	商户号下面的该支付编号必须唯一，否则要出现多个相同订单，造成损失
order_title	string	选填	订单标题	出售的商品名和提供的服务名称

请求示例

order_price:1
merchant_num:xxxxxx
relation_order_number:xxxx
order_title:测试

请求示例代码

cURL请求代码示例

curl --location --request GET 'http://api.vv-tool.com/tool/accounts/payment-qr-code?order_price=1&merchant_num=xxxxxx&relation_order_number=xxxx&order_title=%E6%B5%8B%E8%AF%95' \
--header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx' \
--header 'Content-Type: application/json' \
--header 'Cookie: PHPSESSID=mth4t5m7isi67jnmo0bht71bll; _csrf=82c3116d49752523f1e15d1dd2b5765faff3d8cb70aa02e3c3803ab1ad71508ea%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22QT-w_k2auqzWA_h-TmEYBmTI_-2ow9QT%22%3B%7D' \
--data-raw '{
    "orderPrice":"1",
    "merchantNum":"xxxxxx",
    "relationOrderNumber":"xxxx",
    "orderTitle":"xx"
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/accounts/payment-qr-code?order_price=1&merchant_num=xxxxxx&relation_order_number=xxxx&order_title=%E6%B5%8B%E8%AF%95',
  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_POSTFIELDS =>'{
    "orderPrice":"1",
    "merchantNum":"xxxxxx",
    "relationOrderNumber":"xxxx",
    "orderTitle":"测试"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx',
    'Content-Type: application/json',
    'Cookie: PHPSESSID=mth4t5m7isi67jnmo0bht71bll; _csrf=82c3116d49752523f1e15d1dd2b5765faff3d8cb70aa02e3c3803ab1ad71508ea%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22QT-w_k2auqzWA_h-TmEYBmTI_-2ow9QT%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/payment-qr-code?order_price=1&merchant_num=xxxxxx&relation_order_number=xxxx&order_title=测试")
  .method("GET", null)
  .addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "PHPSESSID=mth4t5m7isi67jnmo0bht71bll; _csrf=82c3116d49752523f1e15d1dd2b5765faff3d8cb70aa02e3c3803ab1ad71508ea%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22QT-w_k2auqzWA_h-TmEYBmTI_-2ow9QT%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数名	返回值类型	备注	其他信息
code	int	返回状态码	0 表示成功
msg	string	返回码描述	错误描述数据
msec	int	接口执行时间
time	int	接口返回时间
data	object []	数据信息	返回失败为空字符的字符串类型，成功则是数组
----qrcode_url	string	收款二维码链接
----order_number	string	平台订单号(需要记录下来，后面查询订单信息需要用到该字段)
----withholding_money	int	该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "成功",
    "msec": 1193,
    "time": 1612416107,
    "data": {
        "qrcode_url": "https://qr.alipay.com/xxxxxxxxx",
        "order_number": "2021051813571xxxxxxxxx",
        "withholding_money": 0
    }
}

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