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

# 获取认证 URL

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

## Request

- Base URL: `https://openplatform.gateapi.io`
- URL: `https://openplatform.gateapi.io/cashier/open/v1/certification/url`
- Auth: none declared. Required headers: `X-GatePay-On-Behalf-Of`, `X-GatePay-Merchant-Id`, `X-GatePay-Certificate-ClientId`

## 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

## Changes

- **2026-10-12** `4627cdb35251`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gate/apis/gatepay-institutional-api/changes/cashier/open/v1/certification/url/post.md)

---

[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.dev/gate/apis/gatepay-institutional-api/revisions/4627cdb35251?raw)