Primeiros passos
1. Solicite a integração
Seção intitulada “1. Solicite a integração”A integração é criada por um operador da RaptorX. Envie ao seu contato na RaptorX:
| Informação | Detalhes |
|---|---|
| Nome do parceiro | Como sua empresa (e a loja) deve aparecer |
| Merchant ID | Identificador da loja no seu sistema |
| URL de webhook | Endereço HTTPS público que receberá os eventos de status. Endereços privados ou localhost são recusados |
| App ID (opcional) | Se informado, a RaptorX o envia no header X-App-Id dos webhooks |
Cada loja tem uma integração Open Delivery ativa, e o Merchant ID é único.
2. Receba as credenciais
Seção intitulada “2. Receba as credenciais”Ao criar a integração, o operador recebe o clientId e o clientSecret e os repassa a você, junto com:
- a URL base da API que você deve usar;
- a URL do token (
{URL base}/integrations/opendelivery/oauth/token).
3. Endereços (hosts)
Seção intitulada “3. Endereços (hosts)”| Endereço | Descrição |
|---|---|
https://api.raptorx.com.br |
Endereço principal da RaptorX. Encaminha para a instância onde a loja está cadastrada |
https://api.lideradelivery.com.br |
Instância Lidera |
Use o endereço informado pelo seu contato na RaptorX. As duas URLs são de produção.
4. Como testar com segurança
Seção intitulada “4. Como testar com segurança”- Combine a janela de testes com a RaptorX antes de enviar qualquer requisição.
- Use uma loja de teste e pedidos com dados fictícios.
- Em lojas que aguardam o pedido pronto, a entrega só é oferecida a entregadores depois de
readyForPickup; em lojas de despacho imediato, a oferta começa na criação. Confirme com a RaptorX como a loja de teste está configurada. - Cancele as entregas de teste ao final (a loja precisa ter a permissão de cancelamento habilitada) ou peça à RaptorX que as cancele.
- Para validar o recebimento de eventos sem criar entregas, teste a verificação da assinatura com um corpo de exemplo gerado por você (veja Eventos de status).
Próximo passo
Seção intitulada “Próximo passo”Obtenha o token em Autenticação.