---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/checkout/api/getAccessToken/index.md
description: >-
  获取 sdkAccessToken 用于在 checkout
  过程中验证商户身份。适用于需要集成支付功能的线上商店或应用，支持全球范围内的支付处理。主要功能包括生成临时访问令牌，关键参数有merchantId、apiKey等，确保安全可靠的支付体验。
---
# 获取 sdkAccessToken

```apidef
endpoint: POST /v4/session/init
name: 获取 sdkAccessToken
summary: 初始化 SDK Access Token
tags: OnePage, Payment, Session
```

获取 sdkAccessToken 用于在 checkout 过程中验证商户身份。适用于需要集成支付功能的线上商店或应用，支持全球范围内的支付处理。主要功能包括生成临时访问令牌，关键参数有merchantId、apiKey等，确保安全可靠的支付体验。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | 店铺唯一标识 |
| clientId | string | M | PingPong 商户号 |
| signType | string | M | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | M | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| version | string | M | 版本号，当前固定为1.0，后续随接口变动可能有调整 |
| bizContent | string | M | 请求参数的集合，最大长度不限，除公共请求参数外所有请求参数都必须放在这个参数中传递，格式：JSON字符串。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ merchantUserId | string | C | 会员ID，用户在商户网站的会员ID |

### 请求示例

```json
{
  "accId": "2022102018024210348883",
  "bizContent": "{\"merchantUserId\":\"1260489643332523151\"}",
  "clientId": "2022102018024210348",
  "sign": "FE7BBF558C09740CC2B73F9DC8CF7701FEE9955D1FCB343BC36C921D9DA45138",
  "signType": "SHA256",
  "version": "1.0"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| accId | string | 店铺唯一标识 |
| clientId | string | PingPong 商户号 |
| signType | string | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| code | string | 结果状态码，见附录状态码表: /notes/zh/appendix/successCodeList/ |
| description | string | 结果描述 |
| bizContent | string | 业务响应参数。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ sdkAccessToken | string | sdkAccessToken |

### 响应示例

```json
{
  "accId": "2023042011040310224447",
  "bizContent": "{\"sdkAccessToken\":\"DDf2S7RR3K4LQ1715047351210\"}",
  "clientId": "2023042011040310224",
  "code": "000000",
  "description": "succeeded",
  "sign": "5033C47D3A1CF3E19A4B0EE0E566CE723D67E8BA236B828829BDE586CA999D2A",
  "signType": "SHA256"
}
```