Skip to main content

Refund Order

Refund a paid à la carte order back to the customer. The order's payment status moves to REFUNDED.

When to Use

Use this endpoint when:

  • Customer requests a refund for a paid order
  • Reversing an order due to fulfillment issues

How to Use

Endpoint
POST/v3/service

POST function: "refund.store.order" with storeId and orderId.


Request Parameters

serviceSTRING

alacarte service

Example: "alacarte"

versionSTRING

Currently only support 'v1"

Example: "v1"

functionSTRING

Function that provide by alacarte

Example: "refund.store.order"

requestOBJECT

Request body

orderIdSTRING

Order Id

Example: "25f6984d6585d7cc1ae35a39c"

Response Parameters

createdAtDATETIME

Creation date time of store

Example: "2020-09-22T04:44:57.950398414Z"

customerOBJECT

Customer info

countryCodeSTRING

Country Code

Example: "60"

emailSTRING

Customer Email

Example: "[email protected]"

idSTRING

Customer ID

Example: "5f63082ae9c755d6ba3122ac"

nameSTRING

Customer Name

Example: "Bassem AlSabbagh"

phoneNumberSTRING

Customer contact number

Example: "1123621544"

deliveryOBJECT

Delivery info

addressOBJECT

Delivery address

addressLine1STRING

AddressLine1

Example: ""

addressLine2STRING

AddressLine2

Example: ""

citySTRING

City

Example: ""

countrySTRING

Country

Example: ""

latitudeFLOAT

Address latitude (In Meter)

Example: 0

longitudeFLOAT

Address longitude (In Meter)

Example: 0

nameSTRING

Customer Name

Example: ""

postCodeSTRING

Post code

Example: ""

remarkSTRING

Customer Remark

Example: ""

stateSTRING

Address State

Example: ""

unitSTRING

Address Unit

Example: ""

courierOBJECT

Courier info

idSTRING

Courier ID

Example: ""

latitudeFLOAT

Address latitude (In Meter)

Example: 0

longitudeFLOAT

Address longitude (In Meter)

Example: 0

nameSTRING

Courier Name

Example: "Testing123"

phoneSTRING

Courier Contact Number

Example: "163698122"

photoUrlSTRING

Courier Image

Example: ""

surnameSTRING

Courier Surname

Example: ""

distanceInMeterINTEGER

Delivery Distance (In Meter)

Example: 17446

idSTRING

Delivery ID

Example: "5f815e2c3c6920f1233a540f"

methodSTRING

Delivery method

Example: "OWN"

vendorIdSTRING

Vendor ID

Example: "5f815e2c3c6920f1233a540f"

deliveryAtSTRING

When and what time the order deliver

Example: "2020-10-01T08:35:22.525Z"

driveThruOBJECT

Drive thru info (null if not drive thru)

itemsARRAY

Order items

descriptionSTRING

Item description

Example: "got Nasi gt lemak"

imageUrlARRAY

Item Image

Example: []

itemIdSTRING

Item ID

Example: "5f69a41f212de28db36031d6"

nameSTRING

Item Name

Example: "Nasi lemak & Lemak"

preferencesARRAY

Item preferences (empty array when none)

priceOBJECT

Item price

amountINTEGER

Amount in cent (min RM 0.10 10 = RM 0.10)

Example: 100

currencyTypeSTRING

Current only support Ringgit Malaysia

Example: "MYR"

quantityINTEGER

Item Quantity

Example: 1

remarkSTRING

Customer Remark

Example: ""

sidesARRAY

Item sides (empty array when none)

orderIdSTRING

Order ID

Example: "5f7596e066ef1c1a4f9807f4"

paymentOBJECT

Payment info

deliveryFeeOBJECT

Delivery fee

amountINTEGER

Amount in cent

Example: 0

currencyTypeSTRING

Currency type

Example: "MYR"

roundingOBJECT

Rounding amount

amountINTEGER

Amount in cent

Example: -2

currencyTypeSTRING

Currency type

Example: "MYR"

serviceFeeOBJECT

Service fee

amountINTEGER

Amount in cent

Example: 63

currencyTypeSTRING

Currency type

Example: "MYR"

percentageINTEGER

Percentage (divide by 100)

Example: 600

serviceTaxOBJECT

Service tax

amountINTEGER

Amount in cent

Example: 74

currencyTypeSTRING

Currency type

Example: "MYR"

percentageINTEGER

Percentage (divide by 100)

Example: 700

statusSTRING

Payment Status (PAID, NOTPAID, PENDING, REFUNDED)

Example: "REFUNDED"

subTotalOBJECT

Sub total

amountINTEGER

Amount in cent

Example: 1050

currencyTypeSTRING

Currency type

Example: "MYR"

totalAfterRoundingOBJECT

Total after rounding

amountINTEGER

Amount in cent

Example: 1185

currencyTypeSTRING

Currency type

Example: "MYR"

totalBeforeRoundingOBJECT

Total before rounding

amountINTEGER

Amount in cent

Example: 1187

currencyTypeSTRING

Currency type

Example: "MYR"

quantityINTEGER

Quantity of the item

Example: 1

queueNoINTEGER

Queue number of the item

Example: 0

stateSTRING

State of the item (ACCEPTED, REJECTED, CANCELED, REFUNDED)

Example: "REFUNDED"

statusSTRING

Order status. One of: `EMPTY`, `WAITING_FOR_PAYMENT`, `WAIT_FOR_CONFIRMATION`, `CANCELLED`, `PROGRESSING`, `WAITING_FOR_COURIER`, `FINDING_COURIER`, `SHIPPING`, `COMPLETED`, `DELAYED`, `REJECTED`

Example: "CANCELLED"

storeIdSTRING

ID of the Store that Create from RM

Example: "10946114768247530"

tableOBJECT

Table info

idSTRING

Table ID

Example: "5e86af7ef9e6794801df3302"

isActiveBOOLEAN

Table is active

Example: true

isDefaultBOOLEAN

Is default table

Example: true

nameSTRING

Table Name

Example: "Default Table"

typeSTRING

Type (DINEIN, DELIVERY, PICKUP, DRIVE_THRU)

Example: "DELIVERY"

updatedAtDATETIME

Last update date time

Example: "2020-10-01T08:44:16.863Z"