---
title: "POST /charges/{id}/capture"
method: POST
path: "/charges/{id}/capture"
tags: ["Charges"]
---

# POST /charges/{id}/capture

`POST /charges/{id}/capture`

Captura de uma charge autorizada.<br><br>         A autenticação no endpoint é feita da seguinte forma:
  * **Bearer Token Authorization**: Token JWT.

## Path parameters

- `id` string, required

## Headers

- `Host` string, required

## Request body

- PostChargeCaptureRequest
  - `amount` integer, required — Valor a ser capturado
  - `emv_data` string — Dados obtidos do chip do cartão
  - `initiator_operation_id` string — Identificador externo que pode ser utilizado para identificar cada operação realizada

## Response `200`

OK

- PostChargeResponse
  - `id` string, required — Identificador único da cobrança.
  - `initiator_id` string, required — Identificador externo (cliente) que pode ser utilizado em reversões e consultas.
  - `reference_id` string — Identificador externo, geralmente relacionado a um pedido ou outra referência do cliente, apenas em fluxos informacionais.
  - `amount` integer, required — Valor requisitado na cobrança em centavos.
  - `payment_method` 'card', required — Meio de pagamento da cobrança.
  - `status` 'authorized' | 'paid' | 'canceled' | 'declined', required — Status atual da Charge
  - `created_at` string, yyyy-MM-ddTHH:mm:ssZ, required — Data e hora da criação da cobrança no formato ISO8601.
  - `card_transaction` object
    - `type` 'credit' | 'debit' | 'voucher', required — Detalhamento de que tipo de cartão está sendo utilizado na cobrança.
    - `funding_source` 'credit' | 'debit' | 'prepaid' — Indicação para o método de liquidação a ser utilizado.
    - `result` 'success' | 'failed', required — Resultado da operação que foi executada
    - `transaction_id` string, required — Identificador da transação emitido pelo provedor (Adquirente).
    - `operation_id` string, required — Identificador da operação gerado pela adquirente.
    - `brand_transaction_id` string — Identificador da transação no Emissor.
    - `authorization_code` string — Código de autorização.
    - `acquirer_message` string — Mensagem de resultado da operação retornada pela adquirente.
    - `acquirer_return_code` string, required — Código de resultado da operação retornado pela adquirente.
    - `brand_return_code` string — Código de retorno ABECS.
    - `merchant_advice_code` string — código de retorno do padrão MAC.
    - `additional_data` object[] — Detalhamento de informações adicionais
      - `name` string, required — Nome da propriedade adicional
      - `value` string, required — Valor da propriedade adicional
    - `card` object, required
      - `brand` string, required — Bandeira do cartão
      - `remaining_balance` integer — Saldo disponível no cartão, caso seja informado pela adquirente
      - `emv_response` string, binary — EMV
      - `payment_account_reference` string — Referência exclusiva ao cartão, usada por comerciantes e adquirentes para vincular transações tokenizadas e não tokenizadas associadas ao mesmo cartão subjacente (PAR).

## Other responses

- `400` — BadRequest
- `401` — Não autorizado
- `404` — NotFound
- `422` — Captura não processada

---

[API](https://skmtc.dev/stone/apis/payments-processing-acquiring-paymentcardapi.md) · [All operations](https://skmtc.dev/stone/apis/payments-processing-acquiring-paymentcardapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stone/payments-processing-acquiring-paymentcardapi/revisions/29bc4962fa98/schema)
