Zapper Integrations
Search…
Legacy Model (Deprecated)
Web-Hook Notification Model
Example Web-Hook Notification JSON Body
1
{
2
"Reference":"ABCD-EF45-C3D2-A1AB",
3
"PaymentStatusId":2,
4
"PosReference":"DEFAB4A6C3D1A1B2",
5
"PSPData":"",
6
"Amount":"50.67",
7
"ZapperId":"HLV8AMJ47RBI",
8
"UpdatedDate":"2015-06-29T17:54:53.157",
9
"TipAmount":"5.56",
10
"VoucherAmount":"0.00",
11
"ZapperDiscountAmount":"0.00",
12
"InvoiceAmount":"44.44",
13
"Vouchers":[
14
​
15
],
16
"CustomFields":[
17
​
18
]
19
}
Copied!
Example Web-Hook notification JSON string Body
To support the old webhook service the JSON string format was ported over from the old project. This is activated by setting the encoding field of the webhook config to "string".
1
"{\"Reference\":\"ABCD-EF45-C3D2-A1AB\",\"PaymentStatusId\":2,\"PosReference\":\"DEFAB4A6C3D1A1B2\",\"PSPData\":\"\",\"Amount\":\"50.67\",\"ZapperId\":\"HLV8AMJ47RBI\",\"UpdatedDate\":\"2015-06-29T17:54:53.157\",\"TipAmount\":\"5.56\",\"VoucherAmount\":\"0.00\",\"ZapperDiscountAmount\":\"0.00\",\"InvoiceAmount\":\"44.44\",\"Vouchers\":[],\"CustomFields\":[]}"
Copied!
Parameter
Type
Description
Reference
String
This is the unique merchant reference to the existing order (i.e. the table number, check number etc). Max length 30 characters. AKA MerchantOrderId.
PaymentStatusId
Int
2 = Success; 5 = Failed
PosReference
String
The 16 character PosReference that uniquely identifies the printing of the Bill.
PSPData
String
Reserved for future date
Amount
String
The sum of the InvoiceAmount and TipAmount fields (in decimal format). i.e Amount. After adding calculating (InvoiceAmount plus TipAmount), discount vouchers are applied, i.e. subtracted from the Amount. The sum total, i.e. Amount minus Vouchers is the amount that the customer has to pay.
ZapperId
String
A unique Transaction Identifier for the customer.
UpdatedDate
DateTime (UTC)
The date of the transaction.
TipAmount
String
Tip Amount paid by the customer (in decimal format).
ZapperDiscountAmount
String
How much Zapper pays the merchant on the diner’s behalf the first time the diner uses Zapper to make payment (in decimal format). (Note: this is not a discount that would have been shown on the bill, it is applied by Zapper to the diner’s payment).
InvoiceAmount
String
The amount on the bill/check (in decimal format).
Voucher Model
Parameter
Type
Description
Name
String
The name of the voucher
Amount
String
The amount redeemed (in decimal format).
CustomField Model
Parameter
Type
Description
Name
String
The name of the custom field
Value
String
The value of the custom field
Last modified 1yr ago
Copy link