扫码支付（主扫） · PAYJS API 开发文档

Native 扫码支付（主扫） API

扫码请求步骤：

构建请求参数
POST 参数到请求地址
根据返回内容展示二维码
用户支付成功后接收异步通知

请求参数：

字段名称	字段类型	必填参数	说明
mchid	string(16)	Y	商户号
total_fee	int(16)	Y	金额。单位：分
out_trade_no	string(32)	Y	用户端自主生成的订单号
body	string(32)	N	订单标题
attach	string(127)	N	用户自定义数据，在notify的时候会原样返回
notify_url	string(255)	N	接收微信支付异步通知的回调地址。必须为可直接访问的URL，不能带参数、session验证、csrf验证。留空则不通知
type	string(16)	N	支付宝交易传值：`alipay` ，微信支付无需此字段
sign	string(32)	Y	数据签名详见签名算法

请求返回：

字段名称	字段类型	必填参数	说明
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	金额。单位：分
qrcode	string(128)	Y	二维码图片地址
code_url	string(64)	Y	可将该参数生成二维码展示出来进行扫码支付(有效期2小时)
sign	string(64)	Y	数据签名详见签名算法

扫码支付演示代码：

php python go

<?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->native($data);

print_r($result);

php

<?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->native($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/native"
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/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))
}