Download OpenAPI specification:Download
point reward system integration api
point reward system query for all stores in detail
| limit | any Example: 6 |
| cursor_id | any |
[- {
- "id": "1",
- "name": "KFK TTP",
- "address": "st 169, TTP",
- "latlng": 12.69696969,
- "contact_info": {
- "phone": "+85512696969"
}
}, - {
- "id": "2",
- "name": "KFK BKK1",
- "address": "st 269, BKK1",
- "latlng": 2.69696969,
- "contact_info": {
- "phone": "+85513696969"
}
}
]point reward system query for products using checkout id from from partner
| id required | string partner's checkout id |
{- "message": "",
- "code": "",
- "data": {
- "extra_charges": [
- {
- "type": "vat",
- "purpose": null,
- "charge_unit": "percent",
- "total_charged": "2.83",
- "base_charge_value": "6.9"
}, - {
- "type": "merchant_services",
- "purpose": "waiter",
- "charge_unit": "usd",
- "total_charged": "4",
- "base_charge_value": "4"
}, - {
- "type": "processing_fee",
- "purpose": "bank_transaction",
- "charge_unit": "usd",
- "total_charged": "0.2",
- "base_charge_value": "0.2"
}
], - "grand_total_price_as_usd": "48.03",
- "grand_total_price_without_extra_charges_as_usd": "41",
- "products": [
- {
- "id": "1",
- "name": "magic-box",
- "label": "Magic Box",
- "quantity": 1,
- "image_url": {
}, - "price_per_item": {
- "id": "1",
- "price_as_usd": "1"
}
}, - {
- "id": "2",
- "name": "sea-salt",
- "label": "Sea Salt",
- "quantity": 1,
- "image_url": {
}, - "price_per_item": {
- "id": "4",
- "price_as_usd": "8"
}
}, - {
- "id": "3",
- "name": "beef-slice",
- "label": "Beef Slice",
- "quantity": 8,
- "image_url": {
}, - "price_per_item": {
- "id": "4",
- "price_as_usd": "4"
}
}
]
}
}update checkout price with offers applied
| id required | string partner's checkout id |
object (Transaction) |
{- "transaction": {
- "id": "413f91d7-3b58-422d-a0b0-2817c45f6f3c",
- "user_id": "31987007-88f5-4823-baaa-db595c1fc4e9",
- "external_transaction_id": "hD8Q5AV0Ode8SYoCjitt27kPyMknnH1r",
- "status": "pending",
- "products": [
- {
- "reference_id": "1",
- "reference_price_id": "1",
- "quantity": 2
}, - {
- "reference_id": "2",
- "reference_price_id": "4",
- "quantity": 1
}
], - "offers_applied": [
- {
- "id": 1,
- "type": "free-item",
- "detail": {
- "quantity": 1,
- "item_reference_id": "1"
}
}, - {
- "id": 2,
- "type": "discount-coupon",
- "detail": {
- "flat_discount_as_usd": 2,
- "percent_discount_as_percent": 0
}
}, - {
- "id": 3,
- "type": "selected-item-discount",
- "detail": {
- "flat_discount_as_usd": 0,
- "percent_discount_as_percent": 10,
- "items": [
- {
- "reference_id": "2"
}, - {
- "reference_id": "5"
}
]
}
}
], - "total_price_as_usd": "32",
- "grand_total_price_as_usd": "16"
}
}{- "message": "",
- "code": "",
- "data": {
- "khqr": "base64:YWJjZGVmCg==",
- "khqr_merchant_name": "KFK TTP",
- "grand_total_price_as_usd": "18.8",
- "grand_total_price_without_extra_charges_as_usd": "16",
- "extra_charges": [
- {
- "type": "vat",
- "purpose": null,
- "charge_unit": "percent",
- "total_charged": "1.6",
- "base_charge_value": "10"
}, - {
- "type": "merchant_services",
- "purpose": "waiter",
- "charge_unit": "usd",
- "total_charged": "1",
- "base_charge_value": "1"
}, - {
- "type": "processing_fee",
- "purpose": "bank_transaction",
- "charge_unit": "usd",
- "total_charged": "0.2",
- "base_charge_value": "0.2"
}
]
}
}endpoint to receive integration event from merchant
| merchant_id required | integer merchant's id |
| event | string Enum: "PaymentCompleted" "ProductOnSale" "ProductOffSale" "ProductInfoUpdated" |
| created_at | date-time |
| data | object |
{- "event": "PaymentCompleted",
- "created_at": "2017-07-21T17:32:28Z",
- "data": {
- "checkout_id": "hD8Q5AV0Ode8SYoCjitt27kPyMknnH1r"
}
}get transaction detail by its id
| merchant_id required | integer merchant's id |
| id required | string <uuid> point reward system's transaction id |
{- "message": "",
- "code": "prs@0",
- "data": {
- "id": "413f91d7-3b58-422d-a0b0-2817c45f6f3c",
- "user_id": "31987007-88f5-4823-baaa-db595c1fc4e9",
- "external_transaction_id": "hD8Q5AV0Ode8SYoCjitt27kPyMknnH1r",
- "status": "completed",
- "products": [
- {
- "reference_id": "1",
- "reference_price_id": "1",
- "quantity": 2
}, - {
- "reference_id": "2",
- "reference_price_id": "4",
- "quantity": 1
}
], - "offers_applied": [
- {
- "id": 1,
- "type": "free-item",
- "detail": {
- "quantity": 1,
- "item_reference_id": "1"
}
}, - {
- "id": 2,
- "type": "discount-coupon",
- "detail": {
- "flat_discount_as_usd": 2,
- "percent_discount_as_percent": 0
}
}, - {
- "id": 3,
- "type": "selected-item-discount",
- "detail": {
- "flat_discount_as_usd": 0,
- "percent_discount_as_percent": 10,
- "items": [
- {
- "reference_id": "2"
}, - {
- "reference_id": "5"
}
]
}
}
], - "total_price_as_usd": "32",
- "grand_total_price_as_usd": "16"
}
}