Skip to main content
POST
获取认证 URL

Overview

This page documents the POST /payment/open/v1/certification/url endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.

Notes

  • Authentication uses the standard GatePay signed headers.
  • This endpoint retrieves the KYB certification page URL.
  • The returned URL already includes the authentication token parameter and can be accessed directly.
  • Institutional requests must include X-GatePay-On-Behalf-Of to specify the institutional sub-account to operate on.
  • For shared signing rules, see /api-reference/version/100/en/common/securityAndSignature.

Important Notes

  • The request body must include expireSeconds to specify the certification URL expiration time
  • The token parameter in the URL contains authentication information and should be kept secure

Headers

X-GatePay-On-Behalf-Of
string
required

机构子账户 ID

X-GatePay-Merchant-Id
string
required

商户 ID

X-GatePay-Certificate-ClientId
string
required

客户端 ID(证书专用)

Body

application/json
expireSeconds
integer
required

认证URL过期时间(秒)

Example:

86400

requestId
string

请求 ID,用于追踪请求来源(可选参数)

Response

200 - application/json

成功响应

code
string
Example:

"0"

message
string
Example:

"success"

data
object