支付宝二维码收款
接入需要材料: 咨询客服
生成一个支付宝付款二维码,顾客打开手机支付宝扫码,付款成功后,开发者将收到推送此订单的付款通知。 请求地址:
https://kf.fw199.com/gateway/partner/pay/alipay/personal/native
请求参数
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| appid | String | 合作伙伴Id | |
| timestamp | String | 时间戳 | 请求时的时间,unixtime格式 |
| ext_trade_no | String | 开发者传入的订单 , 比如1586420573605 | 不可传入重复的订单号,此订单号在付款完成后,推送回调时一同返回,开发者可以根据此订单号进行业务逻辑处理。 |
| amount | int | 付款金额,单位分 | 比如 350, 表示3.5 元。 |
| attach | String | 附加参数,200字以内 | 支付完成回调时原样返回给开发者。 |
| body | String | 商品说明 | |
| mch_id | String | 商户号 | 联系蜂巢客服获取 |
| profit_sharing | json | 可选。分账信息 | 联系客服 |
| notify_url | String | 支付完成后的回调通知Url ,确保公网可访问 | 比如, http(s)://yoururl.com/paynotify |
| sign | String | 签名 | 对各参数使用提供的AppSecret进行签名,签名逻辑具体实现见示例代码 |
profit_sharing分账信息配置,可以配置多个分佣者。
[{"user_identity":"demo@163.com", // 支付宝的登录账号,一般是邮箱或手机号。"amount":100, //分佣金额,单位:分。 100即是1元。"desc":"推广佣金" // 在支付宝账单上显示的交易名称}]请求示例
public void PayAlipayPersonalCreateNativePay() throws Exception { // 分佣配置 String profile ="[{\"user_identity\":\"demo@163.com\", \"amount\":100,\"desc\":\"推广佣金\"}]";
//支付金额 (单位分) String amount ="1000"; String mchId ="xxxx"; //由蜂巢提供的支付宝商户号 // 确保传入的开发者订单号唯一, 订单号生成规则开发者可自定, 修改 String ext_trade_no =String.valueOf(System.currentTimeMillis()); // 扩展参数,付款成功时回调给开发者时会原样返回,根据自己需求填写或为空。 String attach ="biz=sms"; // 订单标题 String body ="支付测试商品4"; // 回调通知url,开发者自己的服务器Url String notify_url = Config.PayNotifyUrl; //业务参数 Map<String, String> data = new HashMap<String, String>(); data.put("appid", Config.AppId); Long timestamp = System.currentTimeMillis() / 1000; data.put("timestamp", timestamp.toString()); data.put("ext_trade_no",ext_trade_no ); data.put("mch_id",mchId ); data.put("amount",amount ); data.put("attach",attach ); data.put("body" , body ); data.put("notify_url",notify_url ); // data.put("profit_sharing",profile); data.put("sign", Utils.Sign(data, Config.AppSecret )); String result = doHttpRequest(Config.PayAlipayPersonalCreateNativePayUrl,data); System.out.println(result);
}接口返回结果:
{ "code": 0, "message": "ok", "data": { "qr_url": https://static.fw199.com/qp-pay/MP1VKaWZhpxxxxxxx.png" }}返回参数说明
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| code | int | 0时为成功,非0为失败 | |
| message | String | 消息 | code非0时,会包含错误的出错信息 |
| qr_url | String | 生成的付款二维码 | 成功才有qr_url 值 |
开发者获取到付款码的Url后,可在自己的系统或网站进行展示,供用户扫码支付。用户扫码付款后,系统将自动回调到入参notify_url指定的网站url,关于付款完成回调通知见文档