tencent cloud

APIs

RequestPaymentMerchantBinding

Download
フォーカスモード
フォントサイズ
最終更新日: 2026-07-17 12:41:49

1. API Description

Domain name for API request: tcsas.intl.tencentcloudapi.com.

This API is used to request the binding of a payment merchant to a team.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: RequestPaymentMerchantBinding.
Version Yes String Common Params. The value used for this API: 2025-01-06.
Region Yes String Common Params. For more information, please see the list of regions supported by the product.
PlatformId Yes String

Platform ID.

TeamId No String

Mini program appid.

MerchantID No String

Merchant ID.

MerchantName No String

Merchant name.

3. Output Parameters

Parameter Name Type Description
Data MerchantBindApprovalResp

Response parameters structure for the application of a mini program team to bind a merchant ID.

RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Requesting Payment Merchant Binding by a Mini Program Team

Input Example

POST / HTTP/1.1
Host: tcsas.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: RequestPaymentMerchantBinding
<Common request parameters>

{
    "PlatformId": "T08123WM5791733VNCZ",
    "TeamId": "8818371998",
    "MerchantID": "openapimerchant",
    "MerchantName": "OpenAPI Merchant"
}

Output Example

{
    "Response": {
        "Data": {
            "ApprovalResult": true,
            "ResourceId": "AN08057581F268124178350CC9837"
        },
        "RequestId": "82477aac-36f4-49d9-9905-18e4bbbf0e10"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
FailedOperation.ExistMerchantBindApply A merchant binding request already exists.
FailedOperation.ExistMerchantBindRelation The merchant is already bound.
FailedOperation.MerchantPaymentFunctionClosed The superapp payment configuration is disabled.
FailedOperation.OperationsTeamNoMiniProgramPermission FailedOperation.OperationsTeamNoMiniProgramPermission
FailedOperation.PaymentRecordNotBelongToApplication Invalid superapp ID or parameter ID.
InternalError Internal error.
InvalidParameter Incorrect parameter.
InvalidParameterValue.InvalidMerchantId Invalid merchant ID.
InvalidParameterValue.InvalidMerchantName Invalid merchant name.

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック