交易预请求

POST https://api.4pyun.com/gate/1.0/payment/trade/prepare

接口说明

1. app_id,app_secret 用户身份id和加密密钥由平台方提供，对接方需提供公司全称然后给到商务提交给研发申请
2. 无感支付场景必须传递extra具体参考测试用例
3. deduct_mode是无感状态同步接口返回的值，该值平台不关注具体值是多少,对接方也无需关心，微信或者支付宝透传给平台，平台再透传给调用方调用方再透传给到微信或者支付宝
4. 该接口必须后端发起请求不能直接在前端调用该接口
5. 历史小程序插件(新对接已经不再支持)`callback_url`在小程序调用场景，仅支持当前小程序内页面跳转，需传入例如`/pages/index/index`！
 6. 半屏小程序`callback_url`在小程序调用场景不需要传递 页面回调参考半屏小程序部分文档说明

请求参数

交易事项

请求示例

签名前字符串
1.1：签名前字符串
  str=app_id=op0096196358123123&body=【川A12345】在【XXXXX-停车场】于【2021-07-01 00:00:00】支付费1.00元&callback_url=https://a.b.c/backurl&channel=200201&extra={"plate_color":"-1","parking_serial":"01009970545516206225805859659","plate":"川AA37K2","enter_time":"1620621689000","park_name":"P云支付体验-停车场","parking_time":"175"}&merchant=62626601&notify_url=https://a.b.c/notify&pay_order=11111111118&subject=停车支付3.00元(川A12345)&value=10&app_secret=6409292d66625a2a12342134
1.2：MD5(str)
  sign=96FD052F81BBB3C25B5BD628E189A154
        @Test
  public void testPaymentPrepare(){
  TreeMap<String, String> map = new TreeMap<>();
  // app_id平台分配
  map.put("app_id", "op0096196358123123");
  // 停车场商户号
  map.put("merchant", "62626601");
  // 发起支付订单号同一个app_id下唯一不能重复
  map.put("pay_order", "11111111118");
  // 商品名称
  map.put("subject","停车支付3.00元(川A12345)");
  // 商品描述
  map.put("body","【川A12345】在【XXXXX-停车场】于【2021-07-01 00:00:00】支付费1.00元");
  // 支付金额, 单位分
  map.put("value","10");
  // 支付成功返回前端页面
  map.put("callback_url", "https://a.b.c/backurl");
  // 后端支付回调地址
  map.put("notify_url", "https://a.b.c/notify");
  Map<String, String> extraMap = new HashMap<>();
  extraMap.put("plate", "川AA37K2");
  extraMap.put("plate_color", "-1");
  extraMap.put("parking_serial", "01009970545516206225805859659");
  extraMap.put("park_name", "P云支付体验-停车场");
  extraMap.put("enter_time", "1620621689000");
  extraMap.put("parking_time", "175");
  map.put("extra", JSON.toJSONString(extraMap));
  StringBuilder builder = new StringBuilder();
  for (String key : map.keySet( {
  builder.append(key + "=" + map.get(key + "&");
  }
  String appSecret = "6409292d66625a2a12342134";
  String encriptStr = builder.toString( + "app_secret=" + appSecret;
  System.out.println(encriptStr);
  String sign = MD5.encryptHEX(encriptStr);
  String keyStr = builder.toString( + "sign=" + sign;
  System.out.println(keyStr);
  try {
  Form form = Form.form();
  for (String key : map.keySet( {
  form.add(key, map.get(key));
  }
  form.add("sign", sign);
  Response response = Request.Post("https://api.4pyun.com/gate/1.0/payment/trade/prepare")
  .bodyForm(form.build(), Charset.forName("utf-8"))
  .execute();
  HttpResponse response1 = response.returnResponse();
  System.out.println(response1.getStatusLine());
  String text = IOUtils.toString(response1.getEntity().getContent(), "utf-8");
  System.out.println(text);
  } catch (IOException e {
  e.printStackTrace();
  }
  }

请求返回结果参数说明

请求返回结果示例:

成功返回
{
    "code": "1001",
    "seqno": "92a78431551bd293",
    "data_node": "CN-South/HS3-1",
    "pay_url": "https://app.4pyun.com/payment/trade/create?pay_id=621722601479223111111111",
    "pay_id": "621722601479223111111111"
}

参数错误
{
    "code": "400",
    "message": "请求参数错误",
    "hint": "`merchant` Required!",
    "seqno": "94929a9b0874aa46",
    "data_node": "CN-South/HS3-2",
    "path": "POST /gate/1.0/payment/trade/prepare"
}

扣款错误
{
    "code": "500",
    "message": "订单号已存在",
    "seqno": "93128ddd750dc90e",
    "data_node": "CN-South/HS3-3",
    "path": "POST /gate/1.0/payment/trade/prepare"
}