Cobrança com os dados do cartão (cartão cru, PCI)

POST 
/integration/v1/charges/card-raw

Só para conta liberada para cartão cru. O número e o CVV vão ao processador e não ficam em lugar nenhum aqui. cardStatus: ok (o crédito chega pelo aviso de captura), requires_action (o 3DS é concluído no navegador do comprador com action.clientSecret e action.publishableKey; depois, …/card-raw/confirm) ou processing. Recusa: 422 com o código do emissor em error.code e error.details.declineCode. Aceita Idempotency-Key.

Requisição

Respostas

200

A cobrança e cardStatus.

401

Credencial ausente ou inválida. error.code = unauthenticated.

422

error.details traz um mapa campo → lista de mensagens.

429

Teto de consumo atingido. error.details.retryAfter traz os segundos a esperar — sem isso, a reação natural é tentar de novo na hora, o que piora a saturação que o limite existe para conter.