API Reference
  1. Autra Platform API
  2. Acquiring

Capture pre-authorization

post
https://api.autra.io/v1/acquiring/payments//capture

Captura uma pré-autorização existente (criada por POST /v1/acquiring/payments/pre-authorization).

Regras

  • Só captura snapshots com type = PREAUTH. Chamar em outros tipos retorna 422 INVALID_STATUS.
  • amount pode ser ≤ ao valor pré-autorizado (parcial ou total). Maior retorna 422 INVALID_AMOUNT.
  • Não aceita card nem tokenData no body — o cartão original da pré-autorização já ficou vinculado ao snapshot. Enviar retorna 400 INVALID_JSON.

Autenticação

  • Bearer JWT (Autra) no header Authorization (APIGW).
  • Transactional Token (transactionalToken) no body — obrigatório, encaminhado no header Authorization para a Dock.

Status HTTP

Retorna o status HTTP da Dock. Se a captura for aceita, snapshot vira CAPTURED. Em erro, o paymentID volta junto com errors[] no envelope padrão.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

ID Autra do snapshot da pré-autorização.

Body Params
string
required

Token transacional (Bearer eyJ...) retornado por POST /v1/acquiring/payments/initialize.

string
required

CNPJ (14) ou CPF (11) do merchant no tenant. Sem máscara.

double
required
≥ 0.01

Valor a capturar. Deve ser > 0 e ≤ ao pré-autorizado.

Responses

Updated 2 months ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago

Did this page help you?