兑换系统开放接口


微信立减金

<h3>微信立减金</h3> <p><strong>URL:</strong> /v1/openapi/order/wechat/coupons</p> <p><strong>Type:</strong> POST</p> <p><strong>Content-Type:</strong> application/json; charset=utf-8</p> <p><strong>Description:</strong> 发放微信立减金,发放到用户卡包,在券过期前,用户会收到过期提醒,提升核销转化率。 用户在微信支付场景下满足代金券核销规则(如指定银行卡、消耗门槛)时,可立减支付金额。</p> <p><strong>Request-headers:</strong></p> <table> <thead> <tr> <th>Header</th> <th>Type</th> <th>Description</th> <th>Required</th> <th>Since</th> </tr> </thead> <tbody> <tr> <td>businessId</td> <td>string</td> <td>业务ID,由平台提供</td> <td>true</td> <td>-</td> </tr> <tr> <td>nonce</td> <td>string</td> <td>随机字符串,需保证每次请求不同</td> <td>true</td> <td>-</td> </tr> <tr> <td>timestamp</td> <td>string</td> <td>时间戳,毫秒值</td> <td>true</td> <td>-</td> </tr> <tr> <td>sign</td> <td>string</td> <td>签名值</td> <td>true</td> <td>-</td> </tr> <tr> <td>signType</td> <td>string</td> <td>签名方式:SHA256-RSA、MD5。默认:SHA256-RSA</td> <td>false</td> </tr> </tbody> </table> <p><strong>Body-parameters:</strong></p> <table> <thead> <tr> <th>Parameter</th> <th>Type</th> <th>Description</th> <th>Required</th> <th>Since</th> </tr> </thead> <tbody> <tr> <td>merchantId</td> <td>string</td> <td>商家ID</td> <td>true</td> <td>-</td> </tr> <tr> <td>businessId</td> <td>string</td> <td>业务ID</td> <td>true</td> <td>-</td> </tr> <tr> <td>appId</td> <td>string</td> <td>微信appId(有值以此为准,不传则以系统配置为准)</td> <td>false</td> <td>-</td> </tr> <tr> <td>openId</td> <td>string</td> <td>微信openId,openId所属appId(公众号ID或小程序ID)需要与我司商户号授权关联</td> <td>true</td> <td>-</td> </tr> <tr> <td>productCode</td> <td>string</td> <td>产品编码</td> <td>true</td> <td>-</td> </tr> <tr> <td>activityId</td> <td>string</td> <td>活动ID,由我方创建,活动有效期最大为3个月,最小立减金额1元</td> <td>true</td> <td>-</td> </tr> <tr> <td>bizCode</td> <td>string</td> <td>商家订单号</td> <td>true</td> <td>-</td> </tr> <tr> <td>callbackUrl</td> <td>string</td> <td>充值的状态报告推送地址&lt;br&gt;为空则使用开户时设置的地址</td> <td>false</td> <td>-</td> </tr> </tbody> </table> <p><strong>Request-example:</strong></p> <pre><code>curl -X POST -H &amp;#039;Content-Type: application/json; charset=utf-8&amp;#039; -H &amp;#039;businessId:55&amp;#039; -H &amp;#039;nonce:55&amp;#039; -H &amp;#039;timestamp:1628757969177&amp;#039; -H &amp;#039;sign:55&amp;#039; -i /v1/openapi/order/wechat/transfer? --data &amp;#039;{ &amp;quot;merchantId&amp;quot;: &amp;quot;84&amp;quot;, &amp;quot;businessId&amp;quot;: &amp;quot;84&amp;quot;, &amp;quot;openId&amp;quot;: &amp;quot;84&amp;quot;, &amp;quot;productCode&amp;quot;: &amp;quot;63536&amp;quot;, &amp;quot;activityId&amp;quot;: “abcdef”, &amp;quot;bizCode&amp;quot;: &amp;quot;63536&amp;quot;, &amp;quot;callbackUrl&amp;quot;: &amp;quot;www.xn---xn--vc7a-987w249s.net&amp;quot; }&amp;#039;</code></pre> <p><strong>Response-fields:</strong></p> <table> <thead> <tr> <th>Field</th> <th>Type</th> <th>Description</th> <th>Since</th> </tr> </thead> <tbody> <tr> <td>status</td> <td>int32</td> <td>状态码</td> <td>-</td> </tr> <tr> <td>message</td> <td>string</td> <td>返回消息</td> <td>-</td> </tr> <tr> <td>data</td> <td>object</td> <td>数据对象</td> <td>-</td> </tr> <tr> <td>└─orderCode</td> <td>string</td> <td>平台订单号</td> <td>-</td> </tr> <tr> <td>└─bizCode</td> <td>string</td> <td>商家订单号</td> <td>-</td> </tr> <tr> <td>└─settlementPrice</td> <td>number</td> <td>结算金额</td> <td>-</td> </tr> </tbody> </table> <p><strong>Response-example:</strong></p> <pre><code>{ &amp;quot;status&amp;quot;: 568, &amp;quot;message&amp;quot;: &amp;quot;success&amp;quot;, &amp;quot;data&amp;quot;: { &amp;quot;orderCode&amp;quot;: &amp;quot;63536&amp;quot;, &amp;quot;bizCode&amp;quot;: &amp;quot;63536&amp;quot;, &amp;quot;settlementPrice&amp;quot;: 207 } }</code></pre>

页面列表

ITEM_HTML