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

<QuickLinks>
  <QuickLink href="https://docs.payzu.com.br/payzu-conta-digital.postman_collection.json" title="Coleção (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>

A coleção **PayZu Conta Digital API** tem uma pasta por trecho do caminho: `POST /transactions/payment/{paymentId}/refund` fica em `transactions › payment › {paymentId} › refund`. Cada requisição traz um exemplo de resposta salvo.

<Callout type="warn">
  As chamadas vão para **produção** e movem dinheiro de verdade na conta da credencial.
</Callout>

<Steps>
  <Step>
    ### Importar a coleção [#importar-a-coleção]

    No Postman, **Import → Link**:

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

  <Step>
    ### Preencher a credencial [#preencher-a-credencial]

    Nas variáveis da coleção, preencha `clientId` e `clientSecret`:

    | Variável       | Valor                                           |
    | -------------- | ----------------------------------------------- |
    | `baseUrl`      | `https://api.hub.payzu.com.br/api/v1`           |
    | `clientId`     | `client_id` da credencial                       |
    | `clientSecret` | `client_secret` da credencial                   |
    | `token`        | Preenchido pela requisição **Get access token** |
  </Step>

  <Step>
    ### Obter o token [#obter-o-token]

    Rode **Get access token** (`POST /oauth/token`). Ela usa Basic Auth com `clientId` e `clientSecret` e, na resposta `200`, grava o `access_token` em `token`.

    O token vale 15 minutos. Quando as requisições começarem a responder `401` com `TOKEN_INVALID`, rode **Get access token** de novo.
  </Step>

  <Step>
    ### Chamar as rotas [#chamar-as-rotas]

    As outras requisições herdam da coleção o header `Authorization: Bearer {{token}}`. Basta escolher a requisição e enviar.
  </Step>
</Steps>

## Repetir saque, pagamento de Pix copia e cola e transferência [#repetir-saque-pagamento-de-pix-copia-e-cola-e-transferência]

As requisições de saque, pagamento de Pix copia e cola e transferência já mandam `Idempotency-Key`. A coleção cria a chave antes do primeiro envio e só a descarta quando chega uma resposta abaixo de `500`. Depois de um `5xx` ou de uma falha de rede, envie de novo: a chave é a mesma, e a operação não se duplica.