微信优惠券 朋友的券专区

付的免费券点额度pay_coin本次需要支付的付费券点额度查询券点余额接口本接口用于开发者查询当前券点账户中的免费券点/付费券点数目以及总额。接口调用请求说明HTTP请求方式: GET https://api.weixin.qq.com/card/pay/getcoinsinfo?access_token=ACCESS_TOKEN返回数据示例{"errcode": 0, "errmsg": "ok", "free_coin": 200 "pay_coin": 1  "total_coin": 201}返回参数说明参数名描述errcode错误码errmsg错误信息free_coin免费券点数目pay_coin免费券点数目total_coin全部券点数目确认兑换库存接口本接口用于确认兑换库存，确认后券点兑换为库存，过程不可逆。接口调用请求说明HTTP请求方式: POST https://api.weixin.qq.com/card/pay/confirm?access_token=ACCESS_TOKEN参数说明参数是否必须说明POST数据是Json数据access_token是调用接口凭证POST数据{    "card_id": "pbLatjpxxxxlCEV_cLTwoB7yU",    "order_id": "P9zzllX2VJ5NgiF9kFVarX7bc8r-ms_5Dy091evc2eIuxtZvZobeomE1p9Dw8v7lFBhqKM4YgrZa54uuWhf3hw7KquEOfmx5FplGKRIfkbR7Ag5WwYdxP-KeT6LeJBttb1xpYxxxxxxxxxxxxHrbUyHopolqfUqPBBLDEmB7Z-91I8",    "quantity": "1"}请求参数说明参数名必填类型示例值描述card_id是string(32)pFS7Fjg8kV1IdDz01r4SQwMkuCKc需要来兑换库存的card_idquantity是int100本次需要兑换的库存数目order_id是stringP9zzllX2VJ5NgiF9kFVarX7bc8r仅可以使用上面得到的订单号，保证批价有效性返回数据示例{"errcode":0, "errmsg":"ok"}参数说明参数名描述errcode错误码errmsg错误信息特别注意：上一步获得的order_id须在60s内使用，否则确认兑换库存接口将会失效充值券点接口开发者可以通过此接口为券点账户充值券点，1元等于1点。开发者调用接口后可以获得一个微信支付的支付二维码链接， 开发者可以将链接转化为二维码扫码支付。接口调用请求说明HTTP请求方式: POST https://api.weixin.qq.com/card/pay/recharge?access_token=ACCESS_TOKEN参数说明参数是否必须说明POST数据是Json数据access_token是调用接口凭证POST数据{"coin_count": 100}请求参数说明参数名必填类型示例值描述coin_count是int10000需要充值的券点数目，1点=1元返回数据示例{    "errcode": 0,    "errmsg": "ok",    "order_id": "100005790120***221401000171",    "qrcode_url": "weixin://wxpay/bizpayurl?pr=xxxxxxxxx",    "qrcode_buffer": "pwxs*************xxxxxxxxxx"}参数名描述errcode错误码errmsg错误信息order_id本次支付的订单号，用于查询订单状态qrcode_url支付二维码的的链接，开发者可以调用二维码生成的公开库转化为二维码显示在网页上，微信扫码支付qrcode_buffer二维码的数据流，开发者可以使用写入一个文件的方法显示该二维码注意：开发者可以参考以下方法将buffer显示二维码<?php $file = fopen("test.jpg","w"); echo fwrite($file, $qrcode_buffer); fclose($file); ?>查询订单详情接口本接口用于查询充值订单的状态接口调用请求说明HTTP请求方式: POST https://api.weixin.qq.com/card/pay/getorder?access_token=ACCESS_TOKEN参数说明参数是否必须说明POST数据是Json数据access_token是调用接口凭证POST数据{"order_id": "100005790********401000171"}请求参数说明参数名必填类型示例值描述order_id是int10000上一步中获得的订单号，作为一次交易的唯一凭证返回数据示例{    "errcode": 0,    "errmsg": "ok",    "order_info": {        "order_id": "100005790120151221401000171",        "status": "ORDER_STATUS_FINANCE_SUCC",        "create_time": 1450712798,        "pay_finish_time": 1450712905,        "desc": "微信支付充值",        "free_coin_count": "0",        "pay_coin_count": "1",        "refund_free_coin_count": "0",        "refund_pay_coin_count": "0",        "openid": "oWE-GwF1gGoyVVZC5PG6GXd4cKMY",        "order_type": "ORDER_TYPE_WXPAY"    }}返回数据说明参数名描述errcode错误码errmsg错误信息order_info订单信息结构体order_id订单号status订单状态，ORDER_STATUS_WAITING 等待支付 ORDER_STATUS_SUCC 支付成功 ORDER_STATUS_FINANCE_SUCC 加代币成功 ORDER_STATUS_QUANTITY_SUCC 加库存成功 ORDER_STATUS_HAS_REFUND 已退币 ORDER_STATUS_REFUND_WAITING 等待退币确认 ORDER_STATUS_ROLLBACK 已回退,系统失败 ORDER_STATUS_HAS_RECEIPT 已开发票create_time订单创建时间pay_finish_time支付完成时间desc支付描述，一般为微信支付充值free_coin_count本次充值的付费券点数量，以元为单位pay_coin_count二维码的数据流，开发者可以使用写入一个文件的方法显示该二维码refund_free_coin_count回退的免费券点refund_pay_coin_count回退的付费券点openid支付人的openidorder_tpye订单类型，ORDER_TYPE_WXPAY为充值查询券点流水详情接口本接口用于查询券点的流水详情。接口调用请求说明HTTP请求方式: POSThttps://api.weixin.qq.com/card/pay/getorderlist?access_token=ACCESS_TOKEN参数说明参数是否必须说明POST数据是Json数据access_token是调用接口凭证POST数据{    "offset": 0,    "count": 5,    "order_type": "ORDER_TYPE_WXPAY",    "nor_filter": {        "status": "ORDER_STATUS_SUCC"    },    "sort_info": {        "sort_key": "SORT_BY_TIME",        "sort_type": "SORT_DESC"    },    "begin_time": "1440420538",    "end_time": "1450713203"}请求参数说明参数名必填类型示例值描述offset否int0分批查询的起点，默认为0count否int50分批查询的数量begin_time否int14552146398批量查询订单的起始事件，为时间戳，默认1周前end_time否int14552146398批量查询订单的结束事件，为时间戳，默认为当前时间order_type否stringORDER_TYPE_WXPAY所要拉取的订单类型ORDER_TYPE_SYS_ADD 平台赠送 ORDER_TYPE_WXPAY 充值 ORDER_TYPE_REFUND 库存回退券点 ORDER_TYPE_REDUCE 券点兑换库存 ORDER_TYPE_SYS_REDUCE 平台扣减nor_filter否JSON结构ORDER_STATUS_QUANTITY_SUCC反选，不要拉取的订单status否stringORDER_STATUS_REFUND_WAITING不要拉取的订单状态订单状态包括： ORDER_STATUS_WAITING 等待支付 ORDER_STATUS_SUCC 支付成功 ORDER_STATUS_FINANCE_SUCC 加代币成功 ORDER_STATUS_QUANTITY_SUCC 加库存成功 ORDER_STATUS_HAS_REFUND 已退币 ORDER_STATUS_REFUND_WAITING 等待退币确认 ORDER_STATUS_ROLLB