- Registrar/atualizar merchant
Dados do merchant
Notificar atualização
Status e horários do merchant
Upload de imagem
Registrar/atualizar merch...
Host: Keeta. Vincula o ID do merchant no seu sistema ao ID da Keeta e registra suas URLs.
| Parâmetro | Onde | Descrição |
|---|---|---|
merchantId | query (obrig.) | ID do merchant no seu sistema (o mesmo que será enviado em x-polling-merchants) |
| Campo do corpo | Tipo | Obrig. | Descrição |
|---|---|---|---|
keetaMerchantId | number | sim | ID gerado pela Keeta (Dev Portal / portal do merchant) |
getMerchantURL.baseURL | string | sim, quando getMerchantURL é enviado | URL do seu GET /v1/merchant para este merchant |
getMerchantURL.apiKey | string | não | Chave, se seu endpoint exigir |
ordersWebhookURL | string | não | URL do seu webhook POST /v1/newEvent |
Importante:
- O
keetaMerchantIdgarante o mapeamento correto; guarde a relação entre os dois IDs no seu sistema. - Reenviar um onboarding com um
keetaMerchantIdoumerchantIdjá registrado na mesma aplicação apaga o mapeamento anterior e cria um novo. - Sem onboarding, não há eventos de pedido (nem via polling, nem via webhook).
Exemplo: PUT /v1/merchantOnboarding?merchantId=LOJA-SP-001
{
"keetaMerchantId": 159416882,
"getMerchantURL": { "baseURL": "https://api.seupdv.com.br/keeta/lojas/LOJA-SP-001/merchant", "apiKey": "chave-da-loja" },
"ordersWebhookURL": "https://api.seupdv.com.br/keeta/v1/newEvent"
}Respostas: 201 (devolve o próprio objeto), 400, 401, 403, 404, 503.
Segurança
OAuth2(Escopos obrigatórios: od.all) and Sig
Informações de acesso ao GET /v1/merchant do Software Service do merchant. A Keeta usa este endpoint para obter os dados do merchant.
URL do webhook POST /v1/newEvent do Software Service. A Keeta envia os eventos do pedido para este endereço.
- https://open.mykeeta.com/api/open/opendeliveryhttps://open.mykeeta.com/api/open/opendelivery/v1/merchantOnboarding
curl -i -X PUT \
'https://open.mykeeta.com/api/open/opendelivery/v1/merchantOnboarding?merchantId=string' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-H 'X-App-Signature: YOUR_API_KEY_HERE' \
-d '{
"getMerchantURL": {
"baseURL": "http://example.com",
"apiKey": "string"
},
"ordersWebhookURL": "http://example.com",
"keetaMerchantId": 0
}'Resource has been created.
Informações de acesso ao GET /v1/merchant do Software Service do merchant. A Keeta usa este endpoint para obter os dados do merchant.
URL do webhook POST /v1/newEvent do Software Service. A Keeta envia os eventos do pedido para este endereço.
Resposta
{ "getMerchantURL": { "baseURL": "http://example.com", "apiKey": "string" }, "ordersWebhookURL": "http://example.com", "keetaMerchantId": 0 }