{"templateId":"markdown","versions":[{"version":"opendelivery","label":"Open Delivery API","link":"/en/apis/docs/development-guides1","default":true,"active":true,"folderId":"62a846bf"},{"version":"standard","label":"Standard Keeta API","link":"/en/apis/standard/docs/development-guides1","default":false,"active":false,"folderId":"62a846bf"},{"version":"grocery","label":"Grocery Keeta API","link":"/en/apis/grocery/docs/development-guides1","default":false,"active":false,"folderId":"62a846bf"}],"sharedDataIds":{"sidebar":"sidebar-@l10n/en/apis/@opendelivery/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Autenticação e Segurança"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"autenticação-e-segurança","__idx":0},"children":["Autenticação e Segurança"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Keeta trabalha com dois mecanismos:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth 2.0 —"]}," usado pelo Software Service para chamar a API da Keeta (token Bearer obtido em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /oauth/token"]},")."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["apiKey —"]}," opcional, usado pela Keeta para chamar o endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/merchant"]}," hospedado pelo Software Service. Se o seu endpoint exigir chave, informe-a em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getMerchantURL.apiKey"]}," no onboarding."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Além do token, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["toda requisição"]}," do Software Service à Keeta deve carregar o header ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-App-Signature"]}," (ver a seção Cálculo de Assinatura). No sentido inverso, os webhooks da Keeta também chegam assinados, permitindo validar a origem."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"modos-de-token","__idx":1},"children":["Modos de token"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Modo"},"children":["Modo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"grant_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["grant_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Escopo do access_token"},"children":["Escopo do ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access_token"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Renovação"},"children":["Renovação"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App Level Token"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["app_level_token"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Um token para ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["todas"]}," as lojas autorizadas"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Chame ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /oauth/token"]}," de novo"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shop Level Authorization Code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shop_level_authorization_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Um token para ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["uma"]}," loja autorizada; troca o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authorization_code"]}," fornecido pelo merchant"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["grant_type=refresh_token"]}," antes de o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access_token expirar"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(legado)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_credentials"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Equivalente ao App Level Token"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mantido para integrações já homologadas"]}]}]}]}]}]},"headings":[{"value":"Autenticação e Segurança","id":"autenticação-e-segurança","depth":2},{"value":"Modos de token","id":"modos-de-token","depth":2}],"frontmatter":{"slug":"/apis/opendelivery/development-guides","seo":{"title":"Autenticação e Segurança"}},"lastModified":"2026-11-17T17:49:10.000Z","isTranslationFallback":true,"pagePropGetterError":{"message":"","name":""}},"slug":"/en/apis/opendelivery/development-guides","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}