Menu
User login
产品能力API字典接口规则接入规范常见问题名词表更新日志

开发指引

更新时间：2025.03.24

1. 接口规则

为了在保证支付安全的前提下，带给商户简单、一致且易用的开发体验，我们推出了全新的微信支付APIv3接口。该版本API的具体规则请参考“APIv3接口规则”

2. 开发环境搭建

为了帮助开发者调用开放接口，我们提供了Java、PHP、GO语言版本的开发库，封装了签名生成、签名验证、敏感信息加/解密、媒体文件上传等基础功能

JAVA

2.1.1. 使用条件

  • WechatPay merchant account

  • Java 1.8 or later

  • Maven or Gradle;

  • 0.4.6 or later version of the Java httpClient SDK

2.1.2. 安装

Gradle：在你的 build.gradle 文件中加入如下的依赖

1implementation 'com.github.wechatpay-apiv3:wechatpay-apache-httpclient:0.4.7'

Maven：在 pom.xml 文件中加入以下依赖

1<dependency>
2<groupId>com.github.wechatpay-apiv3</groupId>
3<artifactId>wechatpay-apache-httpclient</artifactId>
4<version>0.4.7</version>
5</dependency>

2.1.3. 初始化

用WechatPayHttpClientBuilder初始化创建一个httpClient，httpClient将被用于发送请求调用微信支付接口。 用CertificatesManager初始化一个verifier实例，用于验证签名。

1    private CloseableHttpClient httpClient;
2    private CertificatesManager certificatesManager;
3    private Verifier verifier;
4
5    @Before
6    //initialize verifier and build httpClient
7    public void setup() throws GeneralSecurityException, IOException, HttpCodeException, NotFoundException {
8
9        PrivateKey merchantPrivateKey = PemUtil.loadPrivateKey(privateKey);
10        certificatesManager = CertificatesManager.getInstance();
11        certificatesManager.putMerchant(merchantId, new WechatPay2Credentials(merchantId,
12                        new PrivateKeySigner(merchantSerialNumber, merchantPrivateKey)),
13                apiV3Key.getBytes(StandardCharsets.UTF_8));
14        verifier = certificatesManager.getVerifier(merchantId);
15        WechatPayHttpClientBuilder builder = WechatPayHttpClientBuilder.create()
16                .withMerchant(merchantId, merchantSerialNumber, merchantPrivateKey)
17                .withValidator(new WechatPay2Validator(verifier));
18        httpClient = builder.build();
19    }

2.1.4. 通用功能

敏感信息加密

1    @Test
2    public void encryptedTest() throws IllegalBlockSizeException {
3        String text = "helloWorld";
4        String transformation = "RSA/ECB/PKCS1Padding";
5        String encryptedText = RsaCryptoUtil.encrypt(text, verifier.getValidCertificate(), transformation);
6        System.out.println(encryptedText);
7    }

敏感信息解密

1    @Test
2    public void decryptedTest() throws BadPaddingException {
3        String encryptedText = OBTgun4jiN13n3nmSg8v0MNDMy3mbs380yq4GrgO8vwCqXnvrWxwo3jUCNY2UY7MIOtv/SD8ke64MxcSB0hn5EzKv1LOLprI3NvvmNLS4C3SBulxpZG62RYp1+8FgwAI4M//icXvjtZWVH4KVDg==";
4        String transformation = "RSA/ECB/PKCS1Padding";
5        String decryptedText = RsaCryptoUtil.decrypt(encryptedText, PemUtil.loadPrivateKey(privateKey), transformation);
6        assert("helloWorld".equals(decryptedText));
7    }

Golang

2.2.1. 使用条件

  • WechatPay merchant account

  • GO SDK 0.2.13 or later version

2.2.2. 安装

1. 使用 Go Modules 管理你的项目

如果你的项目还不是使用 Go Modules 做依赖管理，在项目根目录下执行：

go mod init

2. 无需 clone 仓库中的代码，直接在项目目录中执行：

