Cria uma pré-autorização (reserva de limite) sem capturar o valor. Para capturar
depois, use POST /v1/acquiring/payments/{paymentID}/capture; para desfazer, use
POST /v1/acquiring/payments/{paymentID}/void.

Diferenças versus POST /v1/acquiring/payments

• Não aceita paymentSplit — split só faz sentido após capture.
• Não aceita payer* / paymentLinkSlug — snapshot fica sem esses metadados.
• Cria snapshot com transaction_type = PRE_AUTHORIZATION.

Autenticação

• Bearer JWT (Autra) no header Authorization (APIGW).
• Transactional Token (transactionalToken) no body — token vindo de POST /v1/acquiring/payments/initialize, encaminhado no header Authorization para a Dock.

Fonte do cartão

Envie card OU tokenData (com slugToken do initialize ou slugStoredCard de tokenize-card). Nunca os dois juntos.

3-D Secure

Envie threeDsData (xid/cavv/cavvResultCode/…) quando quiser autorizar pré-com autenticação 3DS já concluída.

Status HTTP

Retorna o status HTTP da Dock (respDock.StatusCode) — não é sempre 200. Se a Dock devolver 422 com errors[], esta rota devolve 422 com a mesma envelope, e o snapshot fica com status = ERROR.