Refund Order

Method : POST

URL: https://open.revenuemonster.my/v3/service

Sandbox URL: https://sb-open.revenuemonster.my/v3/service

note
  • Using orderId to refund the order.

Request Parameters#

ParameterTypeDescriptionExample
serviceStringalacarte service"alacarte"
versionStringCurrently only support 'v1""v1"
functionStringFunction that provide by alacarte"refund.store.order"
requestObjectRefer to explanation below(Refer to explanation below)
ParameterTypeDescriptionExample
orderIdStringOrder Id"25f6984d6585d7cc1ae35a39c"

Example Request

curl --location --request POST 'https://sb-open.revenuemonster.my/v3/service' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjIwMTgtMDMtMTMiLCJ0eXAiOiJKV1QifQ.eyJhdWQiOlsiYXBpX2NsaWVudEBFaGNLQzA5QmRYUm9RMnhwWlc1MEVKTE42dFdBMG82MEx3Il0sImV4cCI6MTYwMzI1NDU2OSwiaWF0IjoxNjAwNjYyNTY5LCJpc3MiOiJodHRwczovL3NiLW9hdXRoLnJldmVudWVtb25zdGVyLm15IiwianRpIjoiRWh3S0VFOUJkWFJvUVdOalpYTnpWRzlyWlc0UTZNenR5b1RFckpzVyIsIm5iZiI6MTYwMDY2MjU2OSwic3ViIjoiRWhRS0NFMWxjbU5vWVc1MEVKWFZ6ZDN3cmFxVE9SSVFDZ1JWYzJWeUVJeUpxSXp2eU1QVmNRIn0.H3G6UDX7sR9EXtTMNs4Q2OHdhUGIhhCfdlAeOpywH4rDuVOcWXXwzF4Imbx8E7I10vFAJpwYZrEkCWCdCCw-WV11y9VT5kP6k75CeS-ZPMOLcKnC5iFT7vEi07r6ovwty9erlcZeXrtrmEIn3rnLva-dxSg3vZ2MyymoNDk-kV7ltXnkoWW4jtXRls6siLhxeY__8kXn2qa0ojVX4Nm6HmzN_vgi-RKSmToMgsdzTF94Y61QVBWhZfolD2-JpHx4qNlklcUdv8HOJ1QHHWpyoJytaJmvr3GJ5G399LbcTLwxB1p2qPg7z4hpoGNu4AP-ybRJVC3P9q9OscQYDNX-dA' \
--header 'X-Signature: sha256 Sty3LNcKA8+WlMHtAgIY+y1xbwnzKsN0UdyKaW+yYIgcTkBAtF7G5Lx251qQITURJ4wiXPDODxhs1nFVmBBing==' \
--header 'X-Nonce-Str: VYNknZohxwicZMaWbNdBKUrnrxDtaRhN' \
--header 'X-Timestamp: 1528450585' \
--data-raw '{
"service": "alacarte",
"version": "v1",
"function": "refund.store.order",
"request": {
"storeId": "2808912573238362402",
"orderId":"5f6984d6585d7cc1ae35a39c"
}
}'

Response Parameters#

note
  • Current type in Status will be :-

    • "EMPTY"
    • "WAITING_FOR_PAYMENT"
    • "WAIT_FOR_CONFIRMATION"
    • "CANCELLED"
    • "PROGRESSING"
    • "WAITING_FOR_COURIER"
    • "FINDING_COURIER"
    • "SHIPPING"
    • "COMPLETED"
    • "DELAYED"
    • "REJECTED"
  • Current type in State will be :-

    • "ACCEPTED" , "REJECTED" , "CANCELED" , "REFUNDED"
  • Current type in Type will be :-

    • "DINEIN" , "DELIVERY" , "PICKUP", "DRIVE_THRU"
