Native 扫码支付(主扫) API
扫码请求步骤:
- 构建请求参数(数据请求为原始表单格式,非JSON格式)
- POST 参数到请求地址
- 根据返回内容展示二维码
- 用户支付成功后接收异步通知
请求地址:https://payjs.cn/api/native
请求参数(必选参数):
字段名称 | 字段类型 | 必填参数 | 说明 |
---|---|---|---|
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的时候会原样返回 |
notify_url | string(255) | N | 接收微信支付异步通知的回调地址。必须为可直接访问的URL,不能带参数、session验证、csrf验证。留空则不通知 |
no_credit | string(1) | N | 公测参数 禁止使用信用卡支付请传值:1 |
time_expire | string(14) | N | 公测参数 订单有效期。格式:20200826080808 |
请求返回:
字段名称 | 字段类型 | 必填参数 | 说明 |
---|---|---|---|
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 | 金额。单位:分 |
code_url | string(64) | Y | 二维码内容(有效期2小时) |
qrcode | string(128) | Y | 二维码图片地址 |
sign | string(64) | Y | 数据签名 详见签名算法 |
扫码支付演示代码:
// 引入 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->native($data);
print_r($result);
# !/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/native"
headers = {'content-type': 'application/x-www-form-urlencoded'}
response = requests.post(request_url, data=order,headers=headers)
if response:
print(response.json())
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/native", "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))
}
// 项目地址: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.native(params,function (msg) {
console.log(msg);
/**TODO 这里处理业务逻辑 */
});
// 完整代码:https://github.com/payjs-cn/demo-java
public Object Native() {
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.nativeUrl, JSON.toJSONString(payData),null);
// 接口返回二维码数据
return JSON.parseObject(result);
}
// 完整项目地址: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["notify_url"] = "YOUR notify_url";
//返回原始json字符串
string jsonString = pay.native(param);
require 'digest'
require 'json'
require 'rest-client'
class Payjs
MCHID = 'xxx'
MCHKEY = 'xxx'
def self.sign(data, key)
data = data.sort
sign_arr = data.map {|k, v| "#{k}=#{v}"}
sign_str = sign_arr.join('&') + "&key=#{key}"
Digest::MD5.hexdigest(sign_str).upcase
end
def self.create_order(trade_id, title="商品标题", total_fee=100)
url = "https://payjs.cn/api/native"
data = {
"mchid" => MCHID,
"total_fee" => total_fee,
"out_trade_no" => trade_id,
"body" => title,
}
data['sign'] = Payjs.sign(data, MCHKEY)
res = RestClient.post(url, data.to_json, {content_type: :json, accept: :json})
return JSON.parse(res.body)
end
end