来添加依赖，完成 go.mod 修改与 SDK 下载

2.2.3. 初始化

初始化Client并向Client中加载商户号，私钥，API V3 key，商户证书和序列号， 用于之后发送接口请求。

1import (
2   "context"
3   "crypto/rand"
4   "crypto/rsa"
5   "crypto/x509"
6   "encoding/base64"
7   "fmt"
8   "github.com/wechatpay-apiv3/wechatpay-go/core"
9   "github.com/wechatpay-apiv3/wechatpay-go/core/option"
10   "github.com/wechatpay-apiv3/wechatpay-go/utils"
11   "log"
12   "net/http"
13)
14
15var (
16   mchID                      = ""                  // merchant id
17   mchCertificateSerialNumber = "" // merchant certificate serial number
18   mchAPIv3Key                = ""                  // merchant api v3 key
19   header                     = make(http.Header)
20   ctx                        = context.Background()
21   cert                       *x509.Certificate
22   mchPrivateKey              *rsa.PrivateKey
23   client                     *core.Client
24   err                        error
25)
26
27func setup() {
28   //Load platform certificate
29   cert, err = utils.LoadCertificateWithPath("Path/To/Platform/Cert")
30   if err != nil {
31      log.Fatal(err)
32   }
33   // Load private key
34   mchPrivateKey, err = utils.LoadPrivateKeyWithPath("Path/To/Private/Key")
35   if err != nil {
36      log.Fatal("load merchant private key error")
37   }
38   // Initialize client which is capable to update platform certificate periodically
39   opts := []core.ClientOption{
40      option.WithWechatPayAutoAuthCipher(mchID, mchCertificateSerialNumber, mchPrivateKey, mchAPIv3Key),
41   }
42   client, err = core.NewClient(ctx, opts...)
43   if err != nil {
44      log.Fatalf("new wechat pay client err:%s", err)
45   }
46}

2.2.4. 通用功能

敏感信息加密

1
2func Encryption(t *testing.T) {
3	var testRSACryptoUtilMchCertificateStr = `-----BEGIN CERTIFICATE-----
4	-----END CERTIFICATE-----`
5	testRSACryptoUtilCertificate, _ = LoadCertificate(testRSACryptoUtilMchCertificateStr)
6   const message = "hello world"
7   
8   // 使用OAEP padding方式对证书加密
9   ciphertext, _ := EncryptOAEPWithCertificate(message, testRSACryptoUtilCertificate)
10   
11   // 使用PKCS1 padding对证书加密
12   ciphertext, _ := EncryptPKCS1v15WithCertificate(message, testRSACryptoUtilCertificate)
13}
14

敏感信息解密

1func TestDecryption(t *testing.T) {
2	var testRSACryptoUtilPrivateKeyStr = `-----BEGIN PRIVATE KEY-----
3-----END PRIVATE KEY-----`
4	testRSACryptoUtilPrivateKey, _ = LoadPrivateKey(testingKey(testRSACryptoUtilPrivateKeyStr))
5	const ciphertext = ""
6
7	// 使用PKCS1 padding进行私钥解密
8	decryptMessage, _ := DecryptPKCS1v15(ciphertext, testRSACryptoUtilPrivateKey)
9
10	// 使用OAEP padding方式私钥解密
11	decryptMessage, _ := DecryptOAEP(ciphertext, testRSACryptoUtilPrivateKey)
12}

PHP

2.3.1. 使用条件

  • Guzzle 7.0，PHP >= 7.2.5

  • Guzzle 6.5，PHP >= 7.1.2

  • 项目已支持 PHP 8。

2.3.2. 安装

推荐使用 PHP 包管理工具 Composer 安装 SDK：

composer require wechatpay/wechatpay

2.3.3. 初始化

初始化Client并向Client中加载商户号，私钥，API V3 key，商户证书和序列号， 用于之后发送接口请求。

