HTTP Webhook

The notification URL is an automatic push notification that can be sent to a merchant’s notification URL address. This will be initiated when a payment is completed. Note that the URL can be configured per-merchant site.

To set this URL, please contact [email protected]

Web-Hook Notification Model

Example Web-Hook Notification JSON Body

{
"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":[
]
}

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). 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).

Vouchers

array<Voucher>

Voucher collection of all redeemed vouchers for this payment (in decimal format).

CustomFields

array<CustomField>

CustomField collection of all custom fields added for this payment

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