API对接技术文档

代付下单

# 代码示例

  • 代码示例仅供参考，具体参数说明请参考请求参数说明

TopPayRequestUtil(点击获取代码示例)

import com.google.gson.Gson;
import com.google.gson.JsonObject;
import java.util.Map;
import java.util.TreeMap;
public class TopCashDemo {

  //MCH_ID: 商户ID
  //请登录商户后台，点击 个人中心 > 个人信息 在基本信息中获取商户ID
  private static final String MCH_ID = "S820250514103726000009";
  // 平台公钥
  private static final String PLAT_PUBLIC_KEY = "MIGfMA0GC..........oQIDAQAB";
  // 商户私钥
  private static final String MCH_PRIVATE_KEY = "MIICeA2n2Rut..........NxI2kXf3Vp";
  private static final String cashUrl = "https://vnm-openapi.toppay.asia/gateway/payOut";
  private static final String cashNotify = "http://xxxxx";

  public static void main(String[] args) throws Exception {
    cash();
  }
  private static void cash() throws Exception {
    Map<String, String> requestParams = new TreeMap<>();
    requestParams.put("merchantCode", MCH_ID);
    requestParams.put("orderNum", "T1234567890"); // 商户订单号
    requestParams.put("method", "DISBURSEMENT"); // 收款方式（默认传DISBURSEMENT）
    requestParams.put("orderType", "0"); // 订单类型默认传0
    requestParams.put("money", "20000"); // 订单金额(仅支持正整数格式金额)
    requestParams.put("feeType", "0");  //  手续费类型（0-帐内扣除，1-帐外扣除）
    requestParams.put("dateTime", "20200101235959");// 时间戳 格式 yyyyMMddHHmmss
    requestParams.put("bankCard", "1154149865112");     // 客户银行卡号
    requestParams.put("bankCode", "SCB");       // 银行编码：参考附录I 代付
    requestParams.put("accountName", "accountName");  // 客户名称
    requestParams.put("extendParam", "TEST");    // 透传参数
    requestParams.put("notifyUrl", cashNotify);  // 回调地址
    List<String> paramNameList = new ArrayList<>();
    for (String key : requestParams.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(cashUrl, postJson);  // 发送 post json请求
    System.out.println("Response Msg:" + responseJson);

    boolean pass = TopPayRequestUtil.verifySign(new Gson().fromJson(responseJson, JsonObject.class), PLAT_PUBLIC_KEY);  // 签名验证
    if (pass) {
      // ... 签名验证通过,执行正常的业务逻辑
    } else {
      // ... 签名验证错误
    }
  }
}


<?php
    // 平台公钥，从密钥配置中获取
    $platPublicKey = 'MIGfMA0GCSqGSI..........oSO6wIDAQAB';
    // 商户私钥，商户自己生成
    $mchPrivateKey = 'MIICdwIBADANB............GAe3OWNg=';
    //请登录商户后台，点击 个人中心 > 个人信息 在基本信息中获取商户ID
    $merchantCode = 'YOUR_MERCHANT_CODE_HERE';
    // 商户订单号
    $orderNum = 'T'.date("YmdHis",time());
    // 支付方式 
    // Method 
    $method = 'DISBURSEMENT';
    //订单类型默认传0
    $orderType = '0';
    // 出款金额 withdraw money, 仅支持正整数格式金额
    $money = '20000';
    // 手续费类型（0-帐内扣除，1-帐外扣除）
    $feeType = '1';
    // 时间戳 格式 yyyyMMddHHmmss
    $dateTime = date("YmdHis",time());
    // 客户银行卡号
    $bankCard = '123456';
    // 银行编码（详情参考文档底部）
    $bankCode = 'SCB';
    // 在付款确认页面显示的转账对象
    $accountName = 'accountName';
    // 透传参数
    $extendParam = 'TEST';
    // 回调地址
    $notifyUrl = 'http://example.com/callback';
    $params = array(
        'merchantCode' => $merchantCode,
        'orderType' => $orderType,
        'method' => $method,
        'orderNum' => $orderNum,
        'money' => $money,
        'feeType' => $feeType,
        'dateTime' => $dateTime,
        'bankCard' => $bankCard,
        'bankCode' => $bankCode,
        'accountName' => $accountName,
        'notifyUrl' => $notifyUrl,
        'extendParam' => $extendParam
    );

    ksort($params);
    $params_str = '';
    foreach ($params as $key => $val) {
        $params_str = $params_str . $val;
    }


    $sign = pivate_key_encrypt($params_str, $mchPrivateKey);