1
2require_once('vendor/autoload.php');
3
4use WeChatPay\Builder;
5use WeChatPay\Crypto\Rsa;
6use WeChatPay\Util\PemUtil;
7
8$merchantId = '190000****';
9$merchantPrivateKeyFilePath = 'file:///path/to/merchant/apiclient_key.pem';
10$merchantPrivateKeyInstance = Rsa::from($merchantPrivateKeyFilePath, Rsa::KEY_TYPE_PRIVATE);
11$merchantCertificateSerial = '3775B6A45ACD588826D15E583A95F5DD********';
12$platformCertificateFilePath = 'file:///path/to/wechatpay/cert.pem';
13$platformPublicKeyInstance = Rsa::from($platformCertificateFilePath, Rsa::KEY_TYPE_PUBLIC);
14$platformCertificateSerial = PemUtil::parseCertificateSerialNo($platformCertificateFilePath);
15
16// init a API V3 instance
17$instance = Builder::factory([
18    'mchid'      => $merchantId,
19    'serial'     => $merchantCertificateSerial,
20    'privateKey' => $merchantPrivateKeyInstance,
21    'certs'      => [
22        $platformCertificateSerial => $platformPublicKeyInstance,
23    ],
24]); 
25

2.3.4. 通用功能

敏感信息加密

1    $encryptor = static function(string $msg) use ($platformPublicKeyInstance): string {
2        return Rsa::encrypt($msg, $platformPublicKeyInstance, OPENSSL_PKCS1_PADDING);
3    };
4	$encryptedMsg =  $encryptor('HelloWorld');

敏感信息解密

1    $decryptor = static function(string $msg) use ($merchantPrivateKeyInstance): string {
2        return Rsa::decrypt($msg, $merchantPrivateKeyInstance, OPENSSL_PKCS1_PADDING);
3    };
4	$decryptedMsg =  $decryptor('ciphertext');

 

3. 业务时序图

3.1. 业务时序图

3.2. API接入示例

文档展示了如何使用微信支付服务端 SDK 快速接入扫码支付产品，完成与微信支付对接的部分。

注意

  • 文档中的代码示例是用来阐述 API 基本使用方法，代码中的示例参数需替换成商户自己账号及请求参数才能跑通。

  • 以下接入步骤仅提供参考，请商户结合自身业务需求进行评估、修改。

3.2.1 身份信息校验

步骤说明：该接口允许商户请求微信支付对用户支付用户的实名信息与入参中的身份信息进行一致性校验，商户可以根据校验结果使用正确的信息进行报关。

敏感信息字段：certificate_id 和 certificate_name 为用户敏感信息，为避免被中间人截获，保护用户隐私，需要按照 微信支付APIv3 加密后传输。

加密方法

  • 下载微信支付平台证书，获取证书序列号与证书公钥。

  • 在 HTTP header 中添加微信支付平台证书序列号，Wechatpay-Serial ：${微信支付平台证书序列号}。

  • 使用微信支付平台证书公钥对敏感字段进行RSA加密，填充方案选择 RSAES-PKCS1-v1_5。

  • 对密文进行 base64 编码后即可得到最终内容。

代码示例 - JAVA：

1
2//Id info verification API
3    public void idVerification() throws IOException {
4		String verifyIdInfoBody = """{
5  "appid": "wxd678efh567hg6787",
6  "mchid": "1230000109",
7  "out_trade_no": "20150806125346",
8  "transaction_id": "1000320306201511078440737890",
9  "sub_order_no": "20150806125346",
10  "customs": "SHANGHAI_ZS",
11  "merchant_customs_no": "123456",
12  "certificate_type": "IDCARD",
13  "certificate_id": "HHp24MagiQ6i7c5yIow5cJP5x2cGsAA8hi5yIow5cJP5x", // sensitive field, encryption content
14  "certificate_name": "HHp24MagiQ6i7c5yIow/9ZTk5Zt5cJP5x2cGsAA8hif07fRdb2" //sensitive field，encryption content
15}""";
16        HttpPost httpPost = new HttpPost("https://apihk.mch.weixin.qq.com/v3/global/customs/verify-certificate");
17        httpPost.addHeader("Accept", "application/json");
18        httpPost.addHeader("Content-type", "application/json; charset=utf-8");
19        httpPost.addHeader("Wechatpay-Serial", "0798ABFDCBXXXXXXXXXXXXXXXXXXXXXXX054A761");
20        httpPost.setEntity(new StringEntity(verifyIdInfoBody));
21        CloseableHttpResponse response = httpClient.execute(httpPost);
22        //Process the response
23    }
24

