D1V1网搜索导航

申请收录
首页 > 生活 > 创客购物内容详情
微信支付商户平台商家助手

微信支付商户平台商家助手

所属分类：创客购物

相关标签：

官方网址：https://pay.weixin.qq.com/?ref=www.d1v1.com

SEO查询： 爱站网 站长工具

进入网站

站点介绍

微信支付商户平台商家助手

支付有礼开发指引

1. 接口规则

为了在保证支付安全的前提下，带给商户简单、一致且易用的开发体验，我们推出了全新的微信支付APIv3接口。该版本API的具体规则请参考“APIv3接口规则”
备注：当前接口用于微信国内钱包

2. 开发准备

2.1. 搭建和配置开发环境

为了帮助开发者调用开放接口，我们提供了JAVA、PHP、GO三种语言版本的开发库，封装了签名生成、签名验证、敏感信息加/解密、媒体文件上传等基础功能（更多语言版本的开发库将在近期陆续提供）

测试步骤：

1、根据自身开发语言，选择对应的开发库并构建项目，具体配置请参考下面链接的详细说明：

    • wechatpay-java（推荐）wechatpay-apache-httpclient，适用于Java开发者。

    • wechatpay-php（推荐）、wechatpay-guzzle-middleware，适用于PHP开发者

    注：当前开发指引接口PHP示例代码采用wechatpay-guzzle-middleware版本

    • wechatpay-go，适用于Go开发者

更多资源可前往微信支付开发者社区搜索查看

2、创建加载商户私钥、加载平台证书、初始化httpClient的通用方法


@Before
public void setup() throws IOException {
    // 加载商户私钥（privateKey：私钥字符串）
    PrivateKey merchantPrivateKey = PemUtil
            .loadPrivateKey(new ByteArrayInputStream(privateKey.getBytes("utf-8")));
 
    // 加载平台证书（mchId：商户号,mchSerialNo：商户证书序列号,apiV3Key：V3密钥）
    AutoUpdateCertificatesVerifier verifier = new AutoUpdateCertificatesVerifier(
            new WechatPay2Credentials(mchId, new PrivateKeySigner(mchSerialNo, merchantPrivateKey)),apiV3Key.getBytes("utf-8"));
 
    // 初始化httpClient
    httpClient = WechatPayHttpClientBuilder.create()
            .withMerchant(mchId, mchSerialNo, merchantPrivateKey)
            .withValidator(new WechatPay2Validator(verifier)).build();
}
 
@After
public void after() throws IOException {
    httpClient.close();
}

3、基于接口的示例代码，替换请求参数后可发起测试

说明：

• 上面的开发库为微信支付官方开发库，其它没有审核或者控制下的第三方工具和库，微信支付不保证它们的安全性和可靠性

通过包管理工具引入SDK后，可根据下面每个接口的示例代码替换相关参数后进行快速测试

• 开发者如果想详细了解签名生成、签名验证、敏感信息加/解密、媒体文件上传等常用方法的具体代码实现，可阅读下面的详细说明：

    1.签名生成

    2.签名验证

    3.敏感信息加解密

    4.merchantPrivateKey（私钥）

    5.wechatpayCertificates（平台证书）

    6.APIV3Key（V3 key）

• 如想更详细的了解我们的接口规则，可查看我们的接口规则指引文档

3. 快速接入

3.1. 业务流程图

业务流程时序图：

 

重点步骤说明：

步骤5 商户创建商家券后，可通过《创建全场满额送活动》接口创建支付有礼活动，微信支付生成支付有礼活动并返回活动ID给到商户。

步骤20 支付有礼活动创建后，商户可通过《查询活动详情接口》查询管理活动。

步骤22 活动创建后，如需结束活动，可通过《终止活动》接口，结束活动。

3.2. API接入（含示例代码）

文档展示了如何使用微信支付服务端 SDK 快速接入支付有礼，完成与微信支付对接的部分。

注意：

  • 文档中的代码示例是用来阐述 API 基本使用方法，代码中的示例参数需替换成商户自己账号及请求参数才能跑通。
  • 以下接入步骤仅提供参考，请商户结合自身业务需求进行评估、修改。
3.2.1. 【服务端】创建全场满额送活动

步骤说明：商户可以创建满额送活动，用户支付后送全场券，提升交易额。

示例代码：


