# @gr4vy/sdk 中文文档

规范地址：https://npmcn.com/package/%40gr4vy/sdk/

版本：2\.4\.47
npm 元数据更新时间：2026-11-11T12:22:01.439Z
中文译文更新时间：2026-11-16T21:25:43.773Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gr4vy/sdk
原文对照：https://npmcn.com/package/%40gr4vy/sdk/?lang=original
项目主页：https://github.com/gr4vy/gr4vy-typescript#readme
源码仓库：https://github.com/gr4vy/gr4vy-typescript

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：7.6 MB，3521 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2025-04-23T13:52:18.357Z
- 最新版本发布：2026-11-11T12:22:00.801Z
- 近 30 天下载量：52198（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：317（近 12 个月 189 个）

## 中文简介

开发者方便且类型安全 类型SDK **格鲁维** API (英语).

## 安装

```sh
npm install @gr4vy/sdk
```

也可以使用：`pnpm add @gr4vy/sdk`、`yarn add @gr4vy/sdk`、`bun add @gr4vy/sdk`

## README

# Gr4vy 类型脚本 SDK

开发者方便且类型安全 类型SDK **格鲁维** API (英语).

[![NPM Version](https://img.shields.io/npm/v/%40gr4vy%2Fsdk?style=for-the-badge)](https://www.npmjs.com/package/@gr4vy/sdk) [![](https://custom-icon-badges.demolab.com/badge/-Built%20By%20Speakeasy-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454)](https://speakeasyapi.dev/)

## 内容提要

TypeScript 的官方 Gr4vy SDK 提供了从您的服务器端应用程序中与 Gr4vy API 交互的方便方式. 这个SDK可以使您无缝地整合了Gr4vy强大的支付管弦能力,包括:

-   创建交易:以各种支付方法和服务启动和处理支付.
-   管理买方:安全地储存和管理买方信息.
-   储存支付方法:安全地储存并象征性地说明今后使用的支付方法.
-   处理Webhooks:轻松处理并回应Gr4vy的Webhook事件.
-   更多:访问Gr4vy API支付功能的完整套件.

这个SDK是为了简化开发,减少锅炉板代码,帮助您快速高效地与Gr4vy一起起起跑. 它处理认证,请求签名,并为大多数API端点提供易用的方法.

## 目录

-   [Gr4vy 类型脚本 SDK](https://npmcn.com/package/%40gr4vy/sdk/#readme-gr4vy-typescript-sdk)
    -   [SDK 安装](https://npmcn.com/package/%40gr4vy/sdk/#readme-sdk-installation)
    -   [所需资源](https://npmcn.com/package/%40gr4vy/sdk/#readme-requirements)
    -   [SDK 示例使用法](https://npmcn.com/package/%40gr4vy/sdk/#readme-sdk-example-usage)
    -   [持有者代号生成](https://npmcn.com/package/%40gr4vy/sdk/#readme-bearer-token-generation)
    -   [嵌入式符号生成](https://npmcn.com/package/%40gr4vy/sdk/#readme-embed-token-generation)
    -   [商务账户 ID 选择](https://npmcn.com/package/%40gr4vy/sdk/#readme-merchant-account-id-selection)
    -   [Webhooks 验证](https://npmcn.com/package/%40gr4vy/sdk/#readme-webhooks-verification)
    -   [现有资源和业务](https://npmcn.com/package/%40gr4vy/sdk/#readme-available-resources-and-operations)
    -   [处理错误](https://npmcn.com/package/%40gr4vy/sdk/#readme-error-handling)
    -   [服务器选择](https://npmcn.com/package/%40gr4vy/sdk/#readme-server-selection)
    -   [自定义 HTTP 客户端](https://npmcn.com/package/%40gr4vy/sdk/#readme-custom-http-client)
    -   [认证](https://npmcn.com/package/%40gr4vy/sdk/#readme-authentication)
    -   [SDK 安装](https://npmcn.com/package/%40gr4vy/sdk/#readme-sdk-installation-1)
    -   [SDK 示例使用法](https://npmcn.com/package/%40gr4vy/sdk/#readme-sdk-example-usage-1)
    -   [倾斜](https://npmcn.com/package/%40gr4vy/sdk/#readme-pagination)
    -   [检索](https://npmcn.com/package/%40gr4vy/sdk/#readme-retries)
    -   [独立职能](https://npmcn.com/package/%40gr4vy/sdk/#readme-standalone-functions)
    -   [调试](https://npmcn.com/package/%40gr4vy/sdk/#readme-debugging)
-   [发展](https://npmcn.com/package/%40gr4vy/sdk/#readme-development)
    -   [测试](https://npmcn.com/package/%40gr4vy/sdk/#readme-testing)
    -   [捐款](https://npmcn.com/package/%40gr4vy/sdk/#readme-contributions)

## SDK 安装

SDK可以安装其中之一 [无](https://www.npmjs.com/), (中文(简体) ), [小时](https://pnpm.io/), (中文(简体) ), [包头](https://bun.sh/) 或者说 [线条](https://classic.yarnpkg.com/en/) 软件包管理器.

### 国家预防机制

```bash
npm add @gr4vy/sdk
```

### 菲律宾

```bash
pnpm add @gr4vy/sdk
```

### 阿宝

```bash
bun add @gr4vy/sdk
```

### 雅伦

```bash
yarn add @gr4vy/sdk
```

## 所需资源

对于支持的 JavaScript 运行时间, 请参考 [运行时间.md](https://npmcn.com/package/%40gr4vy/sdk/RUNTIMES.md)。 。 。 .

## SDK 示例使用法

### 示例

```typescript
import fs from "fs";
import { Gr4vy, withToken } from "@gr4vy/sdk";

async function run() {
    const gr4vy = new Gr4vy({
        server: "sandbox",
        id: "example",
        bearerAuth: withToken({
          privateKey: fs.readFileSync("private_key.pem", "utf8"),
        }),
    });

    const result = await gr4vy.transactions.list({});

    // Handle the result
    console.log(result);
}

run();

```

## 持有者代号生成

或者,您可以用 SDK 或自己的客户端库创建一个符号.

```js
import { getToken } from "@gr4vy/sdk";

async function run() {
    const token = await getToken({
          privateKey: fs.readFileSync("private_key.pem", "utf8"),
    });
    console.log(token);
}

run();
```

> **说明:** 这只会创造一个符号一次。 使用 `withToken` 以动态生成一个符号 每个请求.

## 嵌入式符号生成

或者,您可以创建一个用于嵌入的符号如下 .

```js
import { Gr4vy, getEmbedToken } from "@gr4vy/sdk";

async function run() {
    const privateKey = fs.readFileSync("private_key.pem", "utf8")

    const gr4vy = new Gr4vy({
        server: "sandbox",
        id: "example",
        bearerAuth: withToken({ privateKey }),
    });

    const checkoutSession = await gr4vy.checkoutSessions.create()

    const token = await getEmbedToken({ 
      privateKey,
      checkoutSessionId: checkoutSession.id,
      embedParams: {
        amount: 1299,
        currency: 'USD',
        buyerExternalIdentifier: 'user-1234',
      }
    });

    console.log(token);
}

run();
```

> **说明:** 这只会创造一个符号一次。 使用 `withToken` 以动态生成一个符号 每个请求.

### 自动附加一个退出会话

对于 Embed ,建议在每次交易中都附加一个检出会话. 这个 `getEmbedTokenWithCheckoutSession` 帮助者使用您的 SDK 客户端创建退出会话 返回带有结果的嵌入符 `checkout_session_id` 已经钉住,在一个呼叫.

```js
import fs from "node:fs";
import { Gr4vy, getEmbedTokenWithCheckoutSession, withToken } from "@gr4vy/sdk";

async function run() {
    const privateKey = fs.readFileSync("private_key.pem", "utf8")

    const gr4vy = new Gr4vy({
        server: "sandbox",
        id: "example",
        bearerAuth: withToken({ privateKey }),
    });

    const token = await getEmbedTokenWithCheckoutSession({
      client: gr4vy,
      privateKey,
      embedParams: {
        amount: 1299,
        currency: 'USD',
        buyerExternalIdentifier: 'user-1234',
      }
    });

    console.log(token);
}

run();
```

你可以选择通过一个 `checkoutSession` 种子会话的正体(例如用推车项) 或元数据)和a `merchantAccountId` 以覆盖客户端配置的商号.

## 商务账户 ID 选择

根据使用的密钥,您可能需要明确定义要使用的商号账户ID. 在我们的API, 此使用 `X-GR4VY-MERCHANT-ACCOUNT-ID` 头曰. 使用SDK时,可以设置 `merchantAccountId` 每一个请求.

```js
const result = await gr4vy.transactions.list({
    merchantAccountId: 'merchant-12345'
})
```

或者,在初始化SDK时也可以设置商号账户ID.

```js
const gr4vy = new Gr4vy({
    server: "sandbox",
    id: "example",
    merchantAccountId: 'merchant-12345',
    bearerAuth: withToken({ privateKey }),
});
```

## Webhooks 验证

SDK提供了一个 `verifyWebhook` 用于验证Gr4vy收到的webhook请求的方法。 这确保了网钩有效载荷是真实的,没有被篡改.

```js
import { verifyWebhook } from "@gr4vy/sdk";

const payload = 'your-webhook-payload'
const secret = 'your-webhook-secret'
const signatureHeader = 'signatures-from-header'
const timestampHeader = 'timestamp-from-header'
const timestampTolerance = 300 // optional, in seconds (default: 0)

try {
  verifyWebhook(
    payload,
    secret,
    signatureHeader,
    timestampHeader,
    timestampTolerance
  )
  console.log('Webhook verified successfully!')
} catch (error) {
  console.error('Webhook verification failed:', error.message)
}
```

### 参数

-   **`payload`**:在webhook请求中收到的原始有效载荷字符串.
-   **`secret`**:用来签下"网钩"的秘密. 这在你的Gr4vy仪表板上提供.
-   **`signatureHeader`**编号: `X-Gr4vy-Signature` 由 webhook 请求发出的头条 .
-   **`timestampHeader`**编号: `X-Gr4vy-Timestamp` 由 webhook 请求发出的头条 .
-   **`timestampTolerance`**数字 : _(备选)_ 允许的最大值( 以秒计) 在webhook中当前时间和时间戳之间的相差 。 默认为 `0` (没有宽容).

## 现有资源和业务

可用方法

### [会计更新者。 工作](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/jobs/README.md)

-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/jobs/README.md#create) - 创建账户更新工作

### [ApiKey 平板电脑](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/apikeypairs/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/apikeypairs/README.md#list) - 列出所有 API 密钥对
-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/apikeypairs/README.md#create) - 创建 API 密钥对
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/apikeypairs/README.md#get) - 拿一对API钥匙
-   [更新](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/apikeypairs/README.md#update) - 更新 API 密钥对
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/apikeypairs/README.md#delete) - 删除 API 密钥对

### [审计日志](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/auditlogs/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/auditlogs/README.md#list) - 清单审计记录条目

### [买家](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/buyers/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/buyers/README.md#list) - 列出所有买家
-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/buyers/README.md#create) - 增加买主
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/buyers/README.md#get) - 找买家
-   [更新](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/buyers/README.md#update) - 更新买方
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/buyers/README.md#delete) - 删除买方

#### [买取者. 礼品卡](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vygiftcards/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vygiftcards/README.md#list) - 列出买家的礼品卡

#### [买取者. 支付方法](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vypaymentmethods/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vypaymentmethods/README.md#list) - 列出买方付款方法

#### [买取者. 航运 细节](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/shippingdetails/README.md)

-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/shippingdetails/README.md#create) - 增加买方运输详情
-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/shippingdetails/README.md#list) - 列出买方的货运详情
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/shippingdetails/README.md#get) - 获得买方的运输细节
-   [更新](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/shippingdetails/README.md#update) - 更新买方的运输细节
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/shippingdetails/README.md#delete) - 删除买方的货运细节

### [卡片计划定义](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/cardschemedefinitions/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/cardschemedefinitions/README.md#list) - 列表卡方案定义

### [离职会议](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/checkoutsessions/README.md)

-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/checkoutsessions/README.md#create) - 创建退出会话
-   [更新](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/checkoutsessions/README.md#update) - 更新退出会话
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/checkoutsessions/README.md#get) - 获取退出会话
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/checkoutsessions/README.md#delete) - 删除退出会话

### [数字钱包](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/digitalwallets/README.md)

-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/digitalwallets/README.md#create) - 登记数字钱包
-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/digitalwallets/README.md#list) - 列出数字钱包
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/digitalwallets/README.md#get) - 拿数字钱包
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/digitalwallets/README.md#delete) - 删除数字钱包
-   [更新](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/digitalwallets/README.md#update) - 更新数字钱包

#### [数字钱包. 域数](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/domains/README.md)

-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/domains/README.md#create) - 注册数字钱包域名
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/domains/README.md#delete) - 删除数字钱包域

#### [数字钱包. 会议](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md)

-   [谷歌游戏](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#googlepay) - 创建谷歌付费会话
-   [苹果纸](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#applepay) - 创建苹果支付会话
-   [pazeMobile 会议创造](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#pazemobilesessioncreate) - 创建帕泽移动会话
-   [酱油](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#paze) - 创建帕泽会话
-   [纸币会议审查](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#pazemobilesessionreview) - 审查帕泽会议
-   [paze Mobile 会议完成](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#pazemobilesessioncomplete) - 完成帕泽会议
-   [点击ToPay](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#clicktopay) - 创建点击支付会话

### [礼品卡](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/giftcards/README.md)

-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/giftcards/README.md#get) - 拿礼物卡
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/giftcards/README.md#delete) - 删除礼品卡
-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/giftcards/README.md#create) - 创建礼品卡
-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/giftcards/README.md#list) - 名单礼品卡

#### [礼物卡 活动](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/activations/README.md)

-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/activations/README.md#create) - 激活礼品卡

#### [礼物卡 余额](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/balances/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/balances/README.md#list) - 礼品卡余额清单

#### [礼物卡 发放](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/issuances/README.md)

-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/issuances/README.md#create) - 发礼物卡

### [商业账户](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/merchantaccounts/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/merchantaccounts/README.md#list) - 列出所有商业账户
-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/merchantaccounts/README.md#create) - 创建一个商号
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/merchantaccounts/README.md#get) - 买个商户
-   [更新](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/merchantaccounts/README.md#update) - 更新一个商号

#### [商业账户。 三维配置](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsconfiguration/README.md)

-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsconfiguration/README.md#create) - 为商家创建 3DS 配置
-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsconfiguration/README.md#list) - 列出商家的3DS配置
-   [更新](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsconfiguration/README.md#update) - 编辑 3DS 配置
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsconfiguration/README.md#delete) - 删除商家的3DS配置

### [付款链接](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentlinks/README.md)

-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentlinks/README.md#create) - 添加支付链接
-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentlinks/README.md#list) - 列出所有支付链接
-   [过期](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentlinks/README.md#expire) - 付款链接过期
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentlinks/README.md#get) - 获取支付链接

### [支付方法](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentmethods/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentmethods/README.md#list) - 列出所有付款方法
-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentmethods/README.md#create) - 创建支付方法
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentmethods/README.md#get) - 获得支付方法
-   [更新](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentmethods/README.md#update) - 更新支付方法
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentmethods/README.md#delete) - 删除支付方法

#### [支付方法。 网络插件](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/networktokens/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/networktokens/README.md#list) - 列出网络符号
-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/networktokens/README.md#create) - 提供网络信号
-   [暂停](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/networktokens/README.md#suspend) - 暂停网络信号
-   [恢复](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/networktokens/README.md#resume) - 恢复网络信号
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/networktokens/README.md#delete) - 删除网络标志

##### [支付方法。 腾讯网. 密码](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/cryptogram/README.md)

-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/cryptogram/README.md#create) - 提供网络代号密码图

#### [支付方法。 付费服务套件](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicetokens/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicetokens/README.md#list) - 列出付款服务标志
-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicetokens/README.md#create) - 创建支付服务标志
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicetokens/README.md#delete) - 删除付款服务代号

### [备选付款办法](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentoptions/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentoptions/README.md#list) - 列出付款选项

### [支付服务定义](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicedefinitions/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicedefinitions/README.md#list) - 列出付款服务定义
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicedefinitions/README.md#get) - 获得支付服务的定义
-   [第二届会议](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicedefinitions/README.md#session) - 为支付服务定义创建一个会话

### [支付服务](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#list) - 清单支付服务
-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#create) - 配置付款服务
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#get) - 获得支付服务
-   [更新](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#update) - 更新已配置的付款服务
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#delete) - 删除配置的付款服务
-   [校验](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#verify) - 核查付款服务证书
-   [第二届会议](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#session) - 为支付服务定义创建一个会话

### [付款](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/payouts/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/payouts/README.md#list) - 创建清单付款
-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/payouts/README.md#create) - 创造报酬
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/payouts/README.md#get) - 拿到钱

### [退款](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/refunds/README.md)

-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/refunds/README.md#get) - 退钱

### [报告执行](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/reportexecutions/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/reportexecutions/README.md#list) - 列出已执行报告

### [报告](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/reports/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/reports/README.md#list) - 列出已配置的报告
-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/reports/README.md#create) - 增加一个报告
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/reports/README.md#get) - 拿个报告
-   [设置](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/reports/README.md#put) - 更新报告

#### [报告。 处决](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/executions/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/executions/README.md#list) - 开列处决报告
-   [url 密码](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/executions/README.md#url) - 为已执行的报告创建 URL
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/executions/README.md#get) - 得到执行报告

### [作用](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/roles/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/roles/README.md#list) - 列出所有角色

### [三维情景](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsscenarios/README.md)

-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsscenarios/README.md#create) - 创建3DS方案
-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsscenarios/README.md#list) - 列出3DS方案
-   [更新](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsscenarios/README.md#update) - 更新3DS方案
-   [删除](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsscenarios/README.md#delete) - 删除3DS方案

### [交易](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#list) - 清单交易
-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#create) - 创建交易
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#get) - 获取交易
-   [更新](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#update) - 手工更新交易
-   [捕获](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#capture) - 扣押交易
-   [无效](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#void) - 虚拟交易
-   [取消( e)](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#cancel) - 取消交易
-   [同步](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#sync) - 同步交易
-   [增量认证](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#incrementauthorization) - 增加交易授权

#### [交易 行动](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/actions/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/actions/README.md#list) - 交易流程规则

#### [交易 捕获](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/captures/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/captures/README.md#list) - 清单交易抓取
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/captures/README.md#get) - 获取交易记录

#### [交易 活动](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/events/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/events/README.md#list) - 列出交易事项

#### [交易 退款](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/refundsettlements/README.md)

-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/refundsettlements/README.md#get) - 获得交易退款结算
-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/refundsettlements/README.md#list) - 清单交易退款结算

#### [交易 退款](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vyrefunds/README.md)

-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vyrefunds/README.md#list) - 清单交易退款
-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vyrefunds/README.md#create) - 创建交易退款
-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vyrefunds/README.md#get) - 得到交易退款

##### [交易 退还. 全体](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/all/README.md)

-   [创建](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/all/README.md#create) - 创建批次交易退款

#### [交易 定居点](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/settlements/README.md)

-   [起来](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/settlements/README.md#get) - 获得交易结算
-   [列表](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/settlements/README.md#list) - 清单交易结算

## 处理错误

[`Gr4vyError`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/gr4vyerror.ts) 是所有 HTTP 错误响应的基础类。 其属性如下:

| 财产 | 类型 | 说明 |
| --- | --- | --- |
| `error.message` | `string` | 错误消息 |
| `error.statusCode` | `number` | HTTP 响应状态代码 eg `404` |
| `error.headers` | `Headers` | HTTP 响应头 |
| `error.body` | `string` | HTTP 躯体. 如果没有尸体返回, 则可以是空字符串 . |
| `error.rawResponse` | `Response` | 原始 HTTP 响应 |
| `error.data$` |  | 可选的 一些错误可能包含结构化数据. [参见错误类](https://npmcn.com/package/%40gr4vy/sdk/#readme-error-classes)。 。 。 . |

### 示例

```typescript
import { Gr4vy, withToken } from "@gr4vy/sdk";
import * as errors from "@gr4vy/sdk/models/errors";
import fs from "fs";

const gr4vy = new Gr4vy({
  id: "example",
  server: "sandbox",
  merchantAccountId: "default",
  bearerAuth: withToken({
    privateKey: fs.readFileSync("private_key.pem", "utf8"),
  }),
});

async function run() {
  try {
    const result = await gr4vy.accountUpdater.jobs.create({
      paymentMethodIds: [
        "ef9496d8-53a5-4aad-8ca2-00eb68334389",
        "f29e886e-93cc-4714-b4a3-12b7a718e595",
      ],
    });

    console.log(result);
  } catch (error) {
    // The base class for HTTP error responses
    if (error instanceof errors.Gr4vyError) {
      console.log(error.message);
      console.log(error.statusCode);
      console.log(error.body);
      console.log(error.headers);

      // Depending on the method different errors may be thrown
      if (error instanceof errors.Error400) {
        console.log(error.data$.type); // string
        console.log(error.data$.code); // string
        console.log(error.data$.status); // number
        console.log(error.data$.message); // string
        console.log(error.data$.details); // ErrorDetail[]
      }
    }
  }
}

run();

```

### 错误分类

**主错误 :**

-   [`Gr4vyError`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/gr4vyerror.ts): HTTP 错误响应的基础类.
    -   [`Error400`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/error400.ts): 请求无效. 状态代码 `400`。 。 。 .
    -   [`Error401`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/error401.ts): 请求未经批准. 状态代码 `401`。 。 。 .
    -   [`Error403`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/error403.ts): 证书无效或呼叫者没有权限对资源采取行动. 状态代码 `403`。 。 。 .
    -   [`Error404`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/error404.ts): 未找到资源 。 状态代码 `404`。 。 。 .
    -   [`Error405`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/error405.ts): 不允许请求方法. 状态代码 `405`。 。 。 .
    -   [`Error409`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/error409.ts): 找到重复的记录。 状态代码 `409`。 。 。 .
    -   [`Error425`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/error425.ts):请求太早. 状态代码 `425`。 。 。 .
    -   [`Error429`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/error429.ts): 提出了太多的请求。 状态代码 `429`。 。 。 .
    -   [`Error500`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/error500.ts): 服务器遇到错误 。 状态代码 `500`。 。 。 .
    -   [`Error502`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/error502.ts): 服务器遇到错误 。 状态代码 `502`。 。 。 .
    -   [`Error504`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/error504.ts): 服务器遇到错误 。 状态代码 `504`。 。 。 .
    -   [`HTTPValidationError`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/httpvalidationerror.ts): 校验出错. 状态代码 `422`。 。 。 \*

少常见错误(6)  

**网络错误 :**

-   [`ConnectionError`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/httpclienterrors.ts): HTTP 客户端无法向服务器提出请求.
-   [`RequestTimeoutError`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/httpclienterrors.ts): HTTP 请求由于中止信号而超时.
-   [`RequestAbortedError`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/httpclienterrors.ts):HTTP请求被客户端中止.
-   [`InvalidRequestError`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/httpclienterrors.ts): 用于创建请求的任何输入无效.
-   [`UnexpectedClientError`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/httpclienterrors.ts):无法识别或出乎意料的错误.

**继承从 [`Gr4vyError`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/gr4vyerror.ts)**数字 :

-   [`ResponseValidationError`](https://npmcn.com/package/%40gr4vy/sdk/src/models/errors/responsevalidationerror.ts):从服务器返回的数据和SDK期望的结构之间的类型不匹配. 见 `error.rawValue` 原值和 `error.pretty()` 用于格式化良好的多行字符串.

\* 检查 [方法文档](https://npmcn.com/package/%40gr4vy/sdk/#readme-available-resources-and-operations) 以查看该错误是否适用.

## 服务器选择

### 按名称选择服务器

您可以通过将服务器名称传递到 `server: keyof typeof ServerList` 初始化 SDK 客户端实例时的可选参数 。 然后,选定服务器将作为使用它的操作的默认值. 本表列出与可用服务器相关的名称:

| 名称 | 服务器 | 变量 | 说明 |
| --- | --- | --- | --- |
| `sandbox` | `https://api.sandbox.{id}.gr4vy.app` | `id` |  |
| `production` | `https://api.{id}.gr4vy.app` | `id` |  |

如果选中的服务器有变量, 您可以通过 SDK 构建器中提供的额外参数来覆盖其默认值 :

| 变量 | 参数 | 默认 | 说明 |
| --- | --- | --- | --- |
| `id` | `id: string` | `"example"` | 您的 Gr4vy 实例的子域 . |

#### 示例

```typescript
import { Gr4vy, withToken } from "@gr4vy/sdk";
import fs from "fs";

const gr4vy = new Gr4vy({
  id: "example",
  server: "sandbox",
  merchantAccountId: "default",
  bearerAuth: withToken({
    privateKey: fs.readFileSync("private_key.pem", "utf8"),
  }),
});

async function run() {
  const result = await gr4vy.accountUpdater.jobs.create({
    paymentMethodIds: [
      "ef9496d8-53a5-4aad-8ca2-00eb68334389",
      "f29e886e-93cc-4714-b4a3-12b7a718e595",
    ],
  });

  console.log(result);
}

run();

```

### 覆盖服务器 URL / 客户端

默认服务器也可以通过将 URL 传递到 `serverURL: string` 初始化 SDK 客户端实例时的可选参数 。 例如:

```typescript
import { Gr4vy, withToken } from "@gr4vy/sdk";
import fs from "fs";

const gr4vy = new Gr4vy({
  id: "example",
  server: "sandbox",
  merchantAccountId: "default",
  bearerAuth: withToken({
    privateKey: fs.readFileSync("private_key.pem", "utf8"),
  }),
});

async function run() {
  const result = await gr4vy.accountUpdater.jobs.create({
    paymentMethodIds: [
      "ef9496d8-53a5-4aad-8ca2-00eb68334389",
      "f29e886e-93cc-4714-b4a3-12b7a718e595",
    ],
  });

  console.log(result);
}

run();

```

## 自定义 HTTP 客户端

TypeScript SDK 使用一个 `HTTPClient` 将本地人包裹起来 [获取 API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API)这个 客户端是薄薄的包装 `fetch` 并且提供连接钩子的能力 围绕可用于修改请求或处理的请求生命周期 错误和反应.

这个 `HTTPClient` 构造器使用可选 `fetcher` 参数可以是 用于整合第三方 HTTP 客户端或用于编写测试以嘲弄 hTTP 客户端并输入固定设备.

以下例子说明如何:

-   通过使用 [未编辑](https://www.npmjs.com/package/undici)代理代理代理服务器
-   使用该 `"beforeRequest"` 向请求添加自定义头和超时
-   使用该 `"requestError"` 记录错误的钩头

```typescript
import { Gr4vy } from "@gr4vy/sdk";
import { ProxyAgent } from "undici";
import { HTTPClient } from "@gr4vy/sdk/lib/http";

const dispatcher = new ProxyAgent("http://proxy.example.com:8080");

const httpClient = new HTTPClient({
  // 'fetcher' takes a function that has the same signature as native 'fetch'.
  fetcher: (input, init) =>
    // 'dispatcher' is specific to undici and not part of the standard Fetch API.
    fetch(input, { ...init, dispatcher } as RequestInit),
});

httpClient.addHook("beforeRequest", (request) => {
  const nextRequest = new Request(request, {
    signal: request.signal || AbortSignal.timeout(5000)
  });

  nextRequest.headers.set("x-custom-header", "custom value");

  return nextRequest;
});

httpClient.addHook("requestError", (error, request) => {
  console.group("Request Error");
  console.log("Reason:", `${error}`);
  console.log("Endpoint:", `${request.method} ${request.url}`);
  console.groupEnd();
});

const sdk = new Gr4vy({ httpClient: httpClient });
```

## 认证

### 常客安全计划

这个SDK在全球支持以下安全计划:

| 名称 | 类型 | 计划 | 环境变量 |
| --- | --- | --- | --- |
| `bearerAuth` | 网页 | HTTP 缓冲器 | `GR4VY_BEARER_AUTH` |

用 API 认证 `bearerAuth` 初始化 SDK 客户端实例时必须设置参数 。 例如:

```typescript
import { Gr4vy, withToken } from "@gr4vy/sdk";
import fs from "fs";

const gr4vy = new Gr4vy({
  id: "example",
  server: "sandbox",
  merchantAccountId: "default",
  bearerAuth: withToken({
    privateKey: fs.readFileSync("private_key.pem", "utf8"),
  }),
});

async function run() {
  const result = await gr4vy.accountUpdater.jobs.create({
    paymentMethodIds: [
      "ef9496d8-53a5-4aad-8ca2-00eb68334389",
      "f29e886e-93cc-4714-b4a3-12b7a718e595",
    ],
  });

  console.log(result);
}

run();

```

## SDK 安装

SDK可以安装其中之一 [无](https://www.npmjs.com/), (中文(简体) ), [小时](https://pnpm.io/), (中文(简体) ), [包头](https://bun.sh/) 或者说 [线条](https://classic.yarnpkg.com/en/) 软件包管理器.

### 国家预防机制

```bash
npm add @gr4vy/sdk
```

### 菲律宾

```bash
pnpm add @gr4vy/sdk
```

### 阿宝

```bash
bun add @gr4vy/sdk
```

### 雅伦

```bash
yarn add @gr4vy/sdk
```

## SDK 示例使用法

### 示例

```typescript
import { Gr4vy, withToken } from "@gr4vy/sdk";
import fs from "fs";

const gr4vy = new Gr4vy({
  id: "example",
  server: "sandbox",
  merchantAccountId: "default",
  bearerAuth: withToken({
    privateKey: fs.readFileSync("private_key.pem", "utf8"),
  }),
});

async function run() {
  const result = await gr4vy.accountUpdater.jobs.create({
    paymentMethodIds: [
      "ef9496d8-53a5-4aad-8ca2-00eb68334389",
      "f29e886e-93cc-4714-b4a3-12b7a718e595",
    ],
  });

  console.log(result);
}

run();

```

## 倾斜

此 SDK 中的一些端点支持 pagination. 要用帕吉恩语,你 使您的 SDK 调用如常, 但返回的响应对象也将是 可使用下列设备消耗的同步可执行性: [`for await...of`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for-await...of) 语法.

举个例子说

```typescript
import { Gr4vy, withToken } from "@gr4vy/sdk";
import fs from "fs";

const gr4vy = new Gr4vy({
  id: "example",
  server: "sandbox",
  merchantAccountId: "default",
  bearerAuth: withToken({
    privateKey: fs.readFileSync("private_key.pem", "utf8"),
  }),
});

async function run() {
  const result = await gr4vy.apiKeyPairs.list();

  for await (const page of result) {
    console.log(page);
  }
}

run();

```

## 检索

此 SDK 中的一些端点支持重试. 如果在没有任何配置的情况下使用SDK,则会回落到API提供的默认重试策略. 然而,默认的重试策略可以在一次操作的基础上被推翻,或者在整个SDK中被推翻.

更改单个 API 调用默认重试策略, 只需为调用提供重试 Config 对象 :

```typescript
import { Gr4vy, withToken } from "@gr4vy/sdk";
import fs from "fs";

const gr4vy = new Gr4vy({
  id: "example",
  server: "sandbox",
  merchantAccountId: "default",
  bearerAuth: withToken({
    privateKey: fs.readFileSync("private_key.pem", "utf8"),
  }),
});

async function run() {
  const result = await gr4vy.accountUpdater.jobs.create(
    {
      paymentMethodIds: [
        "ef9496d8-53a5-4aad-8ca2-00eb68334389",
        "f29e886e-93cc-4714-b4a3-12b7a718e595",
      ],
    },
    undefined,
    {
      retries: {
        strategy: "backoff",
        backoff: {
          initialInterval: 1,
          maxInterval: 50,
          exponent: 1.1,
          maxElapsedTime: 100,
        },
        retryConnectionErrors: false,
      },
    },
  );

  console.log(result);
}

run();

```

如果您想要覆盖所有支持重试的操作的默认重试策略, 您可以在 SDK 初始化时提供重试Config :

```typescript
import { Gr4vy, withToken } from "@gr4vy/sdk";
import fs from "fs";

const gr4vy = new Gr4vy({
  id: "example",
  server: "sandbox",
  merchantAccountId: "default",
  bearerAuth: withToken({
    privateKey: fs.readFileSync("private_key.pem", "utf8"),
  }),
});

async function run() {
  const result = await gr4vy.accountUpdater.jobs.create({
    paymentMethodIds: [
      "ef9496d8-53a5-4aad-8ca2-00eb68334389",
      "f29e886e-93cc-4714-b4a3-12b7a718e595",
    ],
  });

  console.log(result);
}

run();

```

## 内容提要

Gr4vy:Gr4vy API. (中文(简体) ).

## 目录

-   [Gr4vy 类型脚本 SDK](https://npmcn.com/package/%40gr4vy/sdk/#readme-gr4vy-typescript-sdk)
    -   [SDK 安装](https://npmcn.com/package/%40gr4vy/sdk/#readme-sdk-installation)
    -   [所需资源](https://npmcn.com/package/%40gr4vy/sdk/#readme-requirements)
    -   [SDK 示例使用法](https://npmcn.com/package/%40gr4vy/sdk/#readme-sdk-example-usage)
    -   [持有者代号生成](https://npmcn.com/package/%40gr4vy/sdk/#readme-bearer-token-generation)
    -   [嵌入式符号生成](https://npmcn.com/package/%40gr4vy/sdk/#readme-embed-token-generation)
    -   [商务账户 ID 选择](https://npmcn.com/package/%40gr4vy/sdk/#readme-merchant-account-id-selection)
    -   [Webhooks 验证](https://npmcn.com/package/%40gr4vy/sdk/#readme-webhooks-verification)
    -   [现有资源和业务](https://npmcn.com/package/%40gr4vy/sdk/#readme-available-resources-and-operations)
    -   [处理错误](https://npmcn.com/package/%40gr4vy/sdk/#readme-error-handling)
    -   [服务器选择](https://npmcn.com/package/%40gr4vy/sdk/#readme-server-selection)
    -   [自定义 HTTP 客户端](https://npmcn.com/package/%40gr4vy/sdk/#readme-custom-http-client)
    -   [认证](https://npmcn.com/package/%40gr4vy/sdk/#readme-authentication)
    -   [SDK 安装](https://npmcn.com/package/%40gr4vy/sdk/#readme-sdk-installation-1)
    -   [SDK 示例使用法](https://npmcn.com/package/%40gr4vy/sdk/#readme-sdk-example-usage-1)
    -   [倾斜](https://npmcn.com/package/%40gr4vy/sdk/#readme-pagination)
    -   [检索](https://npmcn.com/package/%40gr4vy/sdk/#readme-retries)
    -   [独立职能](https://npmcn.com/package/%40gr4vy/sdk/#readme-standalone-functions)
    -   [调试](https://npmcn.com/package/%40gr4vy/sdk/#readme-debugging)
-   [发展](https://npmcn.com/package/%40gr4vy/sdk/#readme-development)
    -   [测试](https://npmcn.com/package/%40gr4vy/sdk/#readme-testing)
    -   [捐款](https://npmcn.com/package/%40gr4vy/sdk/#readme-contributions)

## 独立职能

上述所有方法都作为独立功能提供。 这些 函数是用于在浏览器中运行的应用程序的理想功能,没有服务器 运行时间或应用程序捆绑大小为主的其他环境 关心。 当使用捆绑器构建您的应用程序时, 全部未使用 功能将被从最后的捆绑中排除,或者被树切除.

要了解更多独立函数, 请检查 [职能.md](https://npmcn.com/package/%40gr4vy/sdk/FUNCTIONS.md)。 。 。 .

现有的独立职能

-   [`accountUpdaterJobsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/jobs/README.md#create) - 创建账户更新工作
-   [`apiKeyPairsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/apikeypairs/README.md#create) - 创建 API 密钥对
-   [`apiKeyPairsDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/apikeypairs/README.md#delete) - 删除 API 密钥对
-   [`apiKeyPairsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/apikeypairs/README.md#get) - 拿一对API钥匙
-   [`apiKeyPairsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/apikeypairs/README.md#list) - 列出所有 API 密钥对
-   [`apiKeyPairsUpdate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/apikeypairs/README.md#update) - 更新 API 密钥对
-   [`auditLogsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/auditlogs/README.md#list) - 清单审计记录条目
-   [`buyersCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/buyers/README.md#create) - 增加买主
-   [`buyersDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/buyers/README.md#delete) - 删除买方
-   [`buyersGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/buyers/README.md#get) - 找买家
-   [`buyersGiftCardsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vygiftcards/README.md#list) - 列出买家的礼品卡
-   [`buyersList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/buyers/README.md#list) - 列出所有买家
-   [`buyersPaymentMethodsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vypaymentmethods/README.md#list) - 列出买方付款方法
-   [`buyersShippingDetailsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/shippingdetails/README.md#create) - 增加买方运输详情
-   [`buyersShippingDetailsDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/shippingdetails/README.md#delete) - 删除买方的货运细节
-   [`buyersShippingDetailsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/shippingdetails/README.md#get) - 获得买方的运输细节
-   [`buyersShippingDetailsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/shippingdetails/README.md#list) - 列出买方的货运详情
-   [`buyersShippingDetailsUpdate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/shippingdetails/README.md#update) - 更新买方的运输细节
-   [`buyersUpdate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/buyers/README.md#update) - 更新买方
-   [`cardSchemeDefinitionsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/cardschemedefinitions/README.md#list) - 列表卡方案定义
-   [`checkoutSessionsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/checkoutsessions/README.md#create) - 创建退出会话
-   [`checkoutSessionsDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/checkoutsessions/README.md#delete) - 删除退出会话
-   [`checkoutSessionsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/checkoutsessions/README.md#get) - 获取退出会话
-   [`checkoutSessionsUpdate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/checkoutsessions/README.md#update) - 更新退出会话
-   [`digitalWalletsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/digitalwallets/README.md#create) - 登记数字钱包
-   [`digitalWalletsDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/digitalwallets/README.md#delete) - 删除数字钱包
-   [`digitalWalletsDomainsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/domains/README.md#create) - 注册数字钱包域名
-   [`digitalWalletsDomainsDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/domains/README.md#delete) - 删除数字钱包域
-   [`digitalWalletsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/digitalwallets/README.md#get) - 拿数字钱包
-   [`digitalWalletsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/digitalwallets/README.md#list) - 列出数字钱包
-   [`digitalWalletsSessionsApplePay`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#applepay) - 创建苹果支付会话
-   [`digitalWalletsSessionsClickToPay`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#clicktopay) - 创建点击支付会话
-   [`digitalWalletsSessionsGooglePay`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#googlepay) - 创建谷歌付费会话
-   [`digitalWalletsSessionsPaze`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#paze) - 创建帕泽会话
-   [`digitalWalletsSessionsPazeMobileSessionComplete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#pazemobilesessioncomplete) - 完成帕泽会议
-   [`digitalWalletsSessionsPazeMobileSessionCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#pazemobilesessioncreate) - 创建帕泽移动会话
-   [`digitalWalletsSessionsPazeMobileSessionReview`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/sessions/README.md#pazemobilesessionreview) - 审查帕泽会议
-   [`digitalWalletsUpdate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/digitalwallets/README.md#update) - 更新数字钱包
-   [`giftCardsActivationsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/activations/README.md#create) - 激活礼品卡
-   [`giftCardsBalancesList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/balances/README.md#list) - 礼品卡余额清单
-   [`giftCardsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/giftcards/README.md#create) - 创建礼品卡
-   [`giftCardsDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/giftcards/README.md#delete) - 删除礼品卡
-   [`giftCardsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/giftcards/README.md#get) - 拿礼物卡
-   [`giftCardsIssuancesCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/issuances/README.md#create) - 发礼物卡
-   [`giftCardsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/giftcards/README.md#list) - 名单礼品卡
-   [`merchantAccountsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/merchantaccounts/README.md#create) - 创建一个商号
-   [`merchantAccountsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/merchantaccounts/README.md#get) - 买个商户
-   [`merchantAccountsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/merchantaccounts/README.md#list) - 列出所有商业账户
-   [`merchantAccountsThreeDsConfigurationCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsconfiguration/README.md#create) - 为商家创建 3DS 配置
-   [`merchantAccountsThreeDsConfigurationDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsconfiguration/README.md#delete) - 删除商家的3DS配置
-   [`merchantAccountsThreeDsConfigurationList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsconfiguration/README.md#list) - 列出商家的3DS配置
-   [`merchantAccountsThreeDsConfigurationUpdate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsconfiguration/README.md#update) - 编辑 3DS 配置
-   [`merchantAccountsUpdate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/merchantaccounts/README.md#update) - 更新一个商号
-   [`paymentLinksCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentlinks/README.md#create) - 添加支付链接
-   [`paymentLinksExpire`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentlinks/README.md#expire) - 付款链接过期
-   [`paymentLinksGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentlinks/README.md#get) - 获取支付链接
-   [`paymentLinksList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentlinks/README.md#list) - 列出所有支付链接
-   [`paymentMethodsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentmethods/README.md#create) - 创建支付方法
-   [`paymentMethodsDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentmethods/README.md#delete) - 删除支付方法
-   [`paymentMethodsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentmethods/README.md#get) - 获得支付方法
-   [`paymentMethodsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentmethods/README.md#list) - 列出所有付款方法
-   [`paymentMethodsNetworkTokensCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/networktokens/README.md#create) - 提供网络信号
-   [`paymentMethodsNetworkTokensCryptogramCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/cryptogram/README.md#create) - 提供网络代号密码图
-   [`paymentMethodsNetworkTokensDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/networktokens/README.md#delete) - 删除网络标志
-   [`paymentMethodsNetworkTokensList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/networktokens/README.md#list) - 列出网络符号
-   [`paymentMethodsNetworkTokensResume`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/networktokens/README.md#resume) - 恢复网络信号
-   [`paymentMethodsNetworkTokensSuspend`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/networktokens/README.md#suspend) - 暂停网络信号
-   [`paymentMethodsPaymentServiceTokensCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicetokens/README.md#create) - 创建支付服务标志
-   [`paymentMethodsPaymentServiceTokensDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicetokens/README.md#delete) - 删除付款服务代号
-   [`paymentMethodsPaymentServiceTokensList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicetokens/README.md#list) - 列出付款服务标志
-   [`paymentMethodsUpdate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentmethods/README.md#update) - 更新支付方法
-   [`paymentOptionsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentoptions/README.md#list) - 列出付款选项
-   [`paymentServiceDefinitionsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicedefinitions/README.md#get) - 获得支付服务的定义
-   [`paymentServiceDefinitionsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicedefinitions/README.md#list) - 列出付款服务定义
-   [`paymentServiceDefinitionsSession`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservicedefinitions/README.md#session) - 为支付服务定义创建一个会话
-   [`paymentServicesCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#create) - 配置付款服务
-   [`paymentServicesDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#delete) - 删除配置的付款服务
-   [`paymentServicesGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#get) - 获得支付服务
-   [`paymentServicesList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#list) - 清单支付服务
-   [`paymentServicesSession`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#session) - 为支付服务定义创建一个会话
-   [`paymentServicesUpdate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#update) - 更新已配置的付款服务
-   [`paymentServicesVerify`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/paymentservices/README.md#verify) - 核查付款服务证书
-   [`payoutsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/payouts/README.md#create) - 创造报酬
-   [`payoutsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/payouts/README.md#get) - 拿到钱
-   [`payoutsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/payouts/README.md#list) - 创建清单付款
-   [`refundsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/refunds/README.md#get) - 退钱
-   [`reportExecutionsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/reportexecutions/README.md#list) - 列出已执行报告
-   [`reportsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/reports/README.md#create) - 增加一个报告
-   [`reportsExecutionsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/executions/README.md#get) - 得到执行报告
-   [`reportsExecutionsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/executions/README.md#list) - 开列处决报告
-   [`reportsExecutionsUrl`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/executions/README.md#url) - 为已执行的报告创建 URL
-   [`reportsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/reports/README.md#get) - 拿个报告
-   [`reportsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/reports/README.md#list) - 列出已配置的报告
-   [`reportsPut`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/reports/README.md#put) - 更新报告
-   [`rolesList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/roles/README.md#list) - 列出所有角色
-   [`threeDsScenariosCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsscenarios/README.md#create) - 创建3DS方案
-   [`threeDsScenariosDelete`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsscenarios/README.md#delete) - 删除3DS方案
-   [`threeDsScenariosList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsscenarios/README.md#list) - 列出3DS方案
-   [`threeDsScenariosUpdate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/threedsscenarios/README.md#update) - 更新3DS方案
-   [`transactionsActionsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/actions/README.md#list) - 交易流程规则
-   [`transactionsCancel`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#cancel) - 取消交易
-   [`transactionsCapture`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#capture) - 扣押交易
-   [`transactionsCapturesGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/captures/README.md#get) - 获取交易记录
-   [`transactionsCapturesList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/captures/README.md#list) - 清单交易抓取
-   [`transactionsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#create) - 创建交易
-   [`transactionsEventsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/events/README.md#list) - 列出交易事项
-   [`transactionsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#get) - 获取交易
-   [`transactionsIncrementAuthorization`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#incrementauthorization) - 增加交易授权
-   [`transactionsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#list) - 清单交易
-   [`transactionsRefundsAllCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/all/README.md#create) - 创建批次交易退款
-   [`transactionsRefundsCreate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vyrefunds/README.md#create) - 创建交易退款
-   [`transactionsRefundSettlementsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/refundsettlements/README.md#get) - 获得交易退款结算
-   [`transactionsRefundSettlementsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/refundsettlements/README.md#list) - 清单交易退款结算
-   [`transactionsRefundsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vyrefunds/README.md#get) - 得到交易退款
-   [`transactionsRefundsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/gr4vyrefunds/README.md#list) - 清单交易退款
-   [`transactionsSettlementsGet`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/settlements/README.md#get) - 获得交易结算
-   [`transactionsSettlementsList`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/settlements/README.md#list) - 清单交易结算
-   [`transactionsSync`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#sync) - 同步交易
-   [`transactionsUpdate`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#update) - 手工更新交易
-   [`transactionsVoid`](https://npmcn.com/package/%40gr4vy/sdk/docs/sdks/transactions/README.md#void) - 虚拟交易

## 调试

您可以为 SDK 请求和响应设置 SDK 以发送调试日志 .

你可以通过一个匹配的日志 `console`'作为 SDK 选项的接口.

> \[尖叫声\] 注意调试日志会揭示一些秘密, 如标题中的 API 令牌, 打印到控制台或文件中的日志信息 。 建议只在本地开发期间使用这一特征,而不能用于生产.

```typescript
import { Gr4vy } from "@gr4vy/sdk";

const sdk = new Gr4vy({ debugLogger: console });
```

通过设置环境变量也可以启用默认调试日志 `GR4VY_DEBUG` 改为 `true`, (中文(简体) ), `1`, (中文(简体) ), `yes` 或者说 `on` (大小写不敏感). 任何其它价值都使它失效.

# 发展

## 测试

SDK有一个端到端的测试套件,能与E2E相对抗. 地点 页:1 `private_key.pem` 用于repo 根(或导出)中的测试环境 `PRIVATE_KEY`),然后:

```sh
npm install
npx vitest run
```

见 **[试验. md](https://npmcn.com/package/%40gr4vy/sdk/TESTING.md)** 为全向导——套间布局,并列 和CI 硬化、基于财产的测试、覆盖/端点覆盖报告,以及 如何测试与释放管道的联系.

## 捐款

虽然我们重视对SDK的开源贡献,但这个库是程序生成的. 随便打开公关或Github问题作为概念的证明,我们会尽力将其纳入未来的发行中!

### SDK 创建者 [说话方便](https://docs.speakeasyapi.dev/docs/using-speakeasy/client-sdks)

## 常见问题

### @gr4vy/sdk 是什么？

开发者方便且类型安全 类型SDK 格鲁维 API \(英语\)\.

### 如何安装 @gr4vy/sdk？

在项目目录运行 npm install @gr4vy/sdk，或使用 pnpm add / yarn add / bun add。

### @gr4vy/sdk 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @gr4vy/sdk 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @gr4vy/sdk 可以商用吗？

@gr4vy/sdk 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @gr4vy/sdk 的下载量有多少？

根据 npm 官方下载统计，@gr4vy/sdk 在 2026/10/17 – 2026/11/15 这 30 天内被下载 52,198 次，日均约 1,740 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gr4vy/sdk 还在维护吗？

最新版本 2\.4\.47 发布于 2026/11/11（5 天前）；至今共发布 317 个版本，其中过去 12 个月发布了 189 个；首次发布于 2025/04/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

