Atualizar pedido

​

Status aceitos

• pending
• paid
• refused
• refunded
• chargedback

• approved, completed, concluido, pago -> paid
• waiting_payment, pendente -> pending
• rejected, failed, cancelled, recusado -> refused
• refund, reembolsado, estornado -> refunded
• chargeback, charged_back, dispute -> chargedback

​

Transições válidas

​

Payload para marcar como pago

{
  "status": "paid",
  "paidAt": "2026-05-10T15:40:00Z"
}

​

Campos permitidos no PATCH

• status
• paidAt
• refundedAt
• chargedbackAt
• isTest
• amounts
• customer
• tracking
• trackingExtras
• metadata

​

Exemplo curl

curl -X PATCH "https://app.atriby.com/api/v1/orders/order_001" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order_001_paid" \
  -d '{
    "status": "paid",
    "paidAt": "2026-05-10T15:40:00Z"
  }'

​

Erros

• ORDER_NOT_FOUND: pedido não existe no dashboard autenticado.
• INVALID_STATUS_TRANSITION: transição de status inválida.
• VALIDATION_FAILED: payload inválido.
• UNAUTHORIZED ou TOKEN_REVOKED: problema no token.