{"templateId":"markdown","versions":[{"version":"opendelivery","label":"Open Delivery API","link":"/en/apis/docs/merchant-authorization","default":true,"active":true,"folderId":"62a846bf"},{"version":"standard","label":"Standard Keeta API","link":"/en/apis/standard/docs/merchant-authorization","default":false,"active":false,"folderId":"62a846bf"},{"version":"grocery","label":"Grocery Keeta API","link":"/en/apis/grocery/docs/merchant-authorization","default":false,"active":false,"folderId":"62a846bf"}],"sharedDataIds":{"sidebar":"sidebar-@l10n/en/apis/@opendelivery/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Merchant Authorization"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"merchant-authorization","__idx":0},"children":["Merchant Authorization"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"merchant-adding-authorization-with-app-id","__idx":1},"children":["Merchant Adding Authorization (with APP ID)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\n    If a merchant wants to authorize an application, the merchant should go to the ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" App Activation "]}," tab in the Merchant Management \n    system, and click the ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" \"Activar aplicativo\" "]}," button at the top right corner of the page and follow the steps below:\n  "]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" Enter the APP ID "]}," of the service provider's application (available from the provider).\n    "]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" Confirm provider information "]}," to ensure accuracy.\n    "]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" Select the store(s) "]}," to be authorized:\n      ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For store-level accounts, this step is skipped."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For brand-level accounts, the merchant must select which stores to authorize."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\n        Click ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" Confirm "]}," to proceed.\n    "]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Copy authorization code"]},"(Optional) If the application you are about to authorize is an application in shop level authorization code mode, You will see the ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" authorization_code "]}," on the page. Please copy this code and give it to the software service to complete the authorization process.\n    "]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\n        Click ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" \"Registro da autorização\" "]}," to automatically download an Excel file containing the authorization record\n    "]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\n        Once authorization is complete:\n        ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The service provider's merchant operations email will receive a notification."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The provider's system will receive a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/en/apis/opendelivery/authentication/receiveauthorizationwebhook"},"children":[" webhook "]}," notification."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The provider can retrieve authorized merchant data via API."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"merchant-adding-authorization-via-url","__idx":2},"children":["Merchant Adding Authorization (via URL)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\n    The service provider logs into the Keeta Dev Portal using a developer or sub-account (operations account), clicks ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" “Add Authorization” "]}," , and shares the generated authorization URL with the merchant.\n  "]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The merchant opens the URL and logs in using either a ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" brand-level "]}," or ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" store-level "]}," account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The merchant does ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" not "]}," need to input an APP ID—simply select the stores to authorize, and click ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" Confirm. "]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Copy authorization code"]},"(Optional) If the application you are about to authorize is an application in shop level authorization code mode, You will see the ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" authorization_code "]}," on the page. Please copy this code and give it to the software service to complete the authorization process.\n    "]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" “Registro da autorização” "]}," to automatically download an Excel record of the authorization."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\n      Once authorization is completed:\n      ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The provider’s merchant operations email will receive a notification."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The provider’s system will receive a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/en/apis/opendelivery/authentication/receiveauthorizationwebhook"},"children":[" Webhook "]}," notification."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authorized merchant data can be retrieved via API."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\n    After authorization, the merchant should contact the provider to complete store configuration (such as store mapping).\n  "]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"merchant-revokeing-authorization","__idx":3},"children":["\n    Merchant Revokeing Authorization\n  "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\n    Merchants can revoke authorization using either of the following methods:\n  "]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" Bulk revocation: "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select the current list of stores and revoke authorization in a batch. A double-confirmation popup is required before the operation proceeds."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":[" Single revocation: "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click the designated button and confirm to revoke authorization for an individual store."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Upon completion:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An Excel file containing the operation record will be automatically downloaded for reference."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The service provider's merchant operations email will receive a notification."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The provider's system will receive a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/en/apis/opendelivery/authentication/receiveauthorizationwebhook"},"children":[" Webhook "]}," event."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The provider will lose access to merchant store data via API."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"stay-updated-of-merchants-authorization-activity","__idx":4},"children":["Stay updated of merchants authorization activity"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\n    The service provider can receive notifications for merchant authorization cancellations or new authorizations via ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/en/apis/opendelivery/authentication/receiveauthorizationwebhook"},"children":[" Webhook "]},". Keeta will also send an email to the merchant operation mailbox, please check the inbox.\n  "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\n    Or, the service provider can also view all the authorized stores in the Mapping Check in Dev Portal with detailed infomation, as mentioned above.\n  "]}]},"headings":[{"value":"Merchant Authorization","id":"merchant-authorization","depth":1},{"value":"Merchant Adding Authorization (with APP ID)","id":"merchant-adding-authorization-with-app-id","depth":2},{"value":"Merchant Adding Authorization (via URL)","id":"merchant-adding-authorization-via-url","depth":2},{"value":"Merchant Revokeing Authorization","id":"merchant-revokeing-authorization","depth":3},{"value":"Stay updated of merchants authorization activity","id":"stay-updated-of-merchants-authorization-activity","depth":3}],"frontmatter":{"slug":"/apis/opendelivery/merchant-authorization","seo":{"title":"Merchant Authorization"}},"lastModified":"2026-11-12T19:24:24.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en/apis/opendelivery/merchant-authorization","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}