ParameterTypeDescriptionExample
createdAtDateTimeCreation date time of store"2020-09-22T04:44:57.950398414Z"
customerObjectRefer to explanation below(Refer to explanation below)
deliveryObjectRefer to explanation below(Refer to explanation below)
deliveryAtStringWhen and what time the order deliver"2020-10-01T08:35:22.525Z"
driveThruObjectRefer to explanation below(Refer to explanation below)
itemsArrayRefer to explanation below(Refer to explanation below)
orderIdStringOrder ID"5f7596e066ef1c1a4f9807f4"
paymentObjectRefer to explanation below(Refer to explanation below)
quantityUintQuantity of the item1
queueNoUintQueue number of the item0
stateStringState of the item"REFUNDED"
statusStringStatus of the item"CANCELLED"
storeIdStringID of the Store that Create from RM"10946114768247530"
tableObjectRefer to explanation below(Refer to explanation below)
typeStringType of the item"DELIVERY"
updatedAtDateTimeLast update date time"2020-10-01T08:44:16.863Z"

Inside Customer (parameter)#

ParameterTypeDescriptionExample
countryCodeStringCountry Code"60"
emailStringCustomer Email"bassem@revenuemosnter.my"
nameStringCustomer Name"Bassem AlSabbagh"
phoneNumberStringCustomer contact number"1123621544"
idStringCustomer ID"5f63082ae9c755d6ba3122ac"

Inside Delivery (parameter)#

ParameterTypeDescriptionExample
addressStringRefer to explanation below(Refer to explanation below)
courierStringRefer to explanation below(Refer to explanation below)
distanceInMeterIntDelivery Distance (In Meter)17446
idStringCustomer contact number"5f815e2c3c6920f1233a540f"
methodStringCustomer ID"OWN"
vendorIdStringCustomer ID"5f815e2c3c6920f1233a540f"

Inside Address (parameter)#

ParameterTypeDescriptionExample
addressLine1StringAddressLine1""
addressLine2StringAddressLine2""
cityStringCity""
countryStringCountry""
latitudeIntAddress latitude (In Meter)0
longitudeIntAddress longitude (In Meter)0
nameStringCustomer Name""
postCodeStringCustomer Remark""
remarkStringCustomer Remark""
stateStringAddress State""
unitStringAddress Unit""

Inside Courier (parameter)#

note
  • If Courier don't have name and phone will display as null
ParameterTypeDescriptionExample
idStringCourier ID""
latitudeIntAddress latitude (In Meter)0
longitudeIntAddress longitude (In Meter)0
nameStringCourier Name"Testing123"
phoneStringCourier Contact Number"163698122"
photoURLStringCourier Image""
surnameStringCourier Surname""

Inside Drive Thru (parameter)#

note
  • If not Drive Thru will display null
ParameterTypeDescriptionExample
vehicleDescriptionStringVehicle description""
vehicleNoStringVehicle Number"TLA3202"

Inside Items (parameter)#

ParameterTypeDescriptionExample
descriptionStringItem description"got Nasi gt lemak"
imageUrlArrayItem Image[]
itemIdStringItem ID"5f69a41f212de28db36031d6"
nameStringItem Name"Nasi lemak & Lemak"
preferencesArrayRefer to the Preferences parameter(Refer to the Preferences parameter)
priceObjectRefer to the Price parameter( Refer to the Price parameter)
quantityUintItem Quantity1
remarkStringCustomer Remark""
sidesArrayRefer to the Sides parameter( Refer to the Sides parameter)

Inside Preferences (parameter)#

note
  • Will display Empty Array when don't have preferences
ParameterTypeDescriptionExample
nameStringPreferences name"Sweetness"
minChoiceUintSet minimum choice1
maxChoiceUintSet maximum choice3
labelsArrayRefer to explanation below(Refer to explanation below)

Inside Sides (parameter)#

note
  • Will display Empty Array when don't have sides
ParameterTypeDescriptionExample
idStringSide ID""
nameStringSide Name"test"
sideItemsArrayRefer to the SideItems parameterRefer to the SideItems parameter

Inside SideItems (parameter)#

ParameterTypeDescriptionExample
idStringSide ID"5f7b4195021ba83f52a02551"
nameStringSide Name"Hainan Chicken Rice"
priceObjectRefer to the Price parameterRefer to the Price parameter

Inside Payment (parameter)#

note

Current type in Payment will be :-

"PAID" , "NOTPAID" , "PENDING" , "REFUNDED"

