APP下单

适用于商户APP内支付场景，商户调用此接口，服务端返回支付参数，据返回的参数唤醒微信、支付宝客户端，消费者完成支付。

接口说明

测试请求URL：https://test-api.huishouqian.com/api/acquiring

生产请求URL：https://api.huishouqian.com/api/acquiring

请求方式：POST

公共请求参数

业务请求参数

Memo参数域

公共请求示例

{method=QUERY_TRADE_FILE, format=json, signType=RSA2, signContent=【参考业务请求示例】,sign=7ecbad9cb113bd54e6ee45f7fe76883a40428d548b7294ce8f7ba30f211881073820d3ec7a54d3406dcf7a4d3f87f0994c24db54bab430777425147378dbf01afe0491a1c287e5ce380454b0e228a5a20d541874c14addd4100199660e6c4a857fa080ceb4601a0ee21e3fab9d87016198f151a3b16f60a254c1e8b4cd42cdf7, version=1.0, merchantNo=8000000026}

业务请求示例

{
"extend":"自定义字段",
"goodsInfo":"测试",
"memo":"{\"latitude\":\"39.916527\",\"longitude\":\"116.397128\",\"paylimit\":\"balance\",\"spbillCreateIp\":\"172.22.11.2\",\"timeExpire\":\"\"}",
"orderAmt":"1",
"payType":"WECHAT_APPLET",
"requestDate":"20210916133716",
"returnUrl":"",
"transNo":"DD20210916133716294"
}

公共响应参数

业务响应参数

公共响应示例

{
"success":true,
"result":"【业务响应示例】",
"errorCode":null,
"errorMsg":null,
"sign":"88faca1f2511cc194367ffd96aa78a4cdf25a8284b0cd74b75e331b37c642b26aaeb46f2e4be38080eeb2b78575abd715d58fd30bbf59e167d64d0b714487f9462381e499a48524b1704694f256fa8f6e917d33cd413e365872ef2c7eede37ab4b23f67dcf6f34ec0daf65a34502123f792a646bea6447c126a612087825b17b91e585f74e56220328b198982e62a734387cd8556927e6881878b821969b6e784a20771cf55fad70a4368b8650c0ece0a7903678e1ad6134f6c711329a3e3e456c28ffbfc607fa6bf1f969a4d38b35ca3bf9ad81f71b2d2ad816502d579c0c4fc1f1fccec74a861c4679c5217be0176bf1eebcb57aea381f922fcf920aa471198be972f0c4f9fab10f7885b9c09eda977351b40e9058247ec30da55dd4c0be4a9de7d996e186e9f9ff2693f564f0eaddca9d7ff9f3b813d0c70bdba75b2a1bf9bd4ddf28ff66c45d6ce31e188d8606c82078d842008a9a1b4c1b64b7b2d3632087e46bbc4322181a9832cecd852682fdb72d336b32512bde94e81ba322fe9d2d"
}

业务响应示例

{
"extend":"自定义字段",
"merchantNo":"814000473149",
"orderAmt":"1",
"orderStatus":"INIT",
"payType":"WECHAT_APPLET",
"qrCode":"{\"path\":\"pages/orderInfo/orderInfo\",\"payType\":\"WECHAT_APPLET\",\"miniProgramType\":\"WXLaunchMiniProgram.Req.MINIPTOGRAM_TYPE_PREVIEW\",\"tradeNo\":\"DYNAMIC2109161337200003650175170\",\"appId\":\"wx09ad161ff5ab0343\",\"ghAppId\":\"gh_cc42edba6b00\"}",
"respCode":"100213",
"respMsg":"订单未支付",
"tradeNo":"DYNAMIC2109161337200003650175170",
"transNo":"DD20210916133716294"
}

小程序唤醒示例

