Fechar pedido e cobrar

Fecha o carrinho em pedido e cria a cobrança no gateway da forma de pagamento escolhida. Exige o X-Cart-Token e um Idempotency-Key: repetir a chamada com a mesma chave devolve o mesmo pedido. Cartão: envie o token gerado no navegador pelo SDK do gateway (payment.card), nunca o número do cartão. Pagamento recusado responde 402 payment_declined com o pedido em error.details, para pagar de novo em POST /orders/{orderId}/payments. Gateway fora do ar responde 502 payment_provider_unavailable: o carrinho já virou pedido e error.details traz o pedido, o accessToken e o orderUrl. Repetir o checkout com a mesma Idempotency-Key e o mesmo corpo devolve esse pedido e tenta a cobrança de novo; para trocar a forma de pagamento, use POST /orders/{orderId}/payments. termsAcceptedAt é o momento em que o comprador aceitou os termos da loja, nas últimas 24 horas: ele vai para o pedido junto com os termos e a política de reembolso vigentes e entra no dossiê de contestação. Com a chave secreta, a chamada sai do servidor da loja: envie o IP e o navegador do comprador em buyer.ip e buyer.userAgent, senão o pedido fica sem eles.

Chave: Chave publicável ou secreta.

Escopo: checkout:write.

Idempotência: exige o cabeçalho Idempotency-Key.

Limite: 20 requisições a cada 1 min, além do limite geral de 600 por minuto por chave.