Voucher Check

# Code example

Note: Both the merchant order number and the platform order number must be passed one of them, or they can be passed at the same time

TopPayRequestUtil Click to obtain code examples


import com.google.gson.JsonObject;
public class demo {
    
  private static final String PLAT_PUBLIC_KEY = "MIGfMA0GCSqG***AQAB";  
  private static final String MCH_PRIVATE_KEY = "MIICeAI******IBIuhihgi";  
  private static final String URL = "https://tl-openapi.toppay.asia/gateway/order/check";

  public static void main(String[] args) throws Exception {
    query();
  }
  private static void query() throws Exception {
    Map<String, String> requestParams = new TreeMap<>();
    requestParams.put("mchId", "S012031948905787");
    requestParams.put("orderNum", "A123456789");
    requestParams.put("qrCode", "002123124716478189479838124781BHU678T778gB100.0072BHSJC7N");
    List<String> paramNameList = new ArrayList<>();
    for (String key : maps.keySet()) {
        paramNameList.add(key);
    }
    Collections.sort(paramNameList);
    StringBuilder stringBuilder = new StringBuilder();
    for (String key : paramNameList) {
        stringBuilder.append(requestParams.get(key));  
    }

    String keyStr = stringBuilder.toString(); 
    System.out.println("keyStr:" + keyStr);
    String signedStr = TopPayRequestUtil.privateEncrypt(keyStr, TopPayRequestUtil.getPrivateKey(MCH_PRIVATE_KEY)); 
    requestParams.put("sign", signedStr);
    String postJson = new Gson().toJson(requestParams);
    System.out.println("Post Json Params:" + postJson);

    String responseJson = TopPayRequestUtil.doPost(URL, postJson);  
    System.out.println("Response Msg:" + responseJson);
  }
}

using demo.utils;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Text;
using System.Threading.Tasks;

namespace demo.demos
{
    class demo
    {
        private static readonly string PLAT_PUBLIC_KEY = "MIGfMA0GCSqG******6wIDAQAB";
        private static readonly string MCH_PRIVATE_KEY = "MIICdwIBADAN*****qzuBvIGAe3OWNg=";  
        private static readonly string payUrl = "https://tl-openapi.toppay.asia/gateway/order/check";
        public static void requestQuery()
        {
            long currenttimemillis = (long)(DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalMilliseconds;
            string  mchId = 'S012031948905787';
            string orderNum = 'A123456789';
            string qrCode = '002123124716478189479838124781BHU678T778gB100.0072BHSJC7N';
            Dictionary<string, object> VarPost = new Dictionary<string, object>(); ;
            VarPost.Add("mchId", mchId);
            VarPost.Add("orderNum", orderNum);
            VarPost.Add("qrCode", qrCode);
            
            List<string> paramNameList = new List<string>();
            foreach (string key in VarPost.Keys)
            {
                paramNameList.Add(key);
            }
            paramNameList.Sort();
            StringBuilder stringBuilder = new StringBuilder();
            for (int i = 0; i < paramNameList.Count; i++)
            {
                string key = paramNameList[i];
                stringBuilder.Append(VarPost[key]);  
            }
            string keyStr = stringBuilder.ToString(); 
            int len = keyStr.Length;
            string signedStr = "";
            try
            {
                RSAForJava rsa = new RSAForJava();
                signedStr = rsa.EncryptByPrivateKey(keyStr, MCH_PRIVATE_KEY);
            }
            catch (Exception ex)
            {
                Console.WriteLine(ex.Message);
            }
            VarPost.Add("sign", signedStr);
            WebClient w = new WebClient();
            w.Headers[HttpRequestHeader.ContentType] = "application/json";
            string jsonStr = JsonNewtonsoft.SerializeDictionaryToJsonString(VarPost);
            Console.WriteLine("postJson:" + jsonStr);     
            string sRemoteInfo = w.UploadString(payUrl, "POST", jsonStr);
        }

    }
}

package main

import (
	"bytes"
	"encoding/base64"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
	"reflect"
	"sort"
	"strings"
)

func main() {
	cryptor := NewCryptor()
	cryptor.Pub64 = "MIGfMA0GCSqGSIb3******K4yD37Bj0wIDAQAB"
	cryptor.Pri64 = "MIICdwIBAD*********HKRJwSWWBDEfuk="
	
	url := "https://tl-openapi.toppay.asia/gateway/order/check"
	request := RequestBody{
		mchId: "S012031948905787",
		orderNum: "A123456789",
		qrCode: "002123124716478189479838124781BHU678T778gB100.0072BHSJC7N",
	}
	sortedValues, err := sortedConcatenatedValues(request)
	if err != nil {
		fmt.Printf("Error: %s\n", err)
		return
	}
	encryptedData := cryptor.PriEncrypt([]byte(sortedValues))
	encodedString := base64.StdEncoding.EncodeToString(encryptedData)
	request.Sign = encodedString
	jsonBytes, err := json.Marshal(request)
	if err != nil {
		fmt.Printf("Error: %s", err.Error())
		return
	}
	fmt.Println("json2", bytes.NewBuffer(jsonBytes))
	req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonBytes))
	if err != nil {
		fmt.Println("Error creating HTTP request:", err)
		return
	}
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		fmt.Println("Error sending HTTP request:", err)
		return
	}
	defer resp.Body.Close()
	respBody, err := ioutil.ReadAll(resp.Body)
	if err != nil {
		fmt.Println("Error reading response body:", err)
		return
	}
	fmt.Println("Response Body:", string(respBody))
}

