# Pedidos e integrações

> Mandar vendas para a Momentum pela API de pedidos ou por um provedor conectado.

## Duas confianças

| Origem | Conta como |
| --- | --- |
| Provedor de pagamento conectado (ou plataforma) | **confirmada pelo provedor** |
| API de pedidos enviada pela sua loja | **declarada pela loja** |

As telas mostram as duas separadas. As [Recompensas](/recompensas/) contam só as confirmadas.

## API de pedidos

1. Em **Pedidos → Integrações**, crie uma chave para o seu checkout (comece pelo ambiente de teste).
2. Envie cada mudança de pedido para:

```
POST https://app.momentummidia.com/api/v1/orders/events
Authorization: Bearer <sua chave>
Content-Type: application/json
```

```
{
  "eventId": "evt-123",
  "occurredAt": "2026-11-01T14:30:00Z",
  "status": "approved",
  "order": {
    "id": "pedido-987",
    "createdAt": "2026-11-01T14:29:10Z",
    "amountMinor": 19990,
    "currency": "BRL",
    "linkerRef": "<referência do linker, se houver>"
  }
}
```

- `status`: `pending`, `failed`, `cancelled`, `approved`, `partially_refunded`, `refunded` ou `chargeback`.
- Valores sempre em centavos (`amountMinor`), moeda com 3 letras.
- O mesmo `eventId` enviado de novo não duplica nada.
- Até 120 eventos por minuto por chave. Resposta 200 quando processado, 202 quando ficou na fila.

## Provedores e plataformas

Stripe e Asaas (pagamento) e Shopify, WooCommerce e CentralCart (plataformas) estão prontos e testados com contas de teste. Se for usar em produção, fale com o suporte para acompanharmos o primeiro pedido de perto.

## Reprocessar

Eventos com erro aparecem em **Pedidos** com o motivo e um botão para tentar de novo.