转账凭证下载接口

{
  "appId": "you_system_appid",
  "subMerchantNo": "your_user_id",
  "bizContent": "{\"orderNo\":\"ORDER202608013137111100000000007\"}",
  "version": "1.0",
  "nonce": "49d55020fa3adf6ed67b253c583ccdaa",
  "contentHash": "95772c8a0c74e52b707e2ace5963e0eae956e8b1ae26e86a6cde5469247d0382",
  "timestamp": "2026-08-05 10:30:00",
  "sign": "your_sign"
}

import requests
import json
import hashlib

def get_voucher(query_params):
    """获取转账凭证下载链接"""
    sys_appid = "your_sys_appid"
    open_subMerchantNo = "your_open_subMerchantNo"
    sign_key = "your_sign_key"
    api_url = "https://openapi.shuhuipay.com/v1/order/voucher"

    request_data = {
        "appId": sys_appid,
        "subMerchantNo": open_subMerchantNo,
        "version": "1.0",
        "timestamp": "2026-08-05 10:30:00",
        "nonce": "49d55020fa3adf6ed67b253c583ccdaa",
        "bizContent": json.dumps(query_params),
        "contentHash": "95772c8a0c74e52b707e2ace5963e0eae956e8b1ae26e86a6cde5469247d0382",
    }

    sign = generate_sign(request_data, sign_key)
    request_data["sign"] = sign

    try:
        response = requests.post(api_url, json=request_data, timeout=30)
        return response.json()
    except Exception as e:
        print(f"查询失败: {e}")
        return None

def generate_sign(params, sign_key):
    sorted_params = sorted(params.items())
    sign_str = "&".join([f"{k}={v}" for k, v in sorted_params if v])
    sign_str += f"&key={sign_key}"
    return hashlib.md5(sign_str.encode()).hexdigest().upper()

# 方式一：通过平台订单号查询
result = get_voucher({"transactionNo": "SHTRANS202608042051264580514"})

# 处理返回结果
if result and result.get("code") == "0000":
    data = result.get("data", {})
    download_url = data.get("downloadUrl")
    if download_url:
        print(f"凭证下载链接: {download_url}")
        # 下载文件
        file_response = requests.get(download_url)
        with open("voucher.pdf", "wb") as f:
            f.write(file_response.content)
        print("凭证已保存为 voucher.pdf")
else:
    print(f"获取失败: {result.get('message')}")

<?php

class VoucherDownload {
    private $appId = 'your_app_id';
    private $subMerchantNo = 'your_user_id';
    private $signKey = 'your_sign_key';
    private $apiUrl = 'https://openapi.shuhuipay.com/v1/order/voucher';

    public function getVoucher($queryParams) {
        $requestData = [
            'appId'       => $this->appId,
            'subMerchantNo'      => $this->subMerchantNo,
            'bizContent'  => json_encode($queryParams),
            'version'     => '1.0',
            'nonce'       => '49d55020fa3adf6ed67b253c583ccdaa',
            'contentHash' => '95772c8a0c74e52b707e2ace5963e0eae956e8b1ae26e86a6cde5469247d0382',
            'timestamp'   => '2026-08-05 10:30:00',
        ];

        $requestData['sign'] = $this->generateSign($requestData);
        $response = $this->httpPost($this->apiUrl, $requestData);
        return json_decode($response, true);
    }

    private function generateSign($params) {
        ksort($params);
        $signStr = '';
        foreach ($params as $key => $value) {
            if ($value !== '') {
                $signStr .= "{$key}={$value}&";
            }
        }
        $signStr .= "key={$this->signKey}";
        return strtoupper(md5($signStr));
    }

    private function httpPost($url, $data) {
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
        curl_setopt($ch, CURLOPT_TIMEOUT, 30);
        $response = curl_exec($ch);
        curl_close($ch);
        return $response;
    }
}

// 通过平台订单号获取凭证
$result = (new VoucherDownload())->getVoucher([
    'transactionNo' => 'SHTRANS202608042051264580514'
]);

// 处理返回结果
if ($result && $result['code'] === '0000') {
    $data = $result['data'] ?? [];
    $downloadUrl = $data['downloadUrl'] ?? '';
    if (!empty($downloadUrl)) {
        echo "凭证下载链接: " . $downloadUrl;
        // 下载文件
        $fileContent = file_get_contents($downloadUrl);
        file_put_contents('voucher.pdf', $fileContent);
        echo "凭证已保存为 voucher.pdf";
    }
} else {
    echo "获取失败: " . ($result['message'] ?? '未知错误');
}