示例代码 - GO：

1//Call id verification API
2func idVerification() {
3   idVerificationBody := `{
4  "appid": "wxd678efh567hg6787",
5  "mchid": "1230000109",
6  "out_trade_no": "20150806125346",
7  "transaction_id": "1000320306201511078440737890",
8  "sub_order_no": "20150806125346",
9  "customs": "SHANGHAI_ZS",
10  "merchant_customs_no": "123456",
11  "certificate_type": "IDCARD",
12  "certificate_id": "HHp24MagiQ6i7c5yIow5cJP5x2cGsAA8hi5yIow5cJP5x",
13  "certificate_name": "HHp24MagiQ6i7c5yIow/9ZTk5Zt5cJP5x2cGsAA8hif07fRdb2"
14}`
15   header.Add("Wechatpay-Serial", "")
16   header.Add("Idempotency-Key", "20220518-001")
17   result, err := client.Post(ctx, "https://apihk.mch.weixin.qq.com/v3/global/customs/verify-certificate", header, nil, idVerificationBody, "application/json")
18   if err != nil {
19      // Process error
20   }
21   log.Printf("%s", result.Response.Body)
22}

示例代码 - PHP：

1//Id info verification API
2public function idInfoVerification($instance, $platformPublicKeyInstance, $platformCertificateSerial){
3    $encryptor = static function(string $msg) use ($platformPublicKeyInstance): string {
4        return Rsa::encrypt($msg, $platformPublicKeyInstance, OPENSSL_PKCS1_PADDING);
5    };
6    try {
7        $resp = $instance
8            ->chain('/v3/global/customs/verify-certificate')
9            ->post([
10                'json' => [
11                    'appid' => 'wxdace12300000000',
12                    'mchid' => '1900000000',
13                    'out_trade_no' => 'YX001',
14                    'transaction_id' => '420000000001500000089',
15                    'customs' => 'SHANGHAI_ZS',
16                    'merchant_customs_no' => '123456',
17                    'sub_order_no' => '20150806125346',
18                    'certificate_type' => 'IDCARD',
19                    'certificate_id' => 'HHp24MagiQ6i7c5yIow5cJP5x2cGsAA8hi5yIow5cJP5x',
20                    'certificate_name' => 'HHp24MagiQ6i7c5yIow/9ZTk5Zt5cJP5x2cGsAA8hif07fRdb2'
21                ],
22                'headers' => [
23                    'Wechatpay-Serial' => $platformCertificateSerial
24                ]
25            ]);
26        echo $resp->getStatusCode(), PHP_EOL;
27        echo $resp->getBody(), PHP_EOL;
28    } catch (\Exception $e) {
29        // Exception handling
30    }
31}

其他重要参数请前往身份信息校验API文档页面参考。

3.2.2 订单附加信息提交接口

步骤说明：商户通过该接口请求微信支付向海关推送支付单的报关信息。微信支付在收到报关附加信息后，会异步向海关进行支付单申报信息推送。

代码示例 - JAVA：

