# Merchant Self-serve Authorization

Before accessing merchant data, service providers must obtain authorization from merchants. Within the Keeta platform, it is recommended to use Merchant Self-Authorization to automate and streamline this process.

Step 1: Retrieve Authorization Link

Initiate Request: The service provider system calls the Keeta API to retrieve the authorization URL.
Note: If API integration is not available, the URL can be manually acquired via the Add Authorization button on the Dev Portal.
Generate Link: Keeta returns an authorization link containing the required parameters.
Distribute Link: The service provider shares the link with the target merchant to begin the authorization flow.

Step 2: Merchant Authorization Operation

Access Authorization Page: The merchant clicks the link, redirecting their browser to the Keeta authorization page.
Authentication: The merchant logs in via Keeta, using either a Brand Account or a Store Account.
Store Selection: The system displays the merchant’s store list.

Brand account users must select the store scope to authorize.
Store account users will proceed without additional selection.

Step 3: Post-Authorization Handling (Two Modes)

Mode A: Redirect Integration (Automated Workflow)

Automatic Redirect: After authorization, Keeta redirects to the service provider system with the authId.
Fetch Store Info: The service provider calls the API to retrieve detailed store information.
Store Mapping UI: The service provider displays a mapping interface for the merchant to match their stores with the service provider’s system.
Integration Complete: Upon confirmation, the service provider registers store data via the onboarding API.

Mode B: Manual Mapping via Authorization Records

Merchant-side Download: After authorization, the Keeta merchant management system automatically downloads a spreadsheet of the authorized stores. Alternatively, merchants may manually download the store list to assist with mapping. To explore detailed functionality and operations, please log in to the merchant portal using a test store account.
Email Notification to Service Provider: Keeta sends the authorized store list to the merchant operations email provided by the service provider for reference and mapping.
View in Dev Portal: Service providers can log into the Dev Portal and use the Mapping Check feature to search for authorized store records and maintain mappings manually.