    $params['sign'] = $sign;

    $params['accountName'] = $accountName;
    $params['extendParam'] = $extendParam;

    $params_string = json_encode($params);
    $url = 'https://vnm-openapi.toppay.asia/gateway/payOut';
    $ch = curl_init();

    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
    curl_setopt($ch, CURLOPT_POSTFIELDS, $params_string);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
        'Content-Type: application/json',
        'Content-Length: ' . strlen($params_string))
    );
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);

    //execute post
    $request = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

    if($httpCode == 200)
    {
        $result = json_decode($request, true);
        echo "platRespCode :". $result['platRespCode'] . "\n";
        echo "platRespMessage :". $result['platRespMessage'] . "\n";
        echo "platOrderNum :". $result['platOrderNum'] . "\n";
        echo "orderNum :". $result['orderNum'] . "\n";
        echo "status :". $result['status'] . "\n";
        echo "statusMsg :". $result['statusMsg'] . "\n";
        echo "money :". $result['money'] . "\n";
        echo "feeType :". $result['feeType'] . "\n";
        echo "bankCode :". $result['bankCode'] . "\n";
        echo "bankCard :". $result['bankCard'] . "\n";
        echo "accountName :". $result['accountName'] . "\n";
        echo "extendParam :". $result['extendParam'] . "\n";
        echo "platSign :". $result['platSign'] . "\n";

        $decryptStr = public_key_decrypt($result['platSign'], $platPublicKey);
        echo "decryptStr :". $decryptStr . "\n";
    }
    else {
        echo $httpCode;
    }

    function pivate_key_encrypt($data, $pivate_key)
    {
        $pivate_key = '-----BEGIN PRIVATE KEY-----'."\n".$pivate_key."\n".'-----END PRIVATE KEY-----';
        $pi_key = openssl_pkey_get_private($pivate_key);
        $crypto = '';
        foreach (str_split($data, 117) as $chunk) {
            openssl_private_encrypt($chunk, $encryptData, $pi_key);
            $crypto .= $encryptData;
        }

        return base64_encode($crypto);
    }

    function public_key_decrypt($data, $public_key)
    {
        $public_key = '-----BEGIN PUBLIC KEY-----'."\n".$public_key."\n".'-----END PUBLIC KEY-----';
        $data = base64_decode($data);
        $pu_key =  openssl_pkey_get_public($public_key);
        $crypto = '';
        foreach (str_split($data, 128) as $chunk) {
            openssl_public_decrypt($chunk, $decryptData, $pu_key);
            $crypto .= $decryptData;
        }

        return $crypto;
    }

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 CreateTransferDemo
    {
        //MCH_ID: 商户ID
        //请登录商户后台，点击 个人中心 > 个人信息 在基本信息中获取商户ID
        private static readonly string MCH_ID = "S820250514103726000009";
        private static readonly string PLAT_PUBLIC_KEY = "MIGfMA0GCSqGS.......IDAQAB";  // 平台公钥
        private static readonly string MCH_PRIVATE_KEY = "MIICdwIB1nTFjKS............3OWNg=";  // 商户私钥
        private static readonly string cashUrl = "https://vnm-openapi.toppay.asia/gateway/payOut";
        public static void requestTransfer()
        {
            long currenttimemillis = (long)(DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalMilliseconds;
            string merchantCode = MCH_ID;                                             // 商户号
            string orderNum = "CASH" + currenttimemillis.ToString();                    // 商户订单号
            string money = "20000";                                                     // 订单金额(仅支持正整数格式金额)
            string feeType = "1";                                                      		 // 手续费收取方式 0：从提现金额中扣除 1：手续费另计
            string dateTime = "20191107105500";                                         // 时间戳 格式 yyyyMMddHHmmss
            string accountName = "CHANDRA DERMAWAN";                                           // 收款账号名称
            string bankCard = "3500035098";                                               // 收款账号，注意收款姓名与收款卡号需要对应一致，不然可能会导致转账失败
            string bankCode = "SCB";                                                    // 银行编号，参数列表见附录
            string extendParam = "TestCash";                                            // 透传参数
            string notifyUrl = "https://www.baidu.com";                                 // 回调地址
            Dictionary<string, object> VarPost = new Dictionary<string, object>();
            VarPost.Add("merchantCode", merchantCode);//用a标识的参数，并用POST传值方式传给网页 ­
            VarPost.Add("orderNum", orderNum);
            VarPost.Add("money", money);
            VarPost.Add("feeType", feeType);
            VarPost.Add("dateTime", dateTime);
            VarPost.Add("accountName", accountName);
            VarPost.Add("bankCard", bankCard);
            VarPost.Add("bankCode", bankCode);
            VarPost.Add("extendParam", extendParam);
            VarPost.Add("notifyUrl", notifyUrl);
            List<string> paramNameList = new List<string>();
            foreach (string key in VarPost.Keys)
            {
                paramNameList.Add(key);
            }
            paramNameList.Sort();// 排序key
            StringBuilder stringBuilder = new StringBuilder();
            for (int i = 0; i < paramNameList.Count; i++)
            {
                string key = paramNameList[i];
                stringBuilder.Append(VarPost[key]);  // 拼接参数
            }
            String keyStr = stringBuilder.ToString();  // 得到待加密的字符串
            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(cashUrl, "POST", jsonStr);
            Console.WriteLine("return:" + sRemoteInfo);     //接收字符串
            Dictionary<string, object> dict = JsonNewtonsoft.DeserializeJsonToDict(sRemoteInfo);
            bool pass = false;
            try
            {
                RSAForJava rsa = new RSAForJava();
                pass = rsa.verifySign(dict, PLAT_PUBLIC_KEY);  // 签名验证
            }
            catch (Exception ex)
            {
                Console.WriteLine(ex.Message);
            }
            Console.WriteLine("verifysign:"+ pass);
        }
    }
}


