# Postman (/zh/docs/conta-digital/postman)

<QuickLinks>
  <QuickLink href="https://docs.payzu.com.br/payzu-conta-digital.postman_collection.json" title="集合（JSON）" />

  <QuickLink href="/conta-digital-openapi.json" title="OpenAPI" />

  <QuickLink href="/api-scalar-conta-digital" title="Scalar" />

  <QuickLink href="/api-swagger-conta-digital" title="Swagger" />
</QuickLinks>

**PayZu Conta Digital API** 集合按路径的每一段划分文件夹：`POST /transactions/payment/{paymentId}/refund` 位于 `transactions › payment › {paymentId} › refund`。每个请求都带有一个已保存的响应示例。

<Callout type="warn">
  调用会发送到**生产环境**，并在凭证所属账户中移动真实资金。
</Callout>

<Steps>
  <Step>
    ### 导入集合 [#导入集合]

    在 Postman 中选择 **Import → Link**：

    ```
    https://docs.payzu.com.br/payzu-conta-digital.postman_collection.json
    ```
  </Step>

  <Step>
    ### 填写凭证 [#填写凭证]

    在集合变量中填写 `clientId` 和 `clientSecret`：

    | 变量             | 值                                     |
    | -------------- | ------------------------------------- |
    | `baseUrl`      | `https://api.hub.payzu.com.br/api/v1` |
    | `clientId`     | 凭证的 `client_id`                       |
    | `clientSecret` | 凭证的 `client_secret`                   |
    | `token`        | 由 **Get access token** 请求填入           |
  </Step>

  <Step>
    ### 获取令牌 [#获取令牌]

    运行 **Get access token**（`POST /oauth/token`）。它使用带 `clientId` 和 `clientSecret` 的 Basic Auth，并在 `200` 响应时把 `access_token` 写入 `token`。

    令牌有效期 15 分钟。当请求开始返回 `401` 和 `TOKEN_INVALID` 时，再运行一次 **Get access token**。
  </Step>

  <Step>
    ### 调用路由 [#调用路由]

    其他请求从集合继承 `Authorization: Bearer {{token}}` header。选择请求并发送即可。
  </Step>
</Steps>

## 重试提现、Pix 复制粘贴码付款和转账 [#重试提现pix-复制粘贴码付款和转账]

提现、Pix 复制粘贴码付款和转账请求已经会发送 `Idempotency-Key`。集合在首次发送前生成该键，只有收到低于 `500` 的响应时才丢弃它。遇到 `5xx` 或网络故障后，再次发送即可：键不变，操作不会重复执行。