---
title: "获取认证 URL"
method: POST
path: "/pay-cashier/open/v1/certification/url"
tags: ["Institutional"]
---

# 获取认证 URL

`POST /pay-cashier/open/v1/certification/url`

## Headers

- `X-GatePay-On-Behalf-Of` string, required
- `X-GatePay-Merchant-Id` string, required
- `X-GatePay-Certificate-ClientId` string, required

## Request body

- object
  - `expireSeconds` integer, required — 认证URL过期时间（秒）
  - `requestId` string — 请求 ID，用于追踪请求来源（可选参数）

## Response `200`

成功响应

- object
  - `code` string
  - `message` string
  - `data` object
    - `authUrl` string — 认证 URL
    - `subAccountId` integer — 子账户 ID
    - `expireTime` integer — 认证URL过期时间戳(毫秒)
    - `requestId` string — 请求 ID

---

[API](https://skmtc.dev/gate/apis/gatepay-institutional-api.md) · [All operations](https://skmtc.dev/gate/apis/gatepay-institutional-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gate/gatepay-institutional-api/revisions/62d31c7e909a/schema)