安卓APP微信支付唤醒方式
private void jumpWeiXinMiniProgramPay(OrderBean wxOrderBean, String tradeNo) {
        String appId = Constants.APP_ID; // 填移动应用(App)的 AppId，非小程序的 AppID
        IWXAPI api = WXAPIFactory.createWXAPI(this, appId);
        WXLaunchMiniProgram.Req req = new WXLaunchMiniProgram.Req();
        req.userName = wxOrderBean.getGhAppId(); // 填小程序原始id
        LogUtil.d("PATH", "+++path:"+wxOrderBean.getPath());
        req.path = wxOrderBean.getPath() + "?tradeNo=" + tradeNo;              //路径以及参数
        if ("WXLaunchMiniProgram.Req.MINIPTOGRAM_TYPE_RELEASE".equals(wxOrderBean.getMiniProgramType())) {  //正式版
            req.miniprogramType = WXLaunchMiniProgram.Req.MINIPTOGRAM_TYPE_RELEASE;
        } else if ("WXLaunchMiniProgram.Req.MINIPTOGRAM_TYPE_PREVIEW".equals(wxOrderBean.getMiniProgramType())) { //体验版
            req.miniprogramType = WXLaunchMiniProgram.Req.MINIPROGRAM_TYPE_PREVIEW;
        } else {                                                                                             //测试版
            req.miniprogramType = WXLaunchMiniProgram.Req.MINIPROGRAM_TYPE_TEST;
        }
        api.sendReq(req);
    }

安卓APP支付宝支付唤醒方式
private void jumpAilMiniProgramPay(OrderBean orderBean, String tradeNo) {
        StringBuilder stringBuilder  = new StringBuilder("alipays://platformapi/startapp?appId=")
                .append(orderBean.getAppId())
                .append("&page=")
                .append(orderBean.getPath())
                .append("?tradeNo=")
                .append(tradeNo);
        Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(stringBuilder.toString()));
        startActivityForResult(intent, 1001);
    }

IOS APP支付宝支付唤醒方式
/**
 打开支付宝小程序

 @param params 打开参数
 */
- (void)openALiMiniProgramWithZfbId:(NSString *)zfbId path:(NSString *)path params:(NSDictionary *)params
{
    NSString *paramsString = nil;
    if (params.count>0) {
        paramsString = [NSString serializeToUrlByDicString:params];
    }
    path = [NSString stringWithFormat:@"alipays://platformapi/startapp?appId=%@&page=%@",zfbId,path];
    if (paramsString.length>0) {
        path = [NSString stringWithFormat:@"%@?%@",path,[paramsString stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]]];
    }
    NSLog(@"alipath = %@",path);
    NSURL *url = [NSURL URLWithString:path];
    if (@available(iOS 10.0, *)) {
        [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:^(BOOL success) {

        }];
    } else {
        // Fallback on earlier versions
        [[UIApplication sharedApplication] openURL:url];
    }
}

IOS APP微信支付唤醒方式
/**
 打开微信小程序

 @param params 打开参数
 */
- (void)openWXMiniProgramWithWxId:(NSString *)wxId path:(NSString *)path miniProgramType:(NSString *)miniProgramType Params:(NSDictionary *)params
{
    if ([WXApi isWXAppInstalled]) {
        NSString *paramsString = nil;
        if (params.count>0) {
            paramsString = [NSString serializeToUrlByDicString:params];
        }
        if (paramsString.length>0) {
            path = [NSString stringWithFormat:@"%@?%@",path,paramsString];
        }
        NSLog(@"path = %@",path);
        WXLaunchMiniProgramReq *launchMiniProgramReq = [WXLaunchMiniProgramReq object];
        launchMiniProgramReq.userName = wxId;
        launchMiniProgramReq.path = path;
        if ([miniProgramType isEqualToString:@"WXLaunchMiniProgram.Req.MINIPTOGRAM_TYPE_RELEASE"]) {
            launchMiniProgramReq.miniProgramType = WXMiniProgramTypeRelease;
        }else
        {
            launchMiniProgramReq.miniProgramType = WXMiniProgramTypePreview;//体验版
        }

        [WXApi sendReq:launchMiniProgramReq completion:^(BOOL success) {

        }];
    }else
    {
        [[ToastView getInstance] displayToastWithMessage:@"请先安装微信App"];
    }
}

原生唤醒示例

安卓APP支付宝支付唤醒方式
https://opendocs.alipay.com/open/204/105296

安卓APP微信支付唤醒方式
https://pay.weixin.qq.com/wiki/doc/apiv3/open/pay/chapter2_5_2.shtml

IOS APP支付宝支付唤醒方式
https://opendocs.alipay.com/open/204/105295

IOS 安卓APP微信支付唤醒方式
https://pay.weixin.qq.com/wiki/doc/apiv3/open/pay/chapter2_5_2.shtml

交易状态码

交易响应码