1
2    //Customs Declaration API
3    public void customsDeclaration() throws IOException {
4		String customsDeclarationBody= """{
5  "appid": "wxd678efh567hg6787",
6  "mchid": "1230000109",
7  "out_trade_no": "20150806125346",
8  "transaction_id": "1000320306201511078440737890",
9  "customs": "SHANGHAI_ZS",
10  "merchant_customs_no": "123456",
11  "duty": 888,
12  "sub_order_no": "20150806125346",
13  "fee_type": "CNY",
14  "order_fee": 888,
15  "transport_fee": 888,
16  "product_fee": 888
17}""";
18        HttpPost httpPost = new HttpPost("https://apihk.mch.weixin.qq.com/v3/global/customs/orders");
19        httpPost.addHeader("Accept", "application/json");
20        httpPost.addHeader("Content-type", "application/json; charset=utf-8");
21        httpPost.setEntity(new StringEntity(customsDeclarationBody));
22        CloseableHttpResponse response = httpClient.execute(httpPost);
23        //Process the response 
24    }
25
26

示例代码 - GO：

1//Call customs declaration API
2func customsDeclaration() {
3   customsDeclarationBody := `
4{
5  "appid": "wxd678efh567hg6787",
6  "mchid": "1230000109",
7  "out_trade_no": "20150806125346",
8  "transaction_id": "1000320306201511078440737890",
9  "customs": "SHANGHAI_ZS",
10  "merchant_customs_no": "123456",
11  "duty": 888,
12  "sub_order_no": "20150806125346",
13  "fee_type": "CNY",
14  "order_fee": 888,
15  "transport_fee": 888,
16  "product_fee": 888
17}
18`
19   result, err := client.Post(ctx, "https://apihk.mch.weixin.qq.com/v3/global/customs/orders", customsDeclarationBody)
20   if err != nil {
21      // Process error
22   }
23   log.Printf("%s", result.Response.Body)
24}

示例代码 - PHP：

1//Customs Declaration API
2public function customsDeclaration($instance){
3    try {
4        $resp = $instance
5            ->chain('/v3/global/customs/orders')
6            ->post([
7                'json' => [
8                    'appid' => 'wxd678efh567hg6787',
9                    'mchid' => '1230000109',
10                    'out_trade_no' => '20150806125346',
11                    'transaction_id' => '1000320306201511078440737890',
12                    'customs' => 'SHANGHAI_ZS',
13                    'merchant_customs_no' => '123456',
14                    'duty' => 888,
15                    'sub_order_no' => '20150806125346',
16                    'fee_type' => 'CNY',
17                    'order_fee' => 888,
18                    'transport_fee' => 888,
19                    'product_fee' => 888
20                ]
21            ]);
22
23        echo $resp->getStatusCode(), PHP_EOL;
24        echo $resp->getBody(), PHP_EOL;
25    } catch (\Exception $e) {
26        // Exception handling
27    }
28}

其他重要参数请前往报关API文档页面参考。

3.2.3 报关信息修改接口

步骤说明：当商户错误传了报关信息的部分字段时，可调用该接口对报关信息进行修改。该接口只能修改如下5个字段：merchant_customs_no、duty、order_fee、transport_fee、product_fee

代码示例 - JAVA：

1
2    //Modify Customs Declaration API
3    public void modifyCustomsDeclarartionTest() throws IOException {
4		String modifyCustomsDeclarationBody = """
5{
6   "appid": "wxd678efh567hg6787",
7   "mchid": "1230000109",
8   "out_trade_no": "20150806125346",
9   "transaction_id": "1000320306201511078440737890",
10   "sub_order_no": "20150806125346",
11   "customs": "SHANGHAI_ZS",
12   "merchant_customs_no": "123456",
13   "duty": 888,
14   "order_fee": 888,
15   "transport_fee": 888,
16   "product_fee": 888
17}
18""";
19        HttpPatch httpPatch = new HttpPatch("https://apihk.mch.weixin.qq.com/v3/global/customs/orders");
20        httpPatch.addHeader("Accept", "application/json");
21        httpPatch.addHeader("Content-type", "application/json; charset=utf-8");
22        httpPatch.setEntity(new StringEntity(modifyCustomsDeclarationBody));
23        CloseableHttpResponse response = httpClient.execute(httpPatch);
24        //Process the response 
25    }
26

示例代码 - GO：