package main

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

// 创建json请求结构
type RequestBody struct {
	MerchantCode string `json:"merchantCode"`
	OrderType    string `json:"orderType"`
	OrderNum     string `json:"orderNum"`
	Method       string `json:"Method"`
	Money        string `json:"money"`
	FeeType      string `json:"feeType"`
	DateTime     string `json:"dateTime"`
	BankCard       string `json:"bankCard"`
	BankCode     string `json:"bankCode"`
	AccountName         string `json:"accountName"`
	extendParam  string `json:"extendParam"`
	NotifyUrl    string `json:"notifyUrl"`
	Sign         string `json:"sign"`
}

func main() {
	//公私钥（仅用于测试）
	cryptor := NewCryptor()
	cryptor.Pub64 = "MIGfMA0GCSqGSUAA4G...........7Bj0wIDAQAB"
	cryptor.Pri64 = "MIICdwIBADANBgkqhkiG9w0BAQ........................eWWBDEfuk="
	
	url := "https://vnm-openapi.toppay.asia/gateway/payOut"
	//具体下单参数内容
	request := RequestBody{
		//MerchantCode: 商户ID
        //请登录商户后台，点击 个人中心 > 个人信息 在基本信息中获取商户ID
		MerchantCode: "S820250514103726000009",
		// 订单类型默认传0
		OrderType: "0",
		// 商户订单号
		OrderNum: "H202404161637",
		// 收款方式（默认传DISBURSEMENT）
		Method: "DISBURSEMENT",
		// 订单金额(仅支持正整数格式金额)
		Money: "100",
		//  手续费类型（0-帐内扣除，1-帐外扣除）
		FeeType: "0",
		// 时间 格式 yyyyMMddHHmmss
		DateTime: "20220101235959",
		// 客户银行卡号
		BankCard: "1548425413",
		// 银行编码：参考附录I 代付
		BankCode: "SCB",
		// 客户名称
		AccountName: "accountName",
		// 透传参数
		extendParam: "TEST",
		// 回调地址
		NotifyUrl: "openapi",
	}
	// 将结构体的字段按JSON标签排序并拼接其值
	sortedValues, err := sortedConcatenatedValues(request)
	if err != nil {
		fmt.Printf("Error: %s\n", err)
		return
	}
	//将排序拼接后的值，使用私钥进行加密，并进行base64编码
	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))
	//进行http请求
	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))
}