public void CreateActivity() throws Exception{
    //请求URL
    HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/unique-threshold-activity");
    // 请求body参数
    String reqdata = "{"
            + "\"activity_base_info\": {"
            + "\"activity_name\":\"良品铺子回馈活动\","
            + "\"activity_second_title\":\"海飞丝的券\","
            + "\"merchant_logo_url\":\"https://tool.oschina.net/regex.jpg\","
            + "\"background_color\":\"COLOR010\","
            + "\"begin_time\":\"2015-05-20T13:29:35+08:00\","
            + "\"end_time\":\"2015-05-20T13:29:35+08:00\","
            + "\"available_periods\": {"
            + "\"available_time\": ["
            + "{"
            + "\"begin_time\":\"2015-05-20T00:00:00+08:00\","
            + "\"end_time\":\"2015-05-20T23:59:59+08:00\""
            + "}"
            + "],"
            + "\"available_day_time\": ["
            + "{"
            + "\"begin_day_time\":\"110000\","
            + "\"end_day_time\":\"135959\""
            + "}"
            + "]"
            + "},"
            + "\"out_request_no\":\"100002322019090134234sfdf\","
            + "\"delivery_purpose\":\"OFF_LINE_PAY\","
            + "\"mini_programs_appid\":\"wx23232232323\","
            + "\"mini_programs_path\":\"/path/index/index\""
            + "},"
            + "\"award_send_rule\": {"
            + "\"transaction_amount_minimum\":100,"
            + "\"send_content\":\"SINGLE_COUPON\","
            + "\"award_type\":\"BUSIFAVOR\","
            + "\"award_list\": ["
            + "{"
            + "\"stock_id\":\"98065001\","
            + "\"original_image_url\":\"https://tool.oschina.net/regex.jpg\","
            + "\"thumbnail_url\":\"https://tool.oschina.net/regex.jpg\""
            + "}"
            + "],"
            + "\"merchant_option\":\"MANUAL_INPUT_MERCHANT\","
            + "\"merchant_id_list\": ["
            + "\"0\":\"10000022\","
            + "\"1\":\"10000023\""
            + "]"
            + "},"
            + "\"advanced_setting\": {"
            + "\"delivery_user_category\":\"DELIVERY_MEMBER_PERSON\","
            + "\"merchant_member_appid\":\"34567890\","
            + "\"goods_tags\": ["
            + "\"0\":\"xxx\","
            + "\"1\":\"yyy\""
            + "]"
            + "}"
            + "}";
    StringEntity entity = new StringEntity(reqdata,"utf-8");
    entity.setContentType("application/json");
    httpPost.setEntity(entity);
    httpPost.setHeader("Accept", "application/json");

    //完成签名并执行请求
    CloseableHttpResponse response = httpClient.execute(httpPost);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //处理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //处理成功，无返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}

 

重要入参说明：

• activity_name：活动名称

• activity_second_title：活动副标题

• merchant_logo_url：商户logo，送出优惠券时展示， 仅支持通过《图片上传API》接口获取的图片URL地址。

• out_request_no：商户请求单号，商户创建批次凭据号（格式：商户id+日期+流水号），商户侧需保持唯一性，可包含英文字母，数字，｜，_，*，-等内容，不允许出现其他不合法符号。

• delivery_purpose：投放目的。枚举值：

OFF_LINE_PAY：拉用户回店消费
JUMP_MINI_APP：引导用户前往小程序消费

• send_content：发放内容，可选单张券或礼包，选礼包时奖品限定3-5个。枚举值：

SINGLE_COUPON：单张券
GIFT_PACKAGE：礼包

注意：

更多参数、响应详情及错误码请参见创建全场满额送活动接口文档

3.2.2. 【服务端】查询活动详情接口

步骤说明：商户创建活动后，可以通过该接口查询支付有礼的活动详情，用于管理活动。

示例代码：


public void QueryActivity() throws Exception{
    //请求URL
    HttpGet httpGet = new HttpGet("https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/10028001");
    httpGet.setHeader("Accept", "application/json");

    //完成签名并执行请求
    CloseableHttpResponse response = httpClient.execute(httpGet);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //处理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //处理成功，无返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}

 

重要入参说明：

• activity_id：活动id

注意：

更多参数、响应详情及错误码请参见查询活动详情接口文档

3.2.3. 【服务端】查询活动发券商户号

步骤说明：商户创建活动后，可以通过该接口查询支付有礼的发券商户号，用于管理活动。

示例代码：


public void QueryActivityMch() throws Exception{
    //请求URL
    HttpGet httpGet = new HttpGet("https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/10028001/merchants");
    httpGet.setHeader("Accept", "application/json");

    //完成签名并执行请求
    CloseableHttpResponse response = httpClient.execute(httpGet);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //处理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //处理成功，无返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}

 

重要入参说明：

• activity_id：活动id

注意：

更多参数、响应详情及错误码请参见查询活动发券商户号接口文档

3.2.4. 【服务端】查询活动指定商品列表

步骤说明：商户创建活动后，可以通过该接口查询支付有礼的活动指定商品，用于管理活动。

示例代码：


public void QueryActivityGoods() throws Exception{
    //请求URL
    HttpGet httpGet = new HttpGet("https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/10028001/goods");
    httpGet.setHeader("Accept", "application/json");

    //完成签名并执行请求
    CloseableHttpResponse response = httpClient.execute(httpGet);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //处理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //处理成功，无返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}

 

重要入参说明：

• activity_id：活动id

注意：

更多参数、响应详情及错误码请参见查询活动指定商品列表接口文档

3.2.5. 【服务端】终止活动

步骤说明：商户可通过该接口停止支付有礼活动。

示例代码：


public void TerminateActivity() throws Exception{
    //请求URL
    HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/10028001/terminate");
    // 请求body参数
    String reqdata ="";
    StringEntity entity = new StringEntity(reqdata,"utf-8");
    entity.setContentType("application/json");
    httpPost.setEntity(entity);
    httpPost.setHeader("Accept", "application/json");

    //完成签名并执行请求
    CloseableHttpResponse response = httpClient.execute(httpPost);

    try {
        int statusCode = response.getStatusLine().getStatusCode();
        if (statusCode == 200) { //处理成功
            System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
        } else if (statusCode == 204) { //处理成功，无返回Body
            System.out.println("success");
        } else {
            System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
            throw new IOException("request failed");
        }
    } finally {
        response.close();
    }
}

 

重要入参说明：

• activity_id：活动id

注意：

更多参数、响应详情及错误码请参见终止活动接口文档

3.2.6. 【服务端】新增活动发券商户号

步骤说明：商户创建活动后，可以通过该接口增加支付有礼的发券商户号，用于管理活动。

示例代码：


public void GetActivityList() throws Exception{
  // 加载商户私钥（privateKey：私钥字符串）
  PrivateKey merchantPrivateKey = PemUtil
          .loadPrivateKey(new ByteArrayInputStream(privateKey.getBytes("utf-8")));

  // 加载平台证书（mchId：商户号,mchSerialNo：商户证书序列号,apiV3Key：V3秘钥）
  AutoUpdateCertificatesVerifier verifier = new AutoUpdateCertificatesVerifier(
          new WechatPay2Credentials(mchId, new PrivateKeySigner(mchSerialNo, merchantPrivateKey)),apiV3Key.getBytes("utf-8"));

  CloseableHttpClient httpClient = HttpClients.createDefault();
  // 初始化httpClient
  httpClient = WechatPayHttpClientBuilder.create()
          .withMerchant(mchId, mchSerialNo, merchantPrivateKey)
          .withValidator(new WechatPay2Validator(verifier)).build();

  //请求URL
  HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/10028001/merchants/add");
  // 请求body参数
  String reqdata = "{"
          + "\"merchant_id_list\": ["
          + "\"100123456\","
          + "\"100123457\""
          + "],"
          + "\"add_request_no\":\"100002322019090134234sfdf\""
          + "}";
  StringEntity entity = new StringEntity(reqdata,"utf-8");
  entity.setContentType("application/json");
  httpPost.setEntity(entity);
  httpPost.setHeader("Accept", "application/json");

  //完成签名并执行请求
  CloseableHttpResponse response = httpClient.execute(httpPost);

  try {
      int statusCode = response.getStatusLine().getStatusCode();
      if (statusCode == 200) { //处理成功
          System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
      } else if (statusCode == 204) { //处理成功，无返回Body
          System.out.println("success");
      } else {
          System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
          throw new IOException("request failed");
      }
  } finally {
      response.close();
  }
}

 

重要入参说明：

• activity_id：活动id

• add_request_no：请求业务单据号，商户添加发券商户号的凭据号，商户侧需保持唯一性

注意：

更多参数、响应详情及错误码请参见新增活动发券商户号接口文档

3.2.7. 【服务端】获取支付有礼活动列表

步骤说明：商户根据一定过滤条件，查询已创建的支付有礼活动。

示例代码：


public void GetActivityList() throws Exception{
  // 加载商户私钥（privateKey：私钥字符串）
  PrivateKey merchantPrivateKey = PemUtil
          .loadPrivateKey(new ByteArrayInputStream(privateKey.getBytes("utf-8")));

  // 加载平台证书（mchId：商户号,mchSerialNo：商户证书序列号,apiV3Key：V3秘钥）
  AutoUpdateCertificatesVerifier verifier = new AutoUpdateCertificatesVerifier(
          new WechatPay2Credentials(mchId, new PrivateKeySigner(mchSerialNo, merchantPrivateKey)),apiV3Key.getBytes("utf-8"));

  CloseableHttpClient httpClient = HttpClients.createDefault();
  // 初始化httpClient
  httpClient = WechatPayHttpClientBuilder.create()
          .withMerchant(mchId, mchSerialNo, merchantPrivateKey)
          .withValidator(new WechatPay2Validator(verifier)).build();

  //请求URL
  HttpGet httpGet = new HttpGet("https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities?offset=0&limit=10&activity_status=ONGOING_ACT_STATUS");
  httpGet.setHeader("Accept", "application/json");

  //完成签名并执行请求
  CloseableHttpResponse response = httpClient.execute(httpGet);

  try {
      int statusCode = response.getStatusLine().getStatusCode();
      if (statusCode == 200) { //处理成功
          System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
      } else if (statusCode == 204) { //处理成功，无返回Body
          System.out.println("success");
      } else {
          System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
          throw new IOException("request failed");
      }
  } finally {
      response.close();
  }
}

 

重要入参说明：

• offset：分页页码，页面从0开始

• limit：分页大小。特殊规则：最大取值为100，最小为1

注意：

更多参数、响应详情及错误码请参见获取支付有礼活动列表接口文档

3.2.8. 【服务端】删除活动发券商户号

步骤说明：商户创建活动后，可以通过该接口删除支付有礼的发券商户号，用于管理活动。

示例代码：


public void DelActivityMch() throws Exception{
  // 加载商户私钥（privateKey：私钥字符串）
  PrivateKey merchantPrivateKey = PemUtil
          .loadPrivateKey(new ByteArrayInputStream(privateKey.getBytes("utf-8")));

  // 加载平台证书（mchId：商户号,mchSerialNo：商户证书序列号,apiV3Key：V3秘钥）
  AutoUpdateCertificatesVerifier verifier = new AutoUpdateCertificatesVerifier(
          new WechatPay2Credentials(mchId, new PrivateKeySigner(mchSerialNo, merchantPrivateKey)),apiV3Key.getBytes("utf-8"));

  CloseableHttpClient httpClient = HttpClients.createDefault();
  // 初始化httpClient
  httpClient = WechatPayHttpClientBuilder.create()
          .withMerchant(mchId, mchSerialNo, merchantPrivateKey)
          .withValidator(new WechatPay2Validator(verifier)).build();

  //请求URL
  HttpPost httpPost = new HttpPost("https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/126002309/merchants/delete");
  // 请求body参数
  String reqdata = "{"
          + "\"merchant_id_list\": ["
          + "\"100123456\","
          + "\"100123457\""
          + "],"
          + "\"delete_request_no\":\"100002322019090134234sfdf\""
          + "}";
  StringEntity entity = new StringEntity(reqdata,"utf-8");
  entity.setContentType("application/json");
  httpPost.setEntity(entity);
  httpPost.setHeader("Accept", "application/json");

  //完成签名并执行请求
  CloseableHttpResponse response = httpClient.execute(httpPost);

  try {
      int statusCode = response.getStatusLine().getStatusCode();
      if (statusCode == 200) { //处理成功
          System.out.println("success,return body = " + EntityUtils.toString(response.getEntity()));
      } else if (statusCode == 204) { //处理成功，无返回Body
          System.out.println("success");
      } else {
          System.out.println("failed,resp code = " + statusCode+ ",return body = " + EntityUtils.toString(response.getEntity()));
          throw new IOException("request failed");
      }
  } finally {
      response.close();
  }
}

 

重要入参说明：

• activity_id：活动id

注意：

更多参数、响应详情及错误码请参见删除活动发券商户号接口文档

4. 常见问题

Q1：支付有礼创建全场满额送活动API返回“发券商户号校验失败，请核实是否满足同品牌等规则”

A1：支付有礼活动的曝光商户号必须是商家券归属商户号的同品牌。同品牌商户号是指同一企业/集团/品牌/公司旗下，如果存在多个微信支付商户号，该企业/集团/品牌/公司可以授权财付通支付科技有限公司将其旗下的多个商户号创建为同品牌商户号组合。主要用于更便利使用免充值营销产品功能，包括开通产品权限、配置组合内商户号为可用商户、配置活动后可用商户免审核等

Q2：支付有礼创建全场满额送活动API返回“商家券信息不满足活动规则，请核实券有效期或code”

A2：支付有礼中投放批次的校验，请按照以下几点排查

1. 单张券/券包中所有的券开始时间需早于支付有礼活动的开始时间，结束时间需晚于支付有礼的结束时间
2. 如果批次为上传code模式，需先上传code再投放到支付有礼
3. 添加券包时，库存、限领和归属商户号需要保持一致
4. 曝光商户号、批次的归属商户号需要全部为同品牌

Q3：支付有礼创建全场满额送活动API，开始时间和结束时间描述的“最长可以配置1年内的活动”中的“1年”如何计算？

A3：间隔需要小于31536000s，即需要小于365天

Q4：支付有礼创建全场满额送活动API上传了merchant_id_list字段，接着调用了获取支付有礼活动列表API，并没有merchant_id_list返回，该字段在什么情况下才返回？

A4：查询活动发券商户号API才会有这个字段返回，接口文档地址

Q5：支付有礼发放商家券，用户领券没有收到领券事件通知openid

A5：请检查对应的批次，调用创建商家券接口时是否有设置事件通知APPID参数（notify_appid）

相关网站

象舞莲花生物黑科技酿酒 可以加热喝的白酒，可以加冰喝的白酒

象舞莲花生物黑科技酿酒 可以加热喝的白酒，可以加冰喝的白酒

象舞莲花科技集团，生物黑科技酿酒 可以加热喝的白酒，可以加冰喝的白酒，能对1000-2000种疾病起治疗作用的白酒！第一批（合伙人）每箱:720元（120元/瓶，品质口感超越市面3000元/瓶的白酒）；...
连劲智播实景无人自动播直播APP

连劲智播实景无人自动播直播APP

...
[免费吃面,被动赚钱] 沙县拌面 葱油味+花生酱味 共10包/箱面干80g 百品农源专供

[免费吃面,被动赚钱] 沙县拌面 葱油味+花生酱味 共10包/箱面干80g 百品农源专供

【吃面攒芝麻，一粒一大碗！】上班忙？懒得做饭？厨艺不好？忘了点外卖？给我3分钟，一道热烘烘、喷喷香的特色拌面马上出炉！浓郁的酱汁挂在面条上，热气激发出面香和酱香，夹一筷子，吸溜进嘴巴，...
喵喵说

喵喵说

喵喵说是一家专业的导购网站,为大家提供物美价廉的优质商品。领取优惠券,购物更便宜,是您首选省钱综合商城,喵喵说带您开启时尚购物之旅!...
利扣猫返利APP

利扣猫返利APP

利扣猫是2020年专业淘宝天猫优惠卷发放平台,淘宝天猫返利优惠券APP下载,汇聚全网优质折扣商品，每日精选千款有内部优惠券的商品,9.9元起全场包邮1折特卖，每个整点限时秒杀！领优...
开门芝麻旅游线路

开门芝麻旅游线路

开门芝麻旅游，成立于2013年，旗下拥有旅游“新零售品牌”——皮皮旅游 和 旅游“供应链品牌”。公司自成立以来，始终秉持“让天下没有难做...
微信支付商户平台商家助手

微信支付商户平台商家助手

微信支付商户平台商家助手支付有礼开发指引1. 接口规则为了在保证支付安全的前提下，带给商户简单、一致且易用的开发体验，我们推出了全新的微信支付APIv3接口。该版本API的具...
连劲淘芝麻购：全返出局&全返增值

连劲淘芝麻购：全返出局&全返增值

请复制链接到微信打开 四、[全返出局]模式：可指定前多少名购买特定商品100%-300%返现红包，每天结算。商品标题有[全返出局]的才有此福利。  在取得商品，享有分销奖代理奖的基础上，专享1倍红包分红，分红满1倍出局，出局后可以继续参与1次，每次限购1份，按业绩大小加权平均排列释放红包，起到特定产品促销的作用。 五、[全返增值]模式：购物攒芝麻，一粒一别墅！商品标题有[全返增值]的才有此功能。 A)  厂家让利部分存入芝麻仓，芝麻仓组成：厂家让利，数字资产发行费，提现手续费，其它收入等。 fu-...

发布评论

Copyright © 2001 ~ 2099 D1V1网导航 联系QQ/微信：76815288沪ICP备05028199号