{"templateId":"markdown","versions":[{"version":"opendelivery","label":"Open Delivery API","link":"/apis/opendelivery/docs/orderintegrationguide","default":true,"active":false,"folderId":"58c9a61d"},{"version":"standard","label":"Standard Keeta API","link":"/apis/standard/docs/orderintegrationguide","default":false,"active":false,"folderId":"58c9a61d"},{"version":"grocery","label":"Grocery Keeta API","link":"/apis/grocery/docs/orderintegrationguide","default":false,"active":true,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@grocery/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Order API Integration Guide","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"order-api-integration-guide","__idx":0},"children":["Order API Integration Guide"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-overview","__idx":1},"children":["1. Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Developers can receive and manage orders from Keeta after Order API integration. The API comprises two categories:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhook"]},": For receiving order notifications from Keeta"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Order API"]},": For updating order statuses"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"11-order-webhooks","__idx":2},"children":["1.1 Order Webhooks"]},{"$$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":"eventId"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["eventId"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Event Description"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Event Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1001"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order Placement Notification"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1002"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order Acceptance Notification"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1003"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order Completion Notification"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1004"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order Cancellation Notification"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1005"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refund Initiation Notification"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1006"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delivery Status Update Notification"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1007"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Partial Refund Initiation Notification"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"12-order-apis","__idx":3},"children":["1.2 Order APIs"]},{"$$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":"Endpoint"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Functionality"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Functionality"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/api/open/order/confirm"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Confirm order"]}," (This endpoint is for the merchants to inform the Keeta that an order has been accepted.)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/api/open/order/get"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retrieve order details"]}," (Obtains extended order information)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/api/open/order/prepare"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Confirm meal readiness"]}," (Merchant marks order as prepared. ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Critical: Failure to accept orders impacts store EAT metrics"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/api/open/order/cancel"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cancel order"]}," (The endpoint allows a merchant to terminate the entire transaction chain. Please be cautious when calling this endpoint to prevent unintended financial losses.)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/api/open/order/agree"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant approval of user-initiated refund"]}," (Confirms acceptance of customer's refund request)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/api/open/order/reject"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant rejection of user-initiated refund"]}," (Rejects customer's refund request)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/api/open/order/collect"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant confirmation of customer pickup"]}," (Exclusively for pickup orders; marks order as received by customer)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/api/open/order/refund/part/products/preview"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant preview of partially refundable items"]}," (Queries product eligibility and amounts for partial refunds)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["/api/open/order/refund/part/apply"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant-initiated partial refund processing"]}," (Executes refund for specific items in an order)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more details, please refer to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/grocery/order"},"children":["Order API Reference"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Core API Capabilities"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Receive Keeta order notifications"]},":",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["New order alerts"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Order completion confirmations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Order cancellation notices"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User-initiated refund requests"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Update order statuses"]},":",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Order acceptance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Meal preparation completion"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Customer pickup confirmation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Order cancellation"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Orders are categorized into ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["forward transactions"]}," (standard fulfillment flow) and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["reverse transactions"]}," (refund/cancellation flow). Please refer to the workflow diagram for detailed sequence logic."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-keeta-order-workflow","__idx":4},"children":["2. Keeta Order Workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keeta's order processing comprises two workflows:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Forward Transaction"]},": The complete process from order placement to fulfillment, without refunds or cancellations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reverse Transaction"]},": The inverse process handling refunds and cancellations."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"21-forward-transaction-standard-fulfillment-flow","__idx":5},"children":["2.1 Forward Transaction (standard fulfillment flow)"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"211-forward-transaction-of-delivery","__idx":6},"children":["2.1.1 Forward Transaction of delivery"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Forward Transaction Workflow Description"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Order Creation & Notification"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When an order is successfully placed on Keeta's platform, regardless of the payment method (online payment or cash on delivery):"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The system instantly generates the order"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pushes a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New Order Notification"]}," (Webhook Event 1001) to developers, it includes order details, merchant settlement information"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Decision-Making"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Upon receiving the new order notification, merchants evaluate:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inventory status"]},": Confirm sufficient ingredients/products"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Operating status"]},": Verify current business hours and order acceptance capacity"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Order load"]},": Assess real-time processing capability"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Based on evaluation results, merchants may:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accept order"]},": Via /api/open/order/confirm"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reject order"]},": Via /api/open/order/cancel"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parallel Processing Post-Acceptance"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After order acceptance, two parallel workflows initiate:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Workflow"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Begins meal preparation"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Platform Workflow"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keeta automatically dispatches riders"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Matching criteria: order location, delivery distance"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Meal Readiness Reporting & Rider Dispatch"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When meal preparation completes:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Developer calls /api/open/order/prepare"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["System notifies rider for store pickup"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Real-Time Delivery Status Updates"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keeta pushes ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delivery Status Updates"]}," (Webhook Event 1006) during transit:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Rider order acceptance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Rider arrival at store"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Rider meal retrieval"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Order delivery completion"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Order Completion"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["After the rider successfully delivers the meal to the customer"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The order status is updated to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Completed"]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Forward Transaction"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n\n A((Start)) --> B[User Places Order]\n\n B --> C[Push New Order]\n\n C --> D{Push Success?}\n\n \n\n D -->|No| E[Repush]\n\n E --> |No response within 5 minutes|F[Timeout Cancell]\n\n F --> K((End))\n\n \n\n D -->|Yes| G[Merchant Confirms Order]\n\n G --> H[Food Ready]\n\n H --> I[Rider Arrives at Store]\n\n I --> J[Rider Picks Up Food]\n\n J --> L[User Receives Food]\n\n L --> K\n","diagramHtml":"

