接口名称:红包明细查询接口
英文名称:alipay.fund.coupon.operation.query
产品首页:[url]https://openclub.alipay.com/read.php?tid=12180&fid=72[/url]
上一步:[url]https://openclub.alipay.com/read.php?tid=13610&fid=72[/url]
一、注意事项
1、提供两种方式查询红包明细
(1)通过支付宝订单号和操作流水号查询,该查询方式效率高,建议尽可能使用该方式;
(2)通过商户订单号和操作流水号查询,该查询方式效率低,不建议使用。
二、参数说明
1、auth_no与out_order_no不能同时为空:
auth_no:支付宝授权资金订单号,以支付宝资金授权订单号为准(支付接口返回参数);
out_order_no:商户的授权资金订单号,该参数与商户的授权资金操作流水号配对使用。
2、operation_id与out_request_no不能同时为空:
operation_id:支付宝的授权资金操作流水号,以支付宝的授权资金操作流水号为准,该参数与支付宝授权资金订单号配对使用。(支付接口返回参数);
out_request_no:商户的授权资金操作流水号,该参数与商户的授权资金订单号配对使用。
三、接口请求示例
JAVA版请求示例
public static void main(String[] args) throws AlipayApiException { AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id, AlipayConfig.merchant_private_key, AlipayConfig.format, AlipayConfig.charset, AlipayConfig.alipay_public_key, AlipayConfig.sign_type); AlipayFundCouponOperationQueryRequest request = new AlipayFundCouponOperationQueryRequest(); request.setBizContent("{" + ""auth_no":"2018081710002001860294782485"," + ""out_order_no":"2017122716463222"," + ""operation_id":"20180817587432998602"," + ""out_request_no":"201712271645328"" + " }"); AlipayFundCouponOperationQueryResponse response = alipayClient.execute(request); if(response.isSuccess()){ System.out.println("调用成功"); } else { System.out.println("调用失败"); } System.out.println(response.getBody()); }
PHP版请求示例
require_once 'AopSdk.php';
$aop = new AopClient ();
$aop->appId = '填写您的appid';
$aop->rsaPrivateKey = '填写您的私钥';
$aop->alipayrsaPublicKey='填写您的支付宝公钥';
$aop->gatewayUrl = 'https://openapi.alipay.com/gateway.do';
$aop->apiVersion = '1.0';
$aop->signType = 'RSA2';
$aop->postCharset='utf-8';
$aop->format='json';
$date=date("YmdHis");
$arr=range(1000,9999);
shuffle($arr);
$request = new AlipayFundCouponOperationQueryRequest ();
$request->setBizContent("{" .
""auth_no":"2018081710002001860294782485"," .
""out_order_no":"2017122716463222"," .
""operation_id":"20180817587432998602"," .
""out_request_no":"201712271645328"" .
" }");
$result = $aop->execute ( $request);
var_dump($result);
.NET版本请求示例
IAopClient client = new DefaultAopClient(config.gatewayUrl, config.app_id, config.private_key, "json", "1.0", "RSA2", config.alipay_public_key, config.charset, false); AlipayFundCouponOperationQueryRequest request = new AlipayFundCouponOperationQueryRequest(); request.BizContent="{" + ""auth_no":"2018081710002001860294782485"," + ""out_order_no":"2017122716463222"," + ""operation_id":"20180817587432998602"," + ""out_request_no":"201712271645328"" + " }"; AlipayFundCouponOperationQueryResponse response = client.execute(request); Response.Write(response.Body);
四、显示效果
设置不同接口对应的参数值返回响应参数不同
1、查询红包页面支付明细
可通过设置红包页面支付接口的out_order_no和out_request_no的参数值查询。
2、查询打款给A用户的红包明细
可通过设置红包打款接口,打款给A用户设置的out_order_no和out_request_no的参数值查询。
3、查询打款给B用户的红包明细
可通过设置红包打款接口,打款给B用户设置的out_order_no和out_request_no的参数值查询。
4、查询红包退回的红包明细
可通过设置红包退回接口的auth_no和out_request_no的参数值查询。
因为退款接口设置的是auth_no和out_request_no,当调用支付接口的out_order_no:2017122716463224和退款接口的out_request_no:refund20171228254。
如果还是报错,请按如下方式进行提问:
正确提问方式:使用环境(沙箱还是正式环境)+接口名称(中文+英文)+ 请求参数 + 报错信息详情