---
updatedAt: 2026-04-09T14:47:00.000Z
agentTools:
  siteIndex: https://docs.cielo.com.br/llms.txt
  projectIndex: https://docs.cielo.com.br/gateway/llms.txt
---

# Capturar transação de cartão de crédito

Realiza a captura posterior de uma transação de crédito.

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Ambiente
      </th>

      <th style={{ textAlign: "left" }}>
        Método
      </th>

      <th style={{ textAlign: "left" }}>
        Endpoint
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        Sandbox
      </td>

      <td style={{ textAlign: "left" }}>
        <div class="headline-container-article-info2GaOf2jMpV0r">
          <span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_put headline-container-api-method1Hc-Fm7uaccR" data-testid="http-method">put</span>
        </div>
      </td>

      <td style={{ textAlign: "left" }}>
        `https://apisandbox.braspag.com.br/v2/sales/{PaymentId}/capture`
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        Produção
      </td>

      <td style={{ textAlign: "left" }}>
        <div class="headline-container-article-info2GaOf2jMpV0r">
          <span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_put headline-container-api-method1Hc-Fm7uaccR" data-testid="http-method">put</span>
        </div>
      </td>

      <td style={{ textAlign: "left" }}>
        `https://api.braspag.com.br/v2/sales/{PaymentId}/capture`
      </td>
    </tr>
  </tbody>
</Table>

### Captura total

Para capturar totalmente uma transação, não é necessário enviar o campo `Amount`.

### Captura parcial

Para capturar parcialmente uma transação, envie no campo `Amount`  o valor em centavos que deseja capturar.

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Ambiente
      </th>

      <th>
        Método
      </th>

      <th>
        Endpoint
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Sandbox
      </td>

      <td>
        <div class="headline-container-article-info2GaOf2jMpV0r">
          <span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_put headline-container-api-method1Hc-Fm7uaccR" data-testid="http-method">
            put
          </span>
        </div>
      </td>

      <td>
        `apisandbox.braspag.com.br/v2/sales/{PaymentId}/capture?amount={Amount}`
      </td>
    </tr>

    <tr>
      <td>
        Produção
      </td>

      <td>
        <div class="headline-container-article-info2GaOf2jMpV0r">
          <span class="rm-APIMethod APIMethod APIMethod_fixedWidth APIMethod_put headline-container-api-method1Hc-Fm7uaccR" data-testid="http-method">
            put
          </span>
        </div>
      </td>

      <td>
        `api.braspag.com.br/v2/sales/{PaymentId}/capture?amount={Amount}`
      </td>
    </tr>
  </tbody>
</Table>

<br />

Quando uma transação é submetida com o parâmetro `Payment.Capture` igual a “false”, é necessário fazer uma solicitação de captura posterior para confirmar a transação.

> **A API permite capturar transações individualmente.**
>
> Para capturar um grupo de transações, utilize o portal e-commerce. Saiba mais em:
>
> * <Anchor label="Como fazer a captura em lote" target="_blank" href="https://docs.cielo.com.br/atendimento/docs/como-capturar-a-transa%C3%A7%C3%A3o#como-fazer-a-captura-em-lote">Como fazer a captura em lote</Anchor>.

> ⚠️ Atenção
>
> * Após cerca de **50 tentativas de captura**, o autorizador bloqueia novas capturas e retorna o código **841 (excesso de tentativas)**. Nesse caso, não é possível capturar a transação; é necessário **gerar uma nova transação**.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "cartão-de-crédito",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://apisandbox.braspag.com.br"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/v2/sales/{PaymentId}/capture": {
      "put": {
        "summary": "Capturar transação de cartão de crédito",
        "description": "Realiza a captura posterior de uma transação de crédito.",
        "operationId": "capturar-credito",
        "parameters": [
          {
            "name": "PaymentId",
            "in": "path",
            "description": "Campo identificador do pedido.  Tamanho: 36.",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "Amount",
            "in": "query",
            "description": "Valor a ser capturado, em centavos. Verificar se a adquirente utilizada suporta uma captura parcial. Caso não seja especificado um valor, a captura será total.  Tamanho: 15.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "Content-type",
            "in": "header",
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "MerchantId",
            "in": "header",
            "description": "Identificador da loja no Gateway de Pagamento. Tamanho: 36. Formato: GUID. <br>*Esta documentação traz um `MerchantId` padrão para permitir os testes em sandbox, mas você também pode informar o `MerchantId` habilitado durante o processo de implantação.*",
            "required": true,
            "schema": {
              "type": "string",
              "default": "e3c24810-18bb-4bd7-88a0-a36d6b4a0731"
            }
          },
          {
            "name": "MerchantKey",
            "in": "header",
            "description": "Chave pública para autenticação dupla no Gateway de Pagamento. Tamanho: 40. Formato: GUID. <br>*Esta documentação traz um `MerchantKey` padrão para permitir os testes em sandbox, mas você também pode informar o `MerchantKey` habilitado durante o processo de implantação.*",
            "required": true,
            "schema": {
              "type": "string",
              "default": "GQUAIWVDKUINZRHDQPLHUVHAIIFEIXFEXWPOYGHY"
            }
          },
          {
            "name": "RequestId",
            "in": "header",
            "description": "Identificador do request definido pela loja, utilizado quando o lojista usa diferentes servidores para cada GET/POST/PUT.  Tamanho: 36.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"Status\": 2,\n    \"ReasonCode\": 0,\n    \"ReasonMessage\": \"Successful\",\n    \"ProviderReturnCode\": \"6\",\n    \"ProviderReturnMessage\": \"Operation Successful\",\n    \"Links\": [\n        {\n            \"Method\": \"GET\",\n            \"Rel\": \"self\",\n            \"Href\": \"https://apiquerysandbox.braspag.com.br/v2/sales/{PaymentId}\"\n        },\n        {\n            \"Method\": \"PUT\",\n            \"Rel\": \"void\",\n            \"Href\": \"https://apisandbox.braspag.com.br/v2/sales/{PaymentId}/void\"\n        }\n    ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "Status": {
                      "type": "integer",
                      "example": 2,
                      "default": 0
                    },
                    "ReasonCode": {
                      "type": "integer",
                      "example": 0,
                      "default": 0
                    },
                    "ReasonMessage": {
                      "type": "string",
                      "example": "Successful"
                    },
                    "ProviderReturnCode": {
                      "type": "string",
                      "example": "6"
                    },
                    "ProviderReturnMessage": {
                      "type": "string",
                      "example": "Operation Successful"
                    },
                    "Links": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "Method": {
                            "type": "string",
                            "example": "GET"
                          },
                          "Rel": {
                            "type": "string",
                            "example": "self"
                          },
                          "Href": {
                            "type": "string",
                            "example": "https://apiquerysandbox.braspag.com.br/v2/sales/{PaymentId}"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```