# Endpoints

Request APIs - All endpoints for requesting order information and making updates

## Query on Order Details

 - [POST /order/get](https://api-docs.mykeeta.com/apis/standard/order/endpoints/getorderdetails.md): This endpoint allows the third party system to retrieve comprehensive details about a specific order from Keeta platform.

## Order Confirmation

 - [POST /order/confirm](https://api-docs.mykeeta.com/apis/standard/order/endpoints/confirmorder.md): This endpoint allows the third party to inform the Keeta ordering application that an order has been accepted and food preparation will begin shortly.


1.  
 - Developers must call this endpoint immediately upon receiving new order notifications from Keeta. 
 - The Keeta platform will automatically cancel any order that remains unconfirmed after 5 minutes.
2. 
 - The endpoint rejects requests under these conditions:
 - The order was already accepted through a Keeta POS terminal - The order status has already progressed beyond the initial state


## Order Cancellation

 - [POST /order/cancel](https://api-docs.mykeeta.com/apis/standard/order/endpoints/cancelorder.md): This endpoint allows merchants to request order cancellation through the Keeta platform when they are unable to fulfill a customer's order.


1. The developers should only invoke this API when the merchant is 
2. Upon successful cancellation, the order status will be updated to  in Keeta's system and Keeta will  to the customer.
3. This API . If the order is already in a  state, the system will return an error response.
4. Merchants should  before proceeding to avoid unnecessary losses.


## Refund Confirmation

 - [POST /order/agree](https://api-docs.mykeeta.com/apis/standard/order/endpoints/agreerefund.md): This endpoint allows merchants to programmatically approve customer refund requests that were initiated through the Keeta platform.


1. When a customer submits a refund request on the Keeta platform, the system will send a webhook notification to the third-party system.
2. If the third-party system supports refund management, merchants can review and approve refund requests directly within their system.
3. Once approved, the third-party system  to confirm the refund with Keeta.
4. This API . If the refund has already been approved or rejected (e.g., via Keeta POS), subsequent calls will return an error.


## Refund Rejection

 - [POST /order/reject](https://api-docs.mykeeta.com/apis/standard/order/endpoints/rejectrefund.md): This endpoint enables merchant to formally reject customer refund requests initiated through the Keeta platform.


1. When a customer submits a refund request on the Keeta platform, the system will send a  to the third-party system.
2. If the third-party system has implemented refund processing capabilities, merchants can review and evaluate customer refund requests directly within their own system endpoint.
3. When merchants decide to reject a refund request after careful consideration, the third-party system must explicitly call this rejection API endpoint to formally communicate the decision to Keeta's platform.
4. This API . If the refund has already been approved or rejected (e.g., via Keeta POS), subsequent calls will return an error.


## Order Ready

 - [POST /order/prepare](https://api-docs.mykeeta.com/apis/standard/order/endpoints/orderready.md): This endpoint allows merchant to notify the Keeta platform that an order has been fully prepared and is ready for rider pickup.


1. Keeta strongly recommends that developers integrate this API to significantly enhance delivery efficiency.
2. Calling this endpoint automatically updates the order status to '' in Keeta's system.
3. This API .
4. It is crucial to call this API only after meal preparation is fully completed to avoid disrupting the delivery workflow. Premature or mistaken invocations could lead to delivery inefficiencies and negatively affect the overall customer experience.


## Partial Refundable Item Query

 - [POST /order/refund/part/products/preview](https://api-docs.mykeeta.com/apis/standard/order/endpoints/querypartialrefundableitems.md): This API is designed to retrieve detailed information about items that are eligible for partial refunds. It allows developers to access and display specific product details related to refund eligibility.

## Initiate a Partial Refund

 - [POST /order/refund/part/apply](https://api-docs.mykeeta.com/apis/standard/order/endpoints/initiatepartialrefund.md): This API allows merchants to submit requests for partial refunds on specific products within an order. It is designed to adjust billing and chargeback processes when certain items in an order will not incur costs due to various reasons, such as promotions, errors, or customer satisfaction measures.

## Order Picked-up Confirmation

 - [POST /order/collect](https://api-docs.mykeeta.com/apis/standard/order/endpoints/confirmorderpickup.md): This API is designed to notify the Keeta platform that a customer has personally collected their order. It ensures that the system accurately reflects the order's completion through customer self-pickup.


This API should be invoked in situations where the customer opts for self-service pickup, collecting their order directly from the merchant premises. It updates Keeta's system with the order's completed status.