Transações - Capturar

#Visão Geral

Captura uma transação previamente pré-autorizada (criada com payment.capture: false). A captura confirma a cobrança no cartão do cliente. É possível capturar o valor total ou um valor parcial (menor que o autorizado).

A captura é assíncrona: o endpoint aceita a solicitação (HTTP 202) e o processamento ocorre em background. Acompanhe o resultado pelos webhooks (transaction.approved) ou consultando a transação.

#Precauções

• Só pode ser usado em transações no status pre-authorized.
• O valor da captura não pode exceder o valor autorizado.
• Uma vez capturada, a transação não pode ser revertida — apenas reembolsada.
• O ID da transação é sensível a maiúsculas e minúsculas (tra_... ou trx_...).
• Plataformas de marketplace: a captura de uma venda feita com onBehalfOf é pedida como a sub-conta, com X-Selectwin-Account: bus_… — veja Operar como a sub-conta.

#Casos de uso

• Reservas hoteleiras: autorizar no check-in e capturar após verificar consumos.
• Aluguel de veículos: pré-autorizar caução e capturar apenas se houver danos.
• Serviços sob demanda: autorizar valor estimado e capturar o valor real.
• Verificação de fundos: garantir saldo antes de processar.

#Requisição

POST /v1/transactions/{transactionId}/capture

#Parâmetros de URL

#Parâmetros do Corpo da Requisição

#Exemplo de Requisição

Captura total (corpo vazio ou sem amount):

{}

Captura parcial:

{ "amount": 8000 }

#Resposta

#Aceito (HTTP 202 Accepted)

A captura foi aceita para processamento assíncrono.

{
  "transactionId": "tra_987654321",
  "status": "pre-authorized",
  "accepted": true
}

#Erros

#Melhores Práticas

1. Verifique o status (pre-authorized) antes de capturar.
2. Reaja ao webhook transaction.approved para confirmar a captura.
3. Considere captura parcial quando o valor final for menor que o autorizado.
4. Lembre-se do prazo de validade das pré-autorizações (normalmente alguns dias).