func sortedConcatenatedValues(v interface{}) (string, error) {
	valueOf := reflect.ValueOf(v)
	typeOf := valueOf.Type()
	kv := make(map[string]string)
	for i := 0; i < valueOf.NumField(); i++ {
		field := typeOf.Field(i)
		jsonTag := field.Tag.Get("json")
		if jsonTag == "" || jsonTag == "-" {
			continue
		}
		tagName := strings.Split(jsonTag, ",")[0]
		kv[tagName] = fmt.Sprint(valueOf.Field(i).Interface())
	}
	keys := make([]string, 0, len(kv))
	for k := range kv {
		keys = append(keys, k)
	}
	sort.Strings(keys)
	var concatenatedValues strings.Builder
	for _, key := range keys {
		concatenatedValues.WriteString(kv[key])
	}
	return concatenatedValues.String(), nil
}

import json
import requests
import base64
import easyocr
from M2Crypto import RSA
from collections import OrderedDict

class TopQueryDemo:
    MCH_PRI_KEY_FILE = '\data\company_rsa_private_key.pem'
    MCH_PUBLIC_KEY_FILE = '\data\plat_rsa_public_key.pem'
    
    url = "https://tl-openapi.toppay.asia/gateway/order/check"

    @staticmethod
    def cash():
        request_params = OrderedDict()
        request_params["mchId"] = "S012031948905787"
        request_params["orderNum"] = "A123456789"
        request_params["qrCode"] = "002123124716478189479838124781BHU678T778gB100.0072BHSJC7N"

        key_str = ''.join([str(value) for value in request_params.values()])
        print("keyStr:", key_str)

        signed_str = TopQueryDemo.private_encrypt(key_str, TopQueryDemo.MCH_PRI_KEY_FILE)
        request_params["sign"] = signed_str
        post_json = json.dumps(request_params)
        print("Post Json Params:", post_json)

        response_json = TopQueryDemo.do_post(TopQueryDemo.url, post_json)
        print("Response Msg:", response_json)

        check = TopQueryDemo.public_key_decrypt(signed_str, TopQueryDemo.MCH_PUBLIC_KEY_FILE);
        print("check:", check)

    @staticmethod
    def private_encrypt(data, prikey_file):
        rsa_pri = RSA.load_key(prikey_file)
        crypto = b''
        for chunk in [data[i:i + 117] for i in range(0, len(data), 117)]:
            encrypt_data = rsa_pri.private_encrypt(chunk.encode('utf-8'), RSA.pkcs1_padding)
            crypto += encrypt_data
        return base64.b64encode(crypto).decode('utf-8')


    @staticmethod
    def public_key_decrypt(data, public_file):
        rsa_key = RSA.load_pub_key(public_file)
        data = base64.b64decode(data)
        crypto = b''
        for chunk in [data[i:i+128] for i in range(0, len(data), 128)]:
            decrypt_data = rsa_key.public_decrypt(chunk, RSA.pkcs1_padding)
            crypto += decrypt_data
        return crypto.decode('utf-8')
    @staticmethod
    def do_post(url, data):
        headers = {"Content-Type": "application/json"}
        response = requests.post(url, data=data, headers=headers)
        if response.status_code == 200:
            return response.json()
        return None

if __name__ == '__main__':
    TopPayDemo.pay()

# Api

Method : POST
Url : https://tl-openapi.toppay.asia/gateway/order/check

# Request param

Param	Required	Type	Description	Example
mchId	Y	String	mch Id	S012031948905787
orderNum	Y	String	mch order number	A123456789
qrCode	Y	String	qrCode	qrCode：002123124716478189479838124781BHU678T778gB100.0072BHSJC7N
sign	Y	String	Sign	ja6R8eukQ...

# Request example

{
  "mchId": "S012031948905787",
  "orderNum": "A123456789",
  "qrCode": "002123124716478189479838124781BHU678T778gB100.0072BHSJC7N",
  "sign": "X/o+IQUzLJqYe9Feid9Uww72mJGOvhJSJEIfo1EUChrZyVZnzGHtd61QhOqRmXCtAwk7V7k="
}

# Response param

Param	Required	Type	Description	Example
success	Y	boolean	Is success	true/false
code	Y	int	response code	1000代表请求成功，其他的都为请求失败
message	Y	String	response message	返回具体响应信息
data	Y	Json	result	data
titleCode	Y	String	result code	result code
titleMsg	Y	String	result	result

# Response example

{
  "success": true,
  "code": 1000,
  "message": "SUCCESS",
  "data": {
    "titleMsg": "Payment voucher recognition information incomplete",
    "titleCode": "1003"
  }
}

# result code (titleCode)

TitleCode	TitleMsg
200	Order replacement successful, please confirm
301	Frequent requests, please try again later
302	Image too large to be recognized
303	Order inquiry service malfunction, please contract customer service
1001	Payment voucher cannot be recognized
1002	Payment voucher recognition failed
1003	Payment voucher recognition information incomplete
1004	Voucher payment time is not within the last 3 days
1005	Payment voucher has been recognized twice
2001	The current voucher's receiving card is not TopPay
2002	Automatic order replacement is not currently supported
3001	Payment voucher already has a corresponding order
3002	Multiple receiving cards correspond
3004	Voucher matched multiple suspected orders
3005	Voucher matched suspected order
3006	Incorrect order provided
3007	Abnormal order status
3008	Order amount provided does not match voucher amount
3011	Amount too large the order

Account Balance Inquiry Append

API Document

Choose mode

Voucher Check

Voucher Check

# Code example

# Api

# Request param

# Request example

# Response param

# Response example

# result code (titleCode)