H5支付(MWEB) API


特别说明:本API不再开放。有特别理由,可发工单附带业务场景描述和申请理由单独申请


H5 支付是指手机自带浏览器跳转至微信客户端支付的方式

H5 支付请求步骤:

  1. 构建请求参数
  2. POST 参数到请求地址
  3. 根据返回的参数h5_url在前端跳转
  4. 用户支付成功后接收异步通知

请求地址:https://payjs.cn/api/h5

请求参数(必选参数):

字段名称 字段类型 必填参数 说明
mchid string(16) Y 商户号
total_fee int(16) Y 金额。单位:分
out_trade_no string(32) Y 用户端自主生成的订单号
sign string(32) Y 数据签名 详见签名算法
body string(64) N 订单标题
attach string(127) N 用户自定义数据,在notify的时候会原样返回
callback_url string(255) N 支付成功后,从微信客户端跳转回浏览器的URL。留空跳回原地址
notify_url string(255) N 接收微信支付异步通知的回调地址。必须为可直接访问的URL,不能带参数、session验证、csrf验证。留空则不通知

请求返回:

字段名称 字段类型 必填参数 说明
return_code int Y 1:请求成功,0:请求失败
return_msg string(16) Y 返回消息
payjs_order_id string(16) Y PAYJS 平台订单号
out_trade_no string(16) Y 用户生成的订单号原样返回
total_fee int(16) Y 金额。单位:分
h5_url string(64) Y 浏览器跳转到微信支付的地址(有效期5分钟)
sign string(64) Y 数据签名 详见签名算法

常见问题:

  1. h5_url须以链接形式点击跳转(微信客户端须获取到浏览器referer)

H5支付演示代码:

// 引入 payjs.class.php
// 项目地址:https://github.com/payjs-cn/phpsdk

include("payjs.class.php");

$mchid = '123456';
$key = 'xxxxxx';

$data = [
    "mchid" => $mchid,
    "total_fee" => 1,
    "out_trade_no" => '123123123',
];

$payjs = new Payjs($mchid, $key);
$result = $payjs->mweb($data);

print_r($result);

php

// 引入 payjs.class.php
// 项目地址:https://github.com/payjs-cn/phpsdk

include("payjs.class.php");

$mchid = '123456';
$key = 'xxxxxx';

$data = [
    "mchid" => $mchid,
    "total_fee" => 1,
    "out_trade_no" => '123123123',
];

$payjs = new Payjs($mchid, $key);
$result = $payjs->mweb($data);

print_r($result);

python

# !/usr/bin/env Python3
# -*- coding: utf-8 -*-
import requests
import time
import hashlib
from urllib.parse import urlencode,unquote
'''
扫码支付(主扫)
'''
key = ''         # 填写通信密钥
mchid = ''       # 特写商户号

time = str(int(time.time()))
order = {
    'body'         : 'test',  # 订单标题
    'out_trade_no' : time,    # 订单号
    'total_fee'    : 120,     # 金额,单位:分
    'mchid' : mchid
}

# 构造签名函数
def sign(attributes):
    attributes_new = {k: attributes[k] for k in sorted(attributes.keys())}
    return hashlib.md5((unquote(urlencode(attributes_new))+'&key='+key)
        .encode(encoding='utf-8')).hexdigest().upper()

order['sign'] = sign(order)
request_url = "https://payjs.cn/api/mweb"
headers = {'content-type': 'application/x-www-form-urlencoded'}
response = requests.post(request_url, data=order,headers=headers)
if response:
    print(response.json())

go

package main

import (
    "fmt"
    "strings"
    "net/http"
    "net/url"
    "io/ioutil"
)

func main(){
    data := url.Values{"mchid":{"XXX"}, "total_fee":{"1"}, "out_trade_no":{"123123"}, "sign":{"XXX"}}
    data2 := strings.NewReader(data.Encode())
    resp, err := http.Post("https://payjs.cn/api/mweb", "application/x-www-form-urlencoded", data2)
    if err != nil {
        fmt.Println(err)
    }
    defer resp.Body.Close()
    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        // handle error
    }

    fmt.Println(string(body))
}

node

// 项目地址:https://github.com/payjs-cn/demo-nodejs
// 首先引入文件,并在config.js中配置商户号和通信密钥
var cfg = require("./config.js"); 
var pay = require("./pay.js");

var params = {
  'mchid': cfg.payjsmchid,     //商户号
  'total_fee': 1,              //金额。单位:分
  'out_trade_no': '123456789', //用户端自主生成的订单号
  'body': '订单标题',           //订单标题
  'attach': '自定义数据',       //用户自定义数据,在notify的时候会原样返回
  'notify_url': ''             //接收微信支付异步通知的回调地址。必须为可直接访问的URL,不能带参数、session验证、csrf验证。留空则不通知
};

pay.mweb(params,function (msg) {
    console.log(msg);
    /**TODO 这里处理业务逻辑 */
});

java

// 完整代码:https://github.com/payjs-cn/demo-java
public Object Mweb() {
    Map<String,String> payData = new HashMap<>();
    payData.put("mchid", PayjsConfig.mchid);
    payData.put("total_fee", "100");
    payData.put("out_trade_no", "83432749"); // 订单号 随便输的,自己生成一下就好了
    payData.put("body","订单标题");
    payData.put("notify_url", "https://你的域名/api/pay/notify");

    // 进行sign签名
    payData.put("sign", sign(payData, PayjsConfig.key));

    // 请求payjs获取二维码
    String result = HttpsUtils.sendPost(PayjsConfig.mwebUrl, JSON.toJSONString(payData),null);

    // 接口返回二维码数据
    return JSON.parseObject(result);
}

csharp

// 完整项目地址:https://github.com/payjs-cn/sdk-csharp

Payjs pay = new Payjs("YOUR MCHID", "YOUR KEY");

Dictionary<string, string> param = new Dictionary<string, string>();
param["total_fee"] = "1";
param["out_trade_no"] = DateTime.Now.Ticks.ToString();
param["body"] = "test";
param["attch"] = "user id";
param["callback_url"] = "自定义返回跳转的URL";
param["notify_url"] = "YOUR notify_url";

string jsonString = pay.mweb(param);

powered by Gitbook最后更新: 2022-05-26