1//Modify customs declaration API
2func modifyCustomsDeclarartion() {
3   modifyCustomsDeclarartionBody := `
4{
5   "appid": "wxd678efh567hg6787",
6   "mchid": "1230000109",
7   "out_trade_no": "20150806125346",
8   "transaction_id": "1000320306201511078440737890",
9   "sub_order_no": "20150806125346",
10   "customs": "SHANGHAI_ZS",
11   "merchant_customs_no": "123456",
12   "duty": 888,
13   "order_fee": 888,
14   "transport_fee": 888,
15   "product_fee": 888
16}
17`
18   result, err := client.Patch(ctx, "https://apihk.mch.weixin.qq.com/v3/global/customs/orders", modifyCustomsDeclarartionBody)
19   if err != nil {
20      // Process error
21   }
22   log.Printf("%s", result.Response.Body)
23}

示例代码 - PHP：

1//Modify Customs Declaration API
2public function modifyCustomsDeclarartion($instance){
3    try {
4        $resp = $instance
5            ->chain('/v3/global/customs/orders')
6            ->patch([
7                'json' => [
8                    'appid' => 'wxd678efh567hg6787',
9                    'mchid' => '1230000109',
10                    'out_trade_no' => '20150806125346',
11                    'transaction_id' => '1000320306201511078440737890',
12                    'customs' => 'SHANGHAI_ZS',
13                    'merchant_customs_no' => '123456',
14                    'duty' => 888,
15                    'sub_order_no' => '20150806125346',
16                    'order_fee' => 888,
17                    'transport_fee' => 888,
18                    'product_fee' => 888
19                ]
20            ]);
21
22        echo $resp->getStatusCode(), PHP_EOL;
23        echo $resp->getBody(), PHP_EOL;
24    } catch (\Exception $e) {
25        // Exception handling
26    }
27}

其他重要参数请前往报关信息修改API文档页面参考。

3.2.4 订单附加信息查询接口

步骤说明：商户可通过该接口查询之前提交的报关附加信息，以及海关报关状态。

代码示例 - JAVA：

1
2    //Query Customs Declaration API
3    public void queryCustomsDeclarationTest() throws IOException {
4        HttpGet httpGet = new HttpGet("https://apihk.mch.weixin.qq.com/v3/global/customs/orders?appid=wxd678efh567hg6787&mchid=mchid&order_type=transaction_id&order_no=1000320306201511078440737890&customs=SHANGHAI_ZS&offset=1&limit=20");
5        httpGet.addHeader("Accept", "application/json");
6        httpGet.addHeader("Content-type", "application/json; charset=utf-8");
7        CloseableHttpResponse response = httpClient.execute(httpGet);
8        //Process the response 
9    }
10

示例代码 - GO：

1
2//Call query customs declaration API
3func queryCustomsDeclaration() {
4   result, err := client.Get(ctx, "https://apihk.mch.weixin.qq.com/v3/global/customs/orders?appid=wxd678efh567hg6787&mchid=mchid&order_type=transaction_id&order_no=1000320306201511078440737890&customs=SHANGHAI_ZS&offset=1&limit=20")
5   if err != nil {
6      // Process error
7   }
8   log.Printf("%s", result.Response.Body)
9}

示例代码 - PHP：

1//Query Customs Declaration API
2public function queryCustomsDeclaration($instance){
3    try {
4        $resp = $instance
5            ->chain('/v3/global/customs/orders')
6            ->get([
7                'query' => [
8                    'mchid' => '1900000000',
9                    'appid' => 'wxd678efh567hg6787',
10                    'order_type' => 'transaction_id',
11                    'order_no' => '1000320306201511078440737890',
12                    'customs' => 'SHANGHAI_ZS',
13                    'offset' => 1,
14					'limit' => 20
15                ]
16            ]);
17        echo $resp->getStatusCode(), PHP_EOL;
18        echo $resp->getBody(), PHP_EOL;
19    } catch (\Exception $e) {
20        // Exception handling
21    }
22}

其他重要参数请前往报关查询API文档页面参考。

3.2.5 订单附加信息重推接口