ParameterTypeDescriptionExample
deliveryFeeObjectRefer to the Price parameter( Refer to the Price parameter)
roundingObjectRefer to the Price parameter( Refer to the Price parameter)
serviceFeeObjectRefer to the Price parameter( Refer to the Price parameter)
serviceTaxObjectRefer to the Price parameter( Refer to the Price parameter)
statusStringPayment Status"NOTPAID"
subTotalObjectRefer to the Price parameter( Refer to the Price parameter)
totalAfterRoundingObjectRefer to the Price parameter( Refer to the Price parameter)
totalBeforeRoundingObjectRefer to the Price parameter( Refer to the Price parameter)

Inside Price (parameter)#

note

Only serviceFee and serviceTax have percentage

ParameterTypeDescriptionExample
amountUintAmount in cent (min RM 0.10 10 = RM 0.10)100
currencyTypeStringCurrent only support Ringgit Malaysia"MYR"
percentageUintprecentage will be divide 100 eg: 1300/1001300

Inside Table (parameter)#

ParameterTypeDescriptionExample
idStringTable ID"5e86af7ef9e6794801df3302"
isAvailableBoolVehicle Numbertrue
isDefaultBoolVehicle Numbertrue
nameStringTable Name"Default Table"

Example Response

{
"item": {
"createdAt": "2020-10-10T07:09:32.349Z",
"customer": {
"countryCode": "60",
"email": "edwin@revenuemonster.my",
"id": "5f7e7c38397dc15895356b3c",
"name": "Edwin",
"phoneNumber": "163699187"
},
"delivery": {
"address": {
"addressLine1": "",
"addressLine2": "Lebuh Bandar Utama",
"city": "Petaling Jaya",
"country": "",
"latitude": 0,
"longitude": 0,
"name": "",
"postCode": "47800",
"remark": "",
"state": "Selangor",
"unit": ""
},
"courier": {
"id": "",
"latitude": 0,
"longitude": 0,
"name": "Testing123",
"phone": "163698122",
"photoUrl": "",
"surname": ""
},
"distanceInMeter": 17446,
"id": "5f815e2c3c6920f1233a540f",
"method": "OWN",
"vendorId": "5f815e2c3c6920f1233a540f"
},
"deliveryAt": "2020-10-10T08:44:28.878Z",
"driveThru": null,
"items": [
{
"description": "",
"imageUrl": [
"https://smart-cafe-sandbox.oss-ap-southeast-3.aliyuncs.com/images/4118165203679668885/4f062980-a5be-4e33-961c-ae37f1a22fb1"
],
"itemId": "5f7b4195021ba83f52a02556",
"name": "Ice Kacang (ABC)",
"preferences": [],
"price": {
"amount": 100,
"currencyType": "MYR"
},
"quantity": 1,
"remark": "",
"sides": []
},
{
"description": "",
"imageUrl": [
"https://smart-cafe-sandbox.oss-ap-southeast-3.aliyuncs.com/images/4118165203679668885/52bd3e20-6dea-45ba-a58e-f044688253e1"
],
"itemId": "5f7b4195021ba83f52a02557",
"name": "Cendol",
"preferences": [],
"price": {
"amount": 50,
"currencyType": "MYR"
},
"quantity": 1,
"remark": "",
"sides": []
}
],
"orderId": "5f815e2c3c6920f1233a540f",
"payment": {
"deliveryFee": {
"amount": 0,
"currencyType": "MYR"
},
"rounding": {
"amount": -2,
"currencyType": "MYR"
},
"serviceFee": {
"amount": 63,
"currencyType": "MYR",
"percentage": 600
},
"serviceTax": {
"amount": 74,
"currencyType": "MYR",
"percentage": 700
},
"status": "REFUNDED",
"subTotal": {
"amount": 1050,
"currencyType": "MYR"
},
"totalAfterRounding": {
"amount": 1185,
"currencyType": "MYR"
},
"totalBeforeRounding": {
"amount": 1187,
"currencyType": "MYR"
}
},
"quantity": 11,
"queueNo": 2,
"state": "REFUNDED",
"status": "CANCELLED",
"storeId": "1601912947341252990",
"table": {
"id": "5f7b40d0021ba83f52a02547",
"isActive": true,
"isDefault": true,
"name": "Default Table"
},
"type": "DELIVERY",
"updatedAt": "2020-10-10T07:23:15.062108233Z"
}
}