// 使用结构体的 JSON 标签按照ASCII进行排序并拼接对应值为一个字符串
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] // 忽略omitempty选项
		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 TopCashDemo:
    # 商户私钥存储地址
    MCH_PRI_KEY_FILE = '\data\company_rsa_private_key.pem'
    # 平台公钥保存地址
    MCH_PUBLIC_KEY_FILE = '\data\plat_rsa_public_key.pem'
    # MCH_ID: 商户ID
    # 请登录商户后台，点击 个人中心 > 个人信息 在基本信息中获取商户ID
    MCH_ID = "S820250514103726000009"
    # 代付业务请求地址
    url = "https://vnm-openapi.toppay.asia/gateway/payOut"
    # 回调通知地址
    notify_url = "your notify url"

    @staticmethod
    def cash():
        request_params = OrderedDict()
        # 商户ID，可以在商户后台获取
        request_params["merchantCode"] = TopCashDemo.MCH_ID
        # 订单类型默认传0
        request_params["orderType"] = "0"
        # 收款方式 默认传DISBURSEMENT
        request_params["method"] = "DISBURSEMENT"
        # 商户订单号
        request_params["orderNum"] = "T1642592278863"
        # 代付金额(仅支持正整数格式金额)
        request_params["money"] = "10000" 
        # 手续费类型 0：代付金额内扣除，1：手续费另计
        request_params["feeType"] = "1"
        # 银行编码：参考附录I 代付
        request_params["bankCode"] = "SCB"
        # 客户银行卡号
        request_params["bankCard"] = "12312431241"
        # 客户名称
        request_params["accountName"] = "Jack"
        # 按请求参数返回
        request_params["extendParam"] = "代付下单"
        # 回调地址
        request_params["notifyUrl"] = TopCashDemo.notify_url 
        # 时间戳 格式 yyyyMMddHHmmss
        request_params["dateTime"] = "20220101235959"

        # 根据key进行参数排序
        key_str = ''.join([str(value) for value in request_params.values()])
        print("keyStr:", key_str)

        # 加密
        signed_str = TopCashDemo.private_encrypt(key_str, TopCashDemo.MCH_PRI_KEY_FILE)
        request_params["sign"] = signed_str

        # 发送请求
        post_json = json.dumps(request_params)
        print("Post Json Params:", post_json)

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

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

    @staticmethod
    def private_encrypt(data, prikey_file):
        rsa_pri = RSA.load_key(prikey_file)
        # 使用私钥加密数据
        # M2Crypto.RSA.pkcs1_padding 是一种常见的填充方式
        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__':
    TopCashDemo.cash()

const { encryptWithPrivateKey} = require('./RSAUtil');
const axios = require('axios');

//具体下单参数内容
//MerchantCode: 商户ID
//请登录商户后台，点击 个人中心 > 个人信息 在基本信息中获取商户ID
var MerchantCode = 'S820250514103726000009'
//订单类型默认传0
var OrderType = '0'
//商户订单号
var OrderNum = 'H202404161637110012'
//收款方式（默认传DISBURSEMENT）
var Method = 'DISBURSEMENT'
//订单金额(仅支持正整数格式金额)
var Money = '100'
//手续费类型（0-帐内扣除，1-帐外扣除）
var FeeType = '0'
//时间 格式 yyyyMMddHHmmss
var DateTime = '20220101235959'
//客户银行卡号
var BankCard = '1548425413'
//银行编码：参考附录I 代付
var BankCode = 'SCB'
//客户名称
var AccountName = 'accountName'
//透传参数
var extendParam = 'test'
//回调地址
var NotifyUrl = 'https://xxx'

const data = {
    merchantCode: MerchantCode,
    orderType: OrderType,
    orderNum: OrderNum,
    method: Method,
    money: Money,
    feeType: FeeType,
    dateTime: DateTime,
    bankCard: BankCard,
    bankCode: BankCode,
    accountName: AccountName,
    extendParam: extendParam,
    notifyUrl: NotifyUrl
};

//将对象的键名按ASCII码排序
const sortedKeys = Object.keys(data).sort();

//使用排序后的键名拼接它们的值
let sortedString = '';
sortedKeys.forEach(key => {
    sortedString += data[key];
});

console.log(sortedString);
var sign = encryptWithPrivateKey(sortedString);
//将sign添加到data对象中
data.sign = sign;
const jsonData = JSON.stringify(data);
console.log(jsonData)

//代付url
var url = 'https://vnm-openapi.toppay.asia/gateway/payOut'

//请求选项
axios.post(url, jsonData,{
  headers: {
    'Content-Type': 'application/json'
  }
})
.then((response) => {
  console.log('状态码:', response.status);
  console.log('响应数据:', response.data);
})
.catch((error) => {
  console.error('请求失败:', error);
});

# 请求地址

  • 请求方式 : POST
  • 请求地址 : https://vnm-openapi.toppay.asia/gateway/payOut

# 请求参数

注：所有的参数中，不要填写中文！！！