步骤说明：当订单已申报且海关要求商户重新推送报关信息时，商户可通过该接口将报关信息再次发往海关。

代码示例 - JAVA：

1
2    //Repush Customs Declaration API
3    public void repushCustomsDeclarartionTest() throws IOException {
4		String repushBody = """
5{
6  "appid": "wxd678efh567hg6787",
7   "mchid": "1230000109",
8   "out_trade_no": "20150806125346",
9   "transaction_id": "1000320306201511078440737890",
10   "sub_order_no": "20150806125346",
11   "sub_order_id": "1000320306201511078440737891",
12   "customs": "SHANGHAI_ZS",
13   "merchant_customs_no": "123456"
14}
15""";
16        HttpPost httpPost = new HttpPost("https://apihk.mch.weixin.qq.com/v3/global/customs/redeclare");
17        httpPost.addHeader("Accept", "application/json");
18        httpPost.addHeader("Content-type", "application/json; charset=utf-8");
19        httpPost.setEntity(new StringEntity(repushBody));
20        CloseableHttpResponse response = httpClient.execute(httpPost);
21        //Process the response 
22    }
23

示例代码 - GO：

1//Repush customs declaration API
2func repushCustomsDeclarartion() {
3   repushBody := `
4{
5  "appid": "wxd678efh567hg6787",
6   "mchid": "1230000109",
7   "out_trade_no": "20150806125346",
8   "transaction_id": "1000320306201511078440737890",
9   "sub_order_no": "20150806125346",
10   "sub_order_id": "1000320306201511078440737891",
11   "customs": "SHANGHAI_ZS",
12   "merchant_customs_no": "123456"
13}
14`
15   result, err := client.Post(ctx, "https://apihk.mch.weixin.qq.com/v3/global/customs/redeclare", repushBody)
16   if err != nil {
17      // Process error
18   }
19   log.Printf("%s", result.Response.Body)
20}

示例代码 - PHP：

1//Repush Customs Declaration API
2public function repushCustomsDeclarartion($instance){
3    try {
4        $resp = $instance
5            ->chain('v3/global/customs/redeclare')
6            ->post([
7                'json' => [
8                    'mchid' => '1230000109',
9                    'appid' => 'wxd678efh567hg6787',
10                    'out_trade_no' => '20150806125346',
11                    'transaction_id' => '1000320306201511078440737890',
12                    'sub_order_no' => '20150806125346',
13                    'sub_order_id' => '1000320306201511078440737891',
14                    'customs' => 'SHANGHAI_ZS',
15                    'merchant_customs_no' => '123456'
16                ]
17            ]);
18        echo $resp->getStatusCode(), PHP_EOL;
19        echo $resp->getBody(), PHP_EOL;
20    } catch (\Exception $e) {
21        // Exception handling
22    }
23}

其他重要参数请前往报关重推API文档页面参考。

1. 接口规则
2. 开发环境搭建
JAVA
2.1.1. 使用条件
2.1.2. 安装
2.1.3. 初始化
2.1.4. 通用功能
Golang
2.2.1. 使用条件
2.2.2. 安装
2.2.3. 初始化
2.2.4. 通用功能
PHP
2.3.1. 使用条件
2.3.2. 安装
2.3.3. 初始化
2.3.4. 通用功能
3. 业务时序图
3.1. 业务时序图
3.2. API接入示例
3.2.1 身份信息校验
3.2.2 订单附加信息提交接口
3.2.3 报关信息修改接口
3.2.4 订单附加信息查询接口
3.2.5 订单附加信息重推接口
语言
置顶

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2025 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

ICP证

粤B2-20090059

Contact Us

Customer Service Tel

+86 571 95017

9:00-18:00 Monday-Friday GMT+8

Business Development

wxpayglobal@tencent.com

Developer Support

wepayTS@tencent.com

Wechat Pay Global

About Tenpay
Powered By Tencent & Tenpay Copyright© 2005-2025 Tenpay All Rights Reserved.