---
title: API Documentation
tags: API Documentation
description: API Documentation
---

<div style="text-align: center; font-size: 35px">
MGCC Portal API Documentation
</div>
---
# Copyright Information
**Maxs Group Inc - IT Application Development**<br>
3rd Floor KDC Plaza Building<br>
Chino Roces Avenue. Makati City, 1231<br>
Email: appdev@maxsgroupinc.com
---
# Confidentiality and Usage
<div style="text-align: justify">The information contained in this document (and any attachments) is a confidential information provided
by MGI IT - Application Development. This document is intended only for use by merchants approved by MGI.<br><br>
Any copying, distribution or dissemination of this document by any other parties is prohibited.</div>
---
# Revision History
| Revision | Date | Revision Description |
| -------- | --------------- | -------------------- |
| 0.0 | August 11, 2021 | Final Draft Issue |
| 0.1 | November 2, 2021| Data Dictionary |
| 1.0 | September 1, 2022| Data flow|
---
<!--
# API Documentation
- <span style="color:red">API Key provided in email</span> -->
# API
## RTA Map API
### Store Assignment
<p>This API is used to check store assignment.</p>
For brand list definition
> See full list [here](https://hackmd.io/pa3z7pZmQDmbjYKBBC-IXQ?view#Data-Parameter-Definitions).
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/check-store-cater
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/check-store-cater
---
| **FUNCTION** | Check store assignment |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>}|
| **DATA PARAMS** | ```{```<br> ```lat:"",``` <br> ```lng:"",```<br> ```brand_id:""```<br>```}``` |
| **DATA DEFINITION** | {} |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message":"",```<br> ```"data":{```<br> ```store_code: "",```<br> ```store_name:"",```<br> ```promise_time:"",```<br> ```pricelist_id:"",```<br> ```minimum_delivery:"",```<br> ```alternate_store:""```<br> ```}```<br> ```}``` |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"“No store available." ,```<br> ```"data":{}```<br>```}``` |
### Store Check Status
<p>This API is used to check the store status.</p>
For brand list definition
> See full list [here](https://hackmd.io/pa3z7pZmQDmbjYKBBC-IXQ?view#Data-Parameter-Definitions).
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/check-store-status
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/check-store-status
---
| **FUNCTION** | Check store status |
| -------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | ```{```<br> ```store_code:"",``` <br> ```transaction_date_time:"",```<br> <br>```}``` |
| **DATA DEFINITION** | {} |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message": "Store available to send order.",```<br> ``` "data":{} ```<br> ```}``` |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Store closed/peak." ,```<br> ```"data":{}```<br>```}``` |
---
### Menu Products
<p>This API is used to check the store status.</p>
For brand list and transaction type definitions
> See full list [here](https://hackmd.io/pa3z7pZmQDmbjYKBBC-IXQ?view#Data-Parameter-Definitions).
For menu exploration use 1 as default transaction_id and pricelist_id.
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/menu-products
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/menu-products
---
| **FUNCTION** | Menu Products |
| -------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | ```{```<br> ```brand_id:"",``` <br> ```pricelist_id:"",```<br> ```transaction_id:"",```<br> ```transaction_date:""```<br>```}``` |
| **DATA DEFINITION** | {} |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message": "Menu Product",```<br> ``` "Menu":{Product: {"product_id, :"",product_name: "", product_description : "", product_image: "", catetgory_id: "", category_name:"", brand_id: "",sort: "", leadtime:"", price:"" }, option: {option_id : "", option_type: "", option_typeid: "", option_image: "",sort:"",brand_id:""}} ```<br> ```}``` |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Error" ,```<br> ```"data":{}```<br>```}``` |
---
## Store Details API
<p>This API is to get store details by brand.</p>
For brand list definition
> See full list [here](https://hackmd.io/pa3z7pZmQDmbjYKBBC-IXQ?view#Data-Parameter-Definitions).
>
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/store-list
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/store-list
| **FUNCTION** | Get store details |
| -------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} | |
| **DATA PARAMS** | ```{```<br> ```brand_id:""```<br>```}``` | |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message":"",```<br> ```"data":{```<br> ```"brand_name": "",```<br> ```"store_name":"",```<br> ```"start_time":"",```<br> ```"end_time":"",```<br> ```"store_contact_num":"",```<br> ```"store_ops":""```<br> ```}```<br> ```}``` | |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"No store details found." ,```<br> ```"data":{}```<br>```}``` | |
---
## Registration API
<p>This API is used for customer registration.</p>
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/customer-registration
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/customer-registration
---
| **FUNCTION** | Customer registration |
| -------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | ```{```<br> ```customer_firstname:"",``` <br> ```customer_middlename:"",```<br> ```customer_lastname:"",```<br> ```customer_country:"",```<br> ```customer_houseno:"",```<br> ```customer_street:"",```<br> ```customer_district:"",```<br> ```customer_city:"",```<br> ```customer_province:"",```<br> ```customer_postcode:"",```<br> ```customer_contact_no:"",```<br> ```date_of_birth:"",```<br> ```customer_email_address:"",```<br> ```customer_password:"",```<br> ```customer_source:"",```<br> ```created_by:"",```<br> ```customer_mobile_no:"",```<br> ```scv_id:"",```<br>```}``` |
| **DATA DEFINITION** | Password Encryption: md5 |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message": "Successfully Registered.",```<br> ``` "data":{```<br> ```customer_id:""```<br> ```}``` <br>```}```
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Failed, already registered" ,```<br> ```"data:{```<br> ```customer_firstname:"",``` <br> ```customer_middlename:"",```<br> ```customer_lastname:"",```<br> ```customer_country:"",```<br> ```customer_houseno:"",```<br> ```customer_street:"",```<br> ```customer_district:"",```<br> ```customer_city:"",```<br> ```customer_province:"",```<br> ```customer_postcode:"",```<br> ```customer_contact_no:"",```<br> ```customer_email_address:"",```<br> ```created_by:"",```<br> ```customer_mobile_no:"",```<br> ```scv_id:"",```<br> ```}```<br>```}``` |
## Login API
<p>This API is used for customer login.</p>
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/customer-login
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/customer-login
---
| **FUNCTION** | Customer Login |
| -------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | ```{```<br> ```email_address:"",``` <br> ```password:"",```<br>```}``` |
| **DATA DEFINITION** | Password Encryption: md5 |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Failed, already registered" ,```<br> ```"data:{```<br> ```customer_id:"",``` <br> ```customer_firstname:"",``` <br> ```customer_middlename:"",```<br> ```customer_lastname:"",```<br> ```customer_country:"",```<br> ```customer_houseno:"",```<br> ```customer_street:"",```<br> ```customer_district:"",```<br> ```customer_city:"",```<br> ```customer_province:"",```<br> ```customer_postcode:"",```<br> ```customer_contact_no:"",```<br> ```customer_email_address:"",```<br> ```created_by:"",```<br> ```customer_mobile_no:"",```<br> ```scv_id:"",```<br> ```}```<br>```}```
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Login Failed" ,```<br> ```"data:{}```<br>```}``` |
## Order Tracker API
<p>This API is used for order tracking.</p>
For brand list definition
> See full list [here](https://hackmd.io/pa3z7pZmQDmbjYKBBC-IXQ?view#Data-Parameter-Definitions).
>
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/order-tracker
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/order-tracker
---
| **FUNCTION** | Order Tracking |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | ```{```<br> ```orderid:"",``` <br> ```brandid:"",```<br>```}``` |
| **DATA DEFINITION** | {} |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message": "Successful, Order status",```<br> ``` "data":{```<br> ```status_id:"1"```<br> ```}``` <br>```}```<br><br>***Note status_id reference:***<br>0 = order float<br>1 = order assigned to store<br>2 = order accepted<br>3 = order on the way<br>4 = completed|
| | |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Failed, Order ID Not found" ,```<br> ```"data:{}```<br>```}``` |
## Place Order
<p>This API is used for customer registration.</p>
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/save-orders
---
| **FUNCTION** | Place Order API |
| -------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | 
|
| **DATA DEFINITION** | `{`<br>`}` |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message": "Successfully Placed Order.",```<br> ``` "data":{```<br> ```order_id:""```<br> ```}``` <br>```}``` |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Failed, please try again" ,```<br> ```"data:{}```<br>```}```
## Payment Status
<p>This API is used for checking of payment status.</p>
>
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/check-payment
---
| **FUNCTION** | Payment Status |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
title: API Documentation
tags: API Documentation
description: API Documentation
---

<div style="text-align: center; font-size: 35px">
MGCC Portal API Documentation
</div>
---
# Copyright Information
**Maxs Group Inc - IT Application Development**<br>
3rd Floor KDC Plaza Building<br>
Chino Roces Avenue. Makati City, 1231<br>
Email: appdev@maxsgroupinc.com
---
# Confidentiality and Usage
<div style="text-align: justify">The information contained in this document (and any attachments) is a confidential information provided
by MGI IT - Application Development. This document is intended only for use by merchants approved by MGI.<br><br>
Any copying, distribution or dissemination of this document by any other parties is prohibited.</div>
---
# Revision History
| Revision | Date | Revision Description |
| -------- | --------------- | -------------------- |
| 0.0 | August 11, 2021 | Final Draft Issue |
| 0.1 | November 2, 2021| Data Dictionary |
| 1.0 | September 1, 2022| Data flow|
---
<!--
# API Documentation
- <span style="color:red">API Key provided in email</span> -->
# API
## RTA Map API
### Store Assignment
<p>This API is used to check store assignment.</p>
For brand list definition
> See full list [here](https://hackmd.io/pa3z7pZmQDmbjYKBBC-IXQ?view#Data-Parameter-Definitions).
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/check-store-cater
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/check-store-cater
---
| **FUNCTION** | Check store assignment |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>}|
| **DATA PARAMS** | ```{```<br> ```lat:"",``` <br> ```lng:"",```<br> ```brand_id:""```<br>```}``` |
| **DATA DEFINITION** | {} |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message":"",```<br> ```"data":{```<br> ```store_code: "",```<br> ```store_name:"",```<br> ```promise_time:"",```<br> ```pricelist_id:"",```<br> ```minimum_delivery:"",```<br> ```alternate_store:""```<br> ```}```<br> ```}``` |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"“No store available." ,```<br> ```"data":{}```<br>```}``` |
### Store Check Status
<p>This API is used to check the store status.</p>
For brand list definition
> See full list [here](https://hackmd.io/pa3z7pZmQDmbjYKBBC-IXQ?view#Data-Parameter-Definitions).
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/check-store-status
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/check-store-status
---
| **FUNCTION** | Check store status |
| -------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | ```{```<br> ```store_code:"",``` <br> ```transaction_date_time:"",```<br> <br>```}``` |
| **DATA DEFINITION** | {} |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message": "Store available to send order.",```<br> ``` "data":{} ```<br> ```}``` |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Store closed/peak." ,```<br> ```"data":{}```<br>```}``` |
---
### Menu Products
<p>This API is used to check the store status.</p>
For brand list and transaction type definitions
> See full list [here](https://hackmd.io/pa3z7pZmQDmbjYKBBC-IXQ?view#Data-Parameter-Definitions).
For menu exploration use 1 as default transaction_id and pricelist_id.
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/menu-products
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/menu-products
---
| **FUNCTION** | Menu Products |
| -------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | ```{```<br> ```brand_id:"",``` <br> ```pricelist_id:"",```<br> ```transaction_id:"",```<br> ```transaction_date:""```<br>```}``` |
| **DATA DEFINITION** | {} |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message": "Menu Product",```<br> ``` "Menu":{Product: {"product_id, :"",product_name: "", product_description : "", product_image: "", catetgory_id: "", category_name:"", brand_id: "",sort: "", leadtime:"", price:"" }, option: {option_id : "", option_type: "", option_typeid: "", option_image: "",sort:"",brand_id:""}} ```<br> ```}``` |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Error" ,```<br> ```"data":{}```<br>```}``` |
---
## Store Details API
<p>This API is to get store details by brand.</p>
For brand list definition
> See full list [here](https://hackmd.io/pa3z7pZmQDmbjYKBBC-IXQ?view#Data-Parameter-Definitions).
>
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/store-list
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/store-list
| **FUNCTION** | Get store details |
| -------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} | |
| **DATA PARAMS** | ```{```<br> ```brand_id:""```<br>```}``` | |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message":"",```<br> ```"data":{```<br> ```"brand_name": "",```<br> ```"store_name":"",```<br> ```"start_time":"",```<br> ```"end_time":"",```<br> ```"store_contact_num":"",```<br> ```"store_ops":""```<br> ```}```<br> ```}``` | |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"No store details found." ,```<br> ```"data":{}```<br>```}``` | |
---
## Registration API
<p>This API is used for customer registration.</p>
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/customer-registration
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/customer-registration
---
| **FUNCTION** | Customer registration |
| -------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | ```{```<br> ```customer_firstname:"",``` <br> ```customer_middlename:"",```<br> ```customer_lastname:"",```<br> ```customer_country:"",```<br> ```customer_houseno:"",```<br> ```customer_street:"",```<br> ```customer_district:"",```<br> ```customer_city:"",```<br> ```customer_province:"",```<br> ```customer_postcode:"",```<br> ```customer_contact_no:"",```<br> ```date_of_birth:"",```<br> ```customer_email_address:"",```<br> ```customer_password:"",```<br> ```customer_source:"",```<br> ```created_by:"",```<br> ```customer_mobile_no:"",```<br> ```scv_id:"",```<br>```}``` |
| **DATA DEFINITION** | Password Encryption: md5 |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message": "Successfully Registered.",```<br> ``` "data":{```<br> ```customer_id:""```<br> ```}``` <br>```}```
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Failed, already registered" ,```<br> ```"data:{```<br> ```customer_firstname:"",``` <br> ```customer_middlename:"",```<br> ```customer_lastname:"",```<br> ```customer_country:"",```<br> ```customer_houseno:"",```<br> ```customer_street:"",```<br> ```customer_district:"",```<br> ```customer_city:"",```<br> ```customer_province:"",```<br> ```customer_postcode:"",```<br> ```customer_contact_no:"",```<br> ```customer_email_address:"",```<br> ```created_by:"",```<br> ```customer_mobile_no:"",```<br> ```scv_id:"",```<br> ```}```<br>```}``` |
## Login API
<p>This API is used for customer login.</p>
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/customer-login
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/customer-login
---
| **FUNCTION** | Customer Login |
| -------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | ```{```<br> ```email_address:"",``` <br> ```password:"",```<br>```}``` |
| **DATA DEFINITION** | Password Encryption: md5 |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Failed, already registered" ,```<br> ```"data:{```<br> ```customer_id:"",``` <br> ```customer_firstname:"",``` <br> ```customer_middlename:"",```<br> ```customer_lastname:"",```<br> ```customer_country:"",```<br> ```customer_houseno:"",```<br> ```customer_street:"",```<br> ```customer_district:"",```<br> ```customer_city:"",```<br> ```customer_province:"",```<br> ```customer_postcode:"",```<br> ```customer_contact_no:"",```<br> ```customer_email_address:"",```<br> ```created_by:"",```<br> ```customer_mobile_no:"",```<br> ```scv_id:"",```<br> ```}```<br>```}```
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Login Failed" ,```<br> ```"data:{}```<br>```}``` |
## Order Tracker API
<p>This API is used for order tracking.</p>
For brand list definition
> See full list [here](https://hackmd.io/pa3z7pZmQDmbjYKBBC-IXQ?view#Data-Parameter-Definitions).
>
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/order-tracker
- PRODUCTION
https://mgcc-api.maxsgroupinc.com/order-tracker
---
| **FUNCTION** | Order Tracking |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | ```{```<br> ```orderid:"",``` <br> ```brandid:"",```<br>```}``` |
| **DATA DEFINITION** | {} |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message": "Successful, Order status",```<br> ``` "data":{```<br> ```status_id:"1"```<br> ```}``` <br>```}```<br><br>***Note status_id reference:***<br>0 = order float<br>1 = order assigned to store<br>2 = order accepted<br>3 = order on the way<br>4 = completed|
| | |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Failed, Order ID Not found" ,```<br> ```"data:{}```<br>```}``` |
## Place Order
<p>This API is used for customer registration.</p>
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/save-orders
---
| **FUNCTION** | Place Order API |
| -------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | 
|
| **DATA DEFINITION** | `{`<br>`}` |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message": "Successfully Placed Order.",```<br> ``` "data":{```<br> ```order_id:""```<br> ```}``` <br>```}``` |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Failed, please try again" ,```<br> ```"data:{}```<br>```}```
## Payment Status
<p>This API is used for checking of payment status.</p>
>
- DEVELOPMENT
https://913ccbjb8e.execute-api.ap-southeast-1.amazonaws.com/development/check-payment
---
| **FUNCTION** | Payment Status |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | ```{```<br> ```order_id:""``` <br>```}``` |
| **DATA DEFINITION** | {} |
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message": "Payment status",```<br> ``` "data":{```<br> ```payment_status:"COMPLETED"```<br> ```}``` <br>```}```<br><br>***Note payment_status reference:***<br>COMPLETED = Customer paid successfully<br>REJECTED = Credit/Debit Card failed<br>INCOMPLETE = Payment Incomplete |
| | |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Failed, Order ID Not found" ,```<br> ```"data:{}```<br>```}```
## Rider App Timestamps update
<p>This API is used for updating order status timestamps.</p>
>
- DEVELOPMENT
https://bqnlrsmifj.execute-api.ap-southeast-1.amazonaws.com/Development
---
| **FUNCTION** | RiderApp Update |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **METHOD** | POST |
| **HTTP HEADERS** | Content-Type: application/json<br> x-api-key: {<span style="color:red">*Note: API key to be sent separately*</span>} |
| **DATA PARAMS** | ```{```<br> ```status:""```<br> ```ticket:""```<br> ```datetime:""```<br> ```rider_name:""``` <br>```}``` |
| **DATA DEFINITION** | **Status parameters**: <br> <br> **storein** = rider arrived to the store<br>**storeout** = rider on its way to customer<br> **vicinityin** = rider within the customer vicinity <br> **served** = rider served the order to customer <br> **remit** = rider remit the cash in store <br><br> **ticket number: ** order_id = ticket<br><br> **date time format:** yyyy-mm-dd hh:mm:ss|
| **SUCCESS RESPONSE** | Status: 200<br>Sample Response Body:<br>```{```<br> ```"code": 200,```<br> ```"message": ""SUCCESS: Successfully Updated Timelogs"",```<br> ``` ``` <br>```}```<br><br>***Note payment_status reference:***<br>COMPLETED = Customer paid successfully<br>REJECTED = Credit/Debit Card failed<br>INCOMPLETE = Payment Incomplete |
| | |
| **ERROR RESPONSE** | Status: 69<br>Sample Response Body:<br>```{```<br> ```"code": 69,```<br> ```"message":"Failed, Order ID Not found" ,```<br> ```"data:{}```<br>```}```
## Data Parameter Definitions
Table Name: <b>brands</b>
Note:
active column ->( 1 = activated, 0 = deactivated)
default_trans -> please refe to the transaction_type table
default_pricelist -> please refer to the
| brand | brand_code | brand_name | active |default_trans|default_pricelist|
| -------- | --------------- | -------------------------- |--------|-------------|-----------------|
| 1 | MAXS | Maxs Restaurant | 1 |1 |1 |
| 2 | KK | Krispy Kreme | 1 |1 |1 |
| 3 | YC | Yellow Cab Pizza - Inactive | 0 |1 |1 |
| 4 | PCK | Pancake House | 1 |1 |1 |
| 5 | TBOY | Teriyaki Boy | 1 |1 |1 |
| 7 | TCRS | The Chicken Rice Soup | 0 |1 |1 |
| 8 | JJ | Jamba Juice | 1 |1 |1 |
| 9 | DEN | Dencios | 1 |1 |1 |
| 10 | MER | Yellow Cab 2 | 0 |1 |1 |
| 11 | MCB | Max's Corner Bakery | 0 |1 |1 |
| 12 | KABI | Kabisera ni Dencios | 1 |1 |1 |
| 13 | MPL | Maple | 0 |1 |1 |
| 14 | SING | Singkit | 0 |1 |1 |
| 15 | LCDF | Le Coeur De France | 0 |1 |1 |
| 16 | MGI | Maxs Group Inc | 1 |1 |1 |
| 17 | YC | Yellow Cab Pizza Co. | 1 |1 |1 |
| 18 | FC | Fun Chao | 1 |1 |1 |
Table Name: <b>transaction_type</b>
| id | trans_code | trans_name |
| -------- | --------------- | -------------------------- |
| 1 | deliveryNow | Now |
| 2 | deliveryLater | Deliver later |
| 3 | pickup | Inside store |
| 4 | dinein | Dine-in |
| 5 | curbside | Curbside® pick-up point |