{"templateId":"markdown","versions":[{"version":"opendelivery","label":"Open Delivery API","link":"/en/apis/docs/general-info","default":true,"active":true,"folderId":"62a846bf"},{"version":"standard","label":"Standard Keeta API","link":"/en/apis/standard/docs/general-info","default":false,"active":false,"folderId":"62a846bf"},{"version":"grocery","label":"Grocery Keeta API","link":"/en/apis/grocery/docs/general-info","default":false,"active":false,"folderId":"62a846bf"}],"sharedDataIds":{"sidebar":"sidebar-@l10n/en/apis/@opendelivery/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"General Info"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"general-info","__idx":0},"children":["General Info"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Special Note:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keeta Open Delivery API is based on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Open Delivery v1.5.0"]},". For basic understanding, please refer to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://abrasel-nacional.github.io/docs/","target":"_blank"},"children":["Open Delivery API"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For some of the APIs, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keeta has made some adjustments based on business scenarios"]},". Therefore, when Software Service integrates with Keeta, please refer to the APIs definitions in this document."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The major changes include:"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authentication: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The credentials have been changed from the merchant level to the software level, and the token as well."]}," However, software services cannot access the merchant data without the merchant's authorization first."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Signature: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keeta requires the Software Service to include a signature in the header of every API request."]}," This is to enhance security and prevent the risk of data leakage due to token exposure (such as man-in-the-middle attacks).Please refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/en/apis/opendelivery/signature-calculation"},"children":[" detailed documentation for the specific signing requirements."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Merchant Menu: Keeta supports menu push (software services push via POST /merchantUpdate endpoint) and pull (Keeta pulls via GET /merchant endpoint); however, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keeta currently only supports full menu updates (modular entry updates are not supported at this time)"]},". For details, please refer to the description of the corresponding Merchant endpoints in this document."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Order: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keeta supports querying order events of batch merchants in the polling endpoint"]},", since the credential is in the software level."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fields: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keeta has made some adjustments to the fields in each endpoint, including the number of fields, whether the fields are required, etc."]}," Please refer to the definitions in this document."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refund Process: When requesting a total/partial refund after order completion, a negotiation will be initiated between the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer"]}," and the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant"]},". This allows the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant"]}," the opportunity to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACCEPT"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DENY"]}," the Customer's request. For details, refer to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ORDERS"]}," section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User Privacy Data: To protect users' personal privacy, Keeta will return encrypted data in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en/apis/opendelivery/orderapi/orderdetails"},"children":["order details"]},". In scenarios involving ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["merchant self-delivery or third-party logistics (3PL)"]},", this data can be decrypted. If Software Services need to decrypt the data, they must make additional calls to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/en/apis/opendelivery/orderapi/batchdecrypt"},"children":["data decryption endpoint"]},". For details, please refer to the description in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Order section"]}," of this document."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["We strongly recommend software services to integrate the menu API for data synchronization"]},", to avoid merchants maintaining menus in multiple places."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keeta provides a self-service authorization feature in its ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://merchant.mykeeta.com/","target":"_blank","rel":"noopener noreferrer"},"children":[" merchant management system "]},". Merchants can log in to the system to independently authorize or revoke access for Software Services. Detailed instructions are available in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/en/apis/opendelivery/merchant-authorization"},"children":[" the relevant documentation section "]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition, Keeta offers API endpoints that enable Software Services to automate merchant authorization and embed the workflow into their own SaaS software. For implementation details, please refer to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/en/apis/opendelivery/merchant-self-serve-authorization"},"children":[" the relevant documentation section "]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can"," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://s3-fra01-eu.mykeeta.net/open-third-shop-mapping-template/ODA%20Test%20Collection.postman_collection.json.zip","target":"_blank","rel":"noopener noreferrer"},"children":[" Download the Postman Collection "]}," ","and add signature calculation script to the pre-request section in Postman to simplify integration and testing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important"]}," :You need to replace the secret value in the Postman script with the one assigned to you by Keeta."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/postman_replace_client_secret.52dae55708042141ec8cd9027d64fc256c0a74a807eb18798618f0f80bd94dd9.68d109a5.jpg"},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For some general instructions, can directly refer to Open Delivery Documents, and relevant links will be attached."]}]}]}]},"headings":[{"value":"General Info","id":"general-info","depth":1}],"frontmatter":{"slug":"/apis/opendelivery/general-info","seo":{"title":"General Info"}},"lastModified":"2026-11-12T19:24:24.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en/apis/opendelivery/general-info","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}