Documentation

💵 Page Redirect Payment (POST returns payment console URL, GET returns redirect payment page, choose as needed)

websocket test
POST/GET
http://domain from merchant management after login/pay/submit.php

Interface Description

POST data: pid={merchant_id}&type={payment_method}&out_trade_no={merchant_order_no}&notify_url={server_async_notify_url}&return_url={page_redirect_notify_url}&name={product_name}&money={amount}&sitename={website_name}&sign={signature_string}&sign_type=MD5

GET data: http://domain from merchant management after login/pay/submit.php?pid={merchant_id}&type={payment_method}&out_trade_no={merchant_order_no}&notify_url={server_async_notify_url}&return_url={page_redirect_notify_url}&name={product_name}&money={amount}&sitename={website_name}&sign={signature_string}&sign_type=MD5

Request Parameters

Field Name
Parameter Name
Required
Type
Example Value
Description
Merchant ID
pid
Required
Int
1000
Merchant ID
Payment Method
type
Required
String
alipay
Payment methods: alipay:Alipay, wxpay:WeChat Pay, bankpay:Bank Transfer
Merchant Order Number
out_trade_no
Required
String
20160806151343349
Merchant Order Number
Async Notification URL
notify_url
Required
String
http://site_domain/notify_url.php
Server async notification URL
Page Redirect Notification
return_url
Required
String
http://site_domain/return_url.php
Page redirect notification, will be called once after payment completion, can be the same as server async URL if no double confirmation needed
Product Name
name
Required
String
An Oreo
Product Name
Product Amount
money
Required
String
1.00
Product Amount
Signature String
sign
Required
String
202cb962ac59075b964b07152d234b70
Signature string, same algorithm as Alipay signature algorithm
Signature Type
sign_type
Required
String
MD5
Currently only supports MD5
Extra Parameter
ext
Optional
String
userId
Extra parameter, max length 100. This parameter will be passed back in callback

Response Parameters (Only returned for POST requests, GET requests redirect directly to payment page)

Field Name
Parameter Name
Type
Example Value
Description
Payment redirect URL
-
String
http://pay.xxx.com/pay.html?out_trade_on=123&...
Redirect to this URL for direct payment page

Description / Example

Signature algorithm is the same as Alipay signature algorithm, sign and sign_type are not included, code example as follows

let secretKey = "7a3b1053780db61ebd3d7123e1b8d6c4"
let reqJson = {
    pid: 152787,
    type: "wxpay",
    out_trade_no: "20240125193935458",
    notify_url: "1",
    return_url: "2",
    name: "Test Payment 20240125193935458",
    money: 0.1
}
//str string (Note: 1/Parameter names in ASCLL code from small to large 2/Empty parameter values do not participate in signature 3/Case sensitive 4/sign and sign_type do not participate in signature 5/Finally concatenate secretKey)
money=0.1&name=Test Payment 20240125193935458&
notify_url=1&out_trade_no=20240125193935458&pid=152787&return_url=2&type=wxpay7a3b1053780db61ebd3d7123e1b8d6c4
//MD5 encryption result (Note: remove the newline before notify_url)
5af4287ea6c3ab4505e9dc8d2e3a148c

Status code description (can be handled by yourself, or directly pop up the returned message):

700: Missing parameters
701: Signature verification failed
702: Channel is under maintenance, please try again later
703: No payment code matched for the corresponding amount, please change the amount and try again
704: Amount cannot be less than 0.01 yuan
705: Duplicate order number
800: Invalid merchant or secret key, please check
901: No available channel, please check
Next: 💴 API Interface Payment