Skip to main content
POST
Reenviar código de verificação do pedido
Gera e envia um novo código de verificação ao cliente. Só é aceito quando o pedido está aguardando código (next_action.type igual a otp_confirmation). Caso contrário, a resposta é 422 (order_not_confirmable).
Limite de 5 requisições por minuto por IP de origem. O limite não é separado por conta: se a sua plataforma atende várias contas a partir do mesmo servidor, todas dividem os mesmos 5 reenvios por minuto. Ao exceder, a resposta é 429 fora do envelope de erro da v2 ({ "message": "Too Many Attempts." }), com o header Retry-After.
Esta rota não aceita Idempotency-Key. A resposta traz o pedido atualizado, com o novo next_action.otp.expires_at.

Authorizations

Authorization
string
header
required

Chave de API (secret key) da conta, no formato sk_live_... (produção) ou sk_test_... (Dev mode). Envie no header Authorization: Bearer <chave>. Autentica todas as rotas da API v2 e as rotas de Análise de Fraude. A chave identifica a conta, então a API v2 não usa o header account. Uma chave só é aceita no ambiente em que foi criada. Gere a sua no dashboard em Configurações → Chaves de API.

Path Parameters

id
string
required

Identificador do recurso (o campo id devolvido pela API)

Response

Código reenviado

Pedido. O status é a agregação dos seus pagamentos. processing: em processamento. requires_capture: cartão autorizado, aguardando captura. requires_action: PIX aguardando pagamento ou verificação por código (veja next_action). paid: pago. failed: recusado (veja failure_reason). canceled: cancelado. refunded e partially_refunded: estornado. chargeback: contestado.

id
string

Código do pedido

Example:

"482913"

object
enum<string>
Available options:
order
status
enum<string>
Available options:
processing,
requires_capture,
requires_action,
paid,
failed,
canceled,
refunded,
partially_refunded,
chargeback
currency
string
Example:

"brl"

amount
integer

Valor total, em centavos

Example:

10000

payments
object[]
next_action
object | null

O que precisa acontecer para o pagamento seguir. pix_display_qr_code: exiba o QR Code para o pagador. otp_confirmation: a análise de fraude pediu verificação — nada é cobrado até o código ser confirmado na rota /confirm.

failure_reason
object

Motivo da recusa. Presente só quando o status é failed