No

No response within 5 minutes

Yes

Start

User Places Order

Push New Order

Push Success?

Repush

Timeout Cancell

End

Merchant Confirms Order

Food Ready

Rider Arrives at Store

Rider Picks Up Food

User Receives Food

","diagramHtmlDark":"

No

No response within 5 minutes

Yes

Start

User Places Order

Push New Order

Push Success?

Repush

Timeout Cancell

End

Merchant Confirms Order

Food Ready

Rider Arrives at Store

Rider Picks Up Food

User Receives Food

"},"children":["flowchart TD\n\n A((Start)) --> B[User Places Order]\n\n B --> C[Push New Order]\n\n C --> D{Push Success?}\n\n \n\n D -->|No| E[Repush]\n\n E --> |No response within 5 minutes|F[Timeout Cancell]\n\n F --> K((End))\n\n \n\n D -->|Yes| G[Merchant Confirms Order]\n\n G --> H[Food Ready]\n\n H --> I[Rider Arrives at Store]\n\n I --> J[Rider Picks Up Food]\n\n J --> L[User Receives Food]\n\n L --> K\n"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"212-pickup-order-forward-transaction","__idx":7},"children":["2.1.2 Pickup Order Forward Transaction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pickup Order"]}," is an alternative fulfillment mode offered by Keeta, allowing customers to collect meals directly at stores without delivery service. The workflow resembles standard orders but excludes rider delivery. The order completes upon ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer Pickup"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pickup Workflow Description"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pickup Order Creation & Notification"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Identical to standard ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Order Placement"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Triggers ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New Order Push"]}," (Webhook 1001) upon payment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the webhook message is not processed correctly, Keeta will perform a push retry. The system will retry up to three times with one-minute intervals. For details, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/grocery/docs/webhook"},"children":["Webhook"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Decision-Making"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Same process as standard orders, it requires evaluation based on inventory/operating status"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Acceptance"]}," via /api/open/order/confirm"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Order rejection via /api/open/order/cancel"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Post-Acceptance Processing"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Single merchant-focused workflow"]},":"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Merchant begins meal preparation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Platform skips rider dispatch"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Meal Readiness Confirmation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Meal Preparation Complete"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call /api/open/order/prepare"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["System notifies customer for collection"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer Pickup"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Upon customer arrival"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Optional"]},": Call /api/open/order/collect to confirm ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer Pickup"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["System auto-completes order after preset timeout if not called"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Order Completion"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["After successful Customer Pickup"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Order status updates to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Completed"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Triggers Webhook 1003"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customer Pickup Workflow"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n\n A((Start)) --> B[User Places Order]\n\n B --> C[Push New Order]\n\n C --> D{Push Success?}\n\n \n\n D -->|No| E[Repush]\n\n E --> |No response within 5 minutes|F[Timeout Cancel]\n\n F --> I((End))\n\n \n\n D -->|Yes| G[Merchant Confirms Order]\n\n G --> H[Food Ready]\n\n H --> J[Merchant Confirms User Pickup]\n\n J --> I\n\n \n\n %% Retry logic\n\n E -.Retry 3 times.-> D\n\n \n\n %% API identifiers\n\n M[Push API]\n\n N[Request API]\n\n \n\n %% Style definitions\n\n classDef white fill:#ffffff,stroke:#333,stroke-width:1px\n\n classDef orange fill:#ffd8a8,stroke:#333,stroke-width:1px\n\n classDef blue fill:#b3d9ff,stroke:#333,stroke-width:1px\n\n \n\n %% Apply styles\n\n class A,B,D,E,I white\n\n class C,F,M orange\n\n class G,H,J,N blue\n","diagramHtml":"

No

No response within 5 minutes

Yes

Retry 3 times

Start

User Places Order

Push New Order

Push Success?

Repush

Timeout Cancel

End

Merchant Confirms Order

Food Ready

Merchant Confirms User Pickup

Push API

Request API

","diagramHtmlDark":"

No

No response within 5 minutes

Yes

Retry 3 times

Start

User Places Order

Push New Order

Push Success?

Repush

Timeout Cancel

End

Merchant Confirms Order

Food Ready

Merchant Confirms User Pickup

Push API

Request API

"},"children":["flowchart TD\n\n A((Start)) --> B[User Places Order]\n\n B --> C[Push New Order]\n\n C --> D{Push Success?}\n\n \n\n D -->|No| E[Repush]\n\n E --> |No response within 5 minutes|F[Timeout Cancel]\n\n F --> I((End))\n\n \n\n D -->|Yes| G[Merchant Confirms Order]\n\n G --> H[Food Ready]\n\n H --> J[Merchant Confirms User Pickup]\n\n J --> I\n\n \n\n %% Retry logic\n\n E -.Retry 3 times.-> D\n\n \n\n %% API identifiers\n\n M[Push API]\n\n N[Request API]\n\n \n\n %% Style definitions\n\n classDef white fill:#ffffff,stroke:#333,stroke-width:1px\n\n classDef orange fill:#ffd8a8,stroke:#333,stroke-width:1px\n\n classDef blue fill:#b3d9ff,stroke:#333,stroke-width:1px\n\n \n\n %% Apply styles\n\n class A,B,D,E,I white\n\n class C,F,M orange\n\n class G,H,J,N blue\n"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"22-reverse-transaction-workflow","__idx":8},"children":["2.2 Reverse Transaction Workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keeta allows order cancellation by ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["users, customer service, merchants, and the platform"]},". Below demonstrates merchant and user cancellation scenarios:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"221-merchant-initiated-order-cancellation-full-refund","__idx":9},"children":["2.2.1 Merchant-Initiated Order Cancellation (Full Refund)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keeta allows merchants to cancel orders at any stage. Since order cancellation is a high-impact operation, developers should implement additional exception handling and verification mechanisms to ensure system stability and prevent accidental cancellations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Key endpoint for developers: /api/open/order/cancel (Merchant-initiated order cancellation)"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"222-merchant-initiated-partial-refund","__idx":10},"children":["2.2.2 Merchant-Initiated Partial Refund"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["During meal preparation, merchants may encounter missing items or spillage issues. To protect both user and merchant interests, merchants can initiate partial refunds for affected items. This ensures user compensation while preserving the main transaction."]},{"$$mdtype":"Tag","name":"div","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Merchant-Initiated Partial Refund Workflow"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n\n A((Start)) --> B[User Payment]\n\n B --> C{Merchant Accepts Order?}\n\n C -->|Yes| D[Merchant Prepares Food]\n\n D -->|Item Out of Stock| E[Merchant Initiates Partial Refund]\n\n E --> F[Partial Food Ready]\n\n F --> G[Rider Arrives at Store]\n\n G --> H[Rider Picks Up Food]\n\n H --> I[User Receives Food]\n\n I --> J((End))\n\n \n\n %% API identifiers\n\n K[Push API]\n\n L[Request API]\n\n \n\n %% Style definitions\n\n classDef white fill:#ffffff,stroke:#333,stroke-width:1px\n\n classDef orange fill:#ffd8a8,stroke:#333,stroke-width:1px\n\n classDef blue fill:#b3d9ff,stroke:#333,stroke-width:1px\n\n \n\n %% Apply styles\n\n class A,B,C,D,J white\n\n class E,F,L blue\n\n class G,H,I,K orange\n","diagramHtml":"

Yes

Item Out of Stock

Start

User Payment

Merchant Accepts Order?

Merchant Prepares Food

Merchant Initiates Partial Refund

Partial Food Ready

Rider Arrives at Store

Rider Picks Up Food

User Receives Food

End

Push API

Request API

","diagramHtmlDark":"

Yes

Item Out of Stock

Start

User Payment

Merchant Accepts Order?

Merchant Prepares Food

Merchant Initiates Partial Refund

Partial Food Ready

Rider Arrives at Store

Rider Picks Up Food

User Receives Food

End

Push API

Request API

"},"children":["flowchart TD\n\n A((Start)) --> B[User Payment]\n\n B --> C{Merchant Accepts Order?}\n\n C -->|Yes| D[Merchant Prepares Food]\n\n D -->|Item Out of Stock| E[Merchant Initiates Partial Refund]\n\n E --> F[Partial Food Ready]\n\n F --> G[Rider Arrives at Store]\n\n G --> H[Rider Picks Up Food]\n\n H --> I[User Receives Food]\n\n I --> J((End))\n\n \n\n %% API identifiers\n\n K[Push API]\n\n L[Request API]\n\n \n\n %% Style definitions\n\n classDef white fill:#ffffff,stroke:#333,stroke-width:1px\n\n classDef orange fill:#ffd8a8,stroke:#333,stroke-width:1px\n\n classDef blue fill:#b3d9ff,stroke:#333,stroke-width:1px\n\n \n\n %% Apply styles\n\n class A,B,C,D,J white\n\n class E,F,L blue\n\n class G,H,I,K orange\n"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The partial refund workflow involves three sequential steps:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Query Refundable Items"]}," ","Call /api/open/order/refund/part/products/preview to retrieve refund-eligible products"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select Products"]}," ","Merchant chooses specific products for refund from the query results"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Execute Refund"]}," ","Call /api/open/order/refund/part/apply to complete the partial refund operation"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"223-user-refund-full-refund","__idx":11},"children":["2.2.3 User Refund (Full Refund)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pre-Merchant Acceptance"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Users may cancel orders ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["directly without merchant approval"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Post-Merchant Acceptance"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Order cancellation requires ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["merchant approval"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Refund Eligibility Windows"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Users may request refunds at multiple stages, including after order placement, during delivery, after receiving meals"]},{"$$mdtype":"Tag","name":"div","attributes":{"style":{"backgroundColor":"#f8f9fa","padding":"15px","borderRadius":"8px"}},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ℹ️ Common Refund Scenarios"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"style":{"marginLeft":"20px"}},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Subjective Reasons"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User changes mind (no longer wants order)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Excessive wait time prompts alternative dining"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Incorrect restaurant/dish selection"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Product Quality Issues"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Spoiled/contaminated food upon delivery"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Undercooked or improperly prepared meals"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Damaged packaging or spillage"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Order Accuracy Issues"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Received items differ from order (missing items/incorrect dishes)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Incorrect specifications (e.g., spice level)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delivery Problems"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Late delivery affecting meal plans"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wrong delivery address or unreachable rider"]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution Path:"]}," Merchants/platforms handle refunds based on actual circumstances."]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["User-initiated Refund Workflow"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n\n A((Start)) --> B[User Cancellation]\n\n B --> C{Has Merchant Accepted Order?}\n\n \n\n C -->|No| I[Cancel Order]\n\n C -->|Yes| D[Push a Refund Request Message]\n\n \n\n D --> E[No response within 15 minutes]\n\n D --> F{Does Merchant Agree?}\n\n \n\n E --> I\n\n F -->|Yes| I\n\n F -->|No| G[Merchant Rejection Synced to user app]\n\n \n\n G --> H[No more appeals from user]\n\n G --> J[Customer Requests Customer Service Intervention]\n\n \n\n J --> K[Platform Makes Decision]\n\n \n\n I --> L((End))\n\n H --> L\n\n K --> L\n\n \n\n %% API identifiers\n\n M[Push API]\n\n N[Request API]\n\n \n\n %% Style definitions\n\n classDef white fill:#ffffff,stroke:#333,stroke-width:1px\n\n classDef orange fill:#ffd8a8,stroke:#333,stroke-width:1px\n\n classDef blue fill:#b3d9ff,stroke:#333,stroke-width:1px\n\n \n\n %% Apply styles\n\n class A,B,C,G,H,L,K,J,E white\n\n class D,I,M orange\n\n class F,N blue\n","diagramHtml":"

No

Yes

Yes

No

Start

User Cancellation

Has Merchant Accepted Order?

Cancel Order

Push a Refund Request Message

No response within 15 minutes

Does Merchant Agree?

Merchant Rejection Synced to user app

No more appeals from user

Customer Requests Customer Service Intervention

Platform Makes Decision

End

Push API

Request API

","diagramHtmlDark":"

No

Yes

Yes

No

Start

User Cancellation

Has Merchant Accepted Order?

Cancel Order

Push a Refund Request Message

No response within 15 minutes

Does Merchant Agree?

Merchant Rejection Synced to user app

No more appeals from user

Customer Requests Customer Service Intervention

Platform Makes Decision

End

Push API

Request API

"},"children":["flowchart TD\n\n A((Start)) --> B[User Cancellation]\n\n B --> C{Has Merchant Accepted Order?}\n\n \n\n C -->|No| I[Cancel Order]\n\n C -->|Yes| D[Push a Refund Request Message]\n\n \n\n D --> E[No response within 15 minutes]\n\n D --> F{Does Merchant Agree?}\n\n \n\n E --> I\n\n F -->|Yes| I\n\n F -->|No| G[Merchant Rejection Synced to user app]\n\n \n\n G --> H[No more appeals from user]\n\n G --> J[Customer Requests Customer Service Intervention]\n\n \n\n J --> K[Platform Makes Decision]\n\n \n\n I --> L((End))\n\n H --> L\n\n K --> L\n\n \n\n %% API identifiers\n\n M[Push API]\n\n N[Request API]\n\n \n\n %% Style definitions\n\n classDef white fill:#ffffff,stroke:#333,stroke-width:1px\n\n classDef orange fill:#ffd8a8,stroke:#333,stroke-width:1px\n\n classDef blue fill:#b3d9ff,stroke:#333,stroke-width:1px\n\n \n\n %% Apply styles\n\n class A,B,C,G,H,L,K,J,E white\n\n class D,I,M orange\n\n class F,N blue\n"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Refund Handling Process"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Upon receiving a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User-initiated Refund"]}," request via Webhook Event 1005, merchants process it based on actual circumstances by either approving or rejecting. If the user disputes the merchant's decision, customer service handles secondary resolution."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Common Processing Scenarios:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant approves refund request"]},": Call /api/open/order/agree"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant rejects refund request"]},": Call /api/open/order/reject"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer service approves refund"]},": Result delivered via Webhook Event 1005"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer service rejects refund"]},": Result delivered via Webhook Event 1005"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Different refund reasons and handling methods yield varied outcomes, requiring system flexibility to manage diverse refund scenarios."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"224-user-initiated-partial-refund","__idx":12},"children":["2.2.4 User-Initiated Partial Refund"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Partial Refund"]},": Keeta allows users to request refunds for specific items within an order, providing more flexible resolution options."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In real business context, when only full refunds are available for partially problematic orders:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Impact on Merchants"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Non-issue items get refunded unnecessarily"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Damages merchant profitability and platform partnership willingness"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Impact on Users"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refund process obstructed by merchant objections"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Extended resolution cycles degrade user experience"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Value of Partial Refunds"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Partial refund balances user needs with merchant protection by:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Resolving specific issues promptly"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Preventing excessive merchant losses"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensuring smoother refund processing"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"align":"center"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["User-Initiated Partial Refund Workflow"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n\n A((Start)) --> B[User Cancellation]\n\n B --> C{Has Merchant Accepted Order?}\n\n \n\n C -->|No| I[Cancel Order]\n\n C -->|Yes| D[Push a Partial Refund Request Message]\n\n \n\n D --> E[No response within 15 minutes]\n\n D --> F{Does Merchant Agree?}\n\n \n\n E --> I\n\n F -->|Yes| I\n\n F -->|No| G[Merchant Rejection Synced to user app]\n\n \n\n G --> H[No more appeals from user]\n\n G --> J[Customer Requests Customer Service Intervention]\n\n \n\n J --> K[Platform Makes Decision]\n\n \n\n I --> L((End))\n\n H --> L\n\n K --> L\n\n \n\n %% API identifiers\n\n M[Push API]\n\n N[Request API]\n\n \n\n %% Style definitions\n\n classDef white fill:#ffffff,stroke:#333,stroke-width:1px\n\n classDef orange fill:#ffd8a8,stroke:#333,stroke-width:1px\n\n classDef blue fill:#b3d9ff,stroke:#333,stroke-width:1px\n\n \n\n %% Apply styles\n\n class A,B,C,G,H,L,K,J,E white\n\n class D,I,M orange\n\n class F,N blue\n","diagramHtml":"

No

Yes

Yes

No

Start

User Cancellation

Has Merchant Accepted Order?

Cancel Order

Push a Partial Refund Request Message

No response within 15 minutes

Does Merchant Agree?

Merchant Rejection Synced to user app

No more appeals from user

Customer Requests Customer Service Intervention

Platform Makes Decision

End

Push API

Request API

","diagramHtmlDark":"

No

Yes

Yes

No

Start

User Cancellation

Has Merchant Accepted Order?

Cancel Order

Push a Partial Refund Request Message

No response within 15 minutes

Does Merchant Agree?

Merchant Rejection Synced to user app

No more appeals from user

Customer Requests Customer Service Intervention

Platform Makes Decision

End

Push API

Request API

"},"children":["flowchart TD\n\n A((Start)) --> B[User Cancellation]\n\n B --> C{Has Merchant Accepted Order?}\n\n \n\n C -->|No| I[Cancel Order]\n\n C -->|Yes| D[Push a Partial Refund Request Message]\n\n \n\n D --> E[No response within 15 minutes]\n\n D --> F{Does Merchant Agree?}\n\n \n\n E --> I\n\n F -->|Yes| I\n\n F -->|No| G[Merchant Rejection Synced to user app]\n\n \n\n G --> H[No more appeals from user]\n\n G --> J[Customer Requests Customer Service Intervention]\n\n \n\n J --> K[Platform Makes Decision]\n\n \n\n I --> L((End))\n\n H --> L\n\n K --> L\n\n \n\n %% API identifiers\n\n M[Push API]\n\n N[Request API]\n\n \n\n %% Style definitions\n\n classDef white fill:#ffffff,stroke:#333,stroke-width:1px\n\n classDef orange fill:#ffd8a8,stroke:#333,stroke-width:1px\n\n classDef blue fill:#b3d9ff,stroke:#333,stroke-width:1px\n\n \n\n %% Apply styles\n\n class A,B,C,G,H,L,K,J,E white\n\n class D,I,M orange\n\n class F,N blue\n"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Upon receiving a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User-initiated Partial Refund"]}," request via Webhook Event 1007, merchants process it by approving or rejecting based on actual circumstances. If the user disputes the decision, customer service handles secondary resolution."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processing Scenarios:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant approves partial refund"]},": Call /api/open/order/agree"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant rejects partial refund"]},": Call /api/open/order/reject"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer service approves"]},": Result delivered via Webhook Event 1007"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer service rejects"]},": Result delivered via Webhook Event 1007"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Different refund reasons and handling methods yield varied outcomes, requiring system flexibility to manage diverse refund scenarios."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"225-keeta-or-customer-service-initiated-order-cancellation","__idx":13},"children":["2.2.5 Keeta or Customer Service Initiated Order Cancellation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For cancellations initiated by ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Keeta platform or customer service"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Developers need ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["no additional processing"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Please just synchronize cancellation notifications to their systems"]}]}]},"headings":[{"value":"Order API Integration Guide","id":"order-api-integration-guide","depth":1},{"value":"1. Overview","id":"1-overview","depth":2},{"value":"1.1 Order Webhooks","id":"11-order-webhooks","depth":3},{"value":"1.2 Order APIs","id":"12-order-apis","depth":3},{"value":"2. Keeta Order Workflow","id":"2-keeta-order-workflow","depth":2},{"value":"2.1 Forward Transaction (standard fulfillment flow)","id":"21-forward-transaction-standard-fulfillment-flow","depth":3},{"value":"2.1.1 Forward Transaction of delivery","id":"211-forward-transaction-of-delivery","depth":4},{"value":"2.1.2 Pickup Order Forward Transaction","id":"212-pickup-order-forward-transaction","depth":4},{"value":"2.2 Reverse Transaction Workflow","id":"22-reverse-transaction-workflow","depth":3},{"value":"2.2.1 Merchant-Initiated Order Cancellation (Full Refund)","id":"221-merchant-initiated-order-cancellation-full-refund","depth":4},{"value":"2.2.2 Merchant-Initiated Partial Refund","id":"222-merchant-initiated-partial-refund","depth":4},{"value":"2.2.3 User Refund (Full Refund)","id":"223-user-refund-full-refund","depth":4},{"value":"2.2.4 User-Initiated Partial Refund","id":"224-user-initiated-partial-refund","depth":4},{"value":"2.2.5 Keeta or Customer Service Initiated Order Cancellation","id":"225-keeta-or-customer-service-initiated-order-cancellation","depth":4}],"frontmatter":{"seo":{"title":"Order API Integration Guide"}},"lastModified":"2026-07-15T11:32:09.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/grocery/docs/orderintegrationguide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}