V兔API开放平台

参数	类型	必选	描述
shop_id	string	是	店铺 ID
tid	Number	是	交易编号
memo	string	否	交易备注。最大长度： 1000 个字节
flag	string	否	交易备注旗帜，可选值为：0(灰色), 1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色)，默认值为 0
vvtype	int	否	普通版 1，不传默认 1，增强版 2，增强版的需要传参 2，标准版 3,需要标准版的传 3，减版 4,需要减版的传 4

请求示例

tid:123456789
shop_id:123
memo:交易备注
flag:1

请求代码示例

cURL请求代码示例


curl --location --request POST "http://api.vv-tool.com/tool/erps/memo" \
--header "Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx" \
--header "Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D" \
--form "tid="123456789"" \
--form "memo="交易备注"" \
--form "shop_id="123"" \
--form "flag="1""

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://api.vv-tool.com/tool/erps/memo",
  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 => array("tid" => "123456789","memo" => "交易备注","shop_id" => "123","flag" => "1"),
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx",
    "Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("tid","123456789")
  .addFormDataPart("memo","交易备注")
  .addFormDataPart("shop_id","123")
  .addFormDataPart("flag","1")
  .build();
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/memo")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Cookie", "__yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数	类型	描述
url	string	url
code	int	错误码 0 为成功
msg	string	返回码描述
msec	int	接口执行时间
time	int	接口返回时间
tid	int	交易编号 (父订单的交易编号)
created	Date	交易创建时间。格式：yyyy-MM-dd HH:mm:ss
withholding_money	int	该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1046,
    "time": 1617262617,
    "data": {
		    "withholding_money": 1, 
        "modified": "2021-04-01 15:36:57",
        "tid": "123456789"
    }
}

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
202	系统错误，请稍后再试	稍后重试，或者联系对接群
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权
401	身份凭证无效	在请求头中添加 access_token，重新更新 token
404	请求路径或请求方式错误	请更换请求方式或者检查路径是否正确
614	交易不存在	请填写正确的订单号
614	参数无效，格式不对、非法值、越界等	请填写正确的参赛
614	必须是此交易的卖家或买家才能添加交易备注	查看是否程序出问导致添加交易备注的交易不属于该卖家，出现错误不要重试
614	不支持子订单[XXXXXXXXXXX]操作	去调用订单列表或者明细获取 tid 字段