参数 类型 必填 描述 示例
merchantCode String Y 商户ID，在商户平台获取 S820250514103726000009
orderType string(10) Y 订单类型 默认传0
method string(10) Y 收款方式 默认传DISBURSEMENT
orderNum String Y 商户订单号 10000001
money String Y 代付金额 10000(仅支持正整数格式金额)
feeType String Y 手续费类型 0 : 代付金额内扣除(实际到账金额=下单金额-手续费)
1 : 手续费另计(实际到账金额=下单金额)
bankCode String Y 银行编号 SCB
点击查看支持的银行编码
bankCard String Y 客户银行卡号 12312431241
accountName String Y 客户名称 accountName
notifyUrl String Y 回调地址 https://123123.com
dateTime String Y 时间戳格式：yyyyMMddHHmmss 20200101235959
extendParam String Y 按请求参数返回 代付下单
sign String Y 签名 Yg+ePvTFhiRrARcZKBcRG0l8 ...

# 请求报文示例

{
  "merchantCode": "S820250514103726000009",
  "orderType": "0",
  "method": "DISBURSEMENT",
  "orderNum": "T1234567890",
  "money": "10000",
  "feeType": "1",
  "bankCode": "SCB",
  "bankCard": "2021071209403321313122",
  "accountName": "test cash accountName",
  "notifyUrl": "your notify url",
  "dateTime": "20220101235959",
  "extendParam": "test cash",
  "sign": "Yg+ePvTFhiRrARcZKBcRG0l89rqisPIuZQStYqBIwSMPaqwH77qRXI1J+jElOBpa"
}

# 响应参数

参数 类型 必填 描述 示例
platRespCode String Y 请求业务是否成功 FAIL:失败\SUCCESS:成功
platRespMessage String Y 接口响应信息提示 请求成功
platOrderNum String Y 平台订单号 PI1453242857400963072
orderNum String Y 商户订单号 23645782
status Int Y 订单状态 查看订单状态描述
statusMsg String Y 订单状态信息 Apply
money String Y 代付金额 10000
feeType String Y 手续费类型 0：订单内扣除，
1：手续费另计
bankCode String N 银行编号 SCB
点击查看支持的银行编码
bankCard String Y 客户银行卡号 12312431241
accountName String Y 客户名称 accountName
extendParam String Y 按请求参数返回 代付下单
platSign String Y 签名 PI1453242857400963072

# 代付响应报文示例

{
  "platRespCode": "SUCCESS",
  "platRespMessage": "Request success",
  "platOrderNum": "W0620220119174331000001",
  "orderNum": "T1234567890",
  "status": 0,
  "statusMsg": "Apply",
  "money": "10000",
  "feeType": "0",
  "bankCode": "SCB",
  "bankCard": "2021071209403321313122",
  "accountName": "test cash accountName",
  "extendParam": "test cash",
  "platSign": "E5uNF7B9NXyhtlRo2I7/KVHN4Sbz0c3VbwCLpH3vjUpv6Cai+bmJA/Q8dVE2RJRe1+dsbzg=="
}

# 代付异步通知

  • 进行验签时，要用 商户后台-收付款配置-API配置中提供的平台公钥进行解密！！！
  • 进行验签时，以实际回调的参数为准，不要验签固定的参数
  • 订单的最终状态以通知的status为准！！！
  • TopPay结果异步通知后,需响应 SUCCESS 字符串,否则TopPay将继续向下游发起5次通知。
  • TopPay结果异步通知,我们的通知IP为 35.240.188.94 请将我们的通知IP加入白名单。

# 通知参数

参数 描述 示例
platOrderNum 平台订单号 BK_1563278763273
orderNum 商户订单号 T1231511321515
money 代付金额 10000(仅支持正整数格式金额)
feeType 手续费类型 手续费类型
0：订单内扣除，
1：手续费另计
accountName 客户名称 accountName
bankCard 客户银行卡号 45649849659456
bankCode 到账银行 SCB
点击查看支持的银行编码
status 订单状态 查看订单状态描述
statusMsg 订单状态描述 Payout Success
extendParam 透传参数 商户上传原样返回
platSign 平台签名 ja6R8eukQY9jc8...

# 异步通知报文示例

{
  "platOrderNum": "W0620220119174331000001",
  "orderNum": "T1234567890",
  "money": "10000",
  "feeType": "0",
  "accountName": "test cash accountName",
  "bankCard": "2021071209403321313122",
  "bankCode": "SCB",
  "status": "2",
  "statusMsg": "SUCCESS",
  "extendParam": "test cash",
  "platSign": "LGEpz2LjbZ6Iyvn+zLc/+t26AaH0aEhHVD62lSCdo6XIkAg86AUncCvmym62wVoE3r2+dHnv27qi/01UQDcqFK8DYioRCcydYSjB4QRVezG3fcZlhWrACmWGacnXkE7p5zChL7pK5h0HuBhbo1zKt4FunQR6QMmcBVfv7YfB3W0"

}

订单信息查询