Field | DataType | Description |
invoiceReference | string | Zapper's invoice reference |
invoiceExternalReference | string | Merchant's invoice reference |
currencySymbol | string | The currency symbol |
currencyISOCode | string | The currency ISO code of the invoice |
invoicedAmount | number | The invoiced amount in cents |
paymentReference | string | Zapper's payment reference (Zapper ID) |
paymentUTCDate | string | The date of the payment |
status | ​PaymentStatus​ | The outcome of the payment |
tipAmount | number | The tip amount paid by the customer in cents |
tenderedAmount | number | The total tender amount paid by customer (including tips and vouchers) |
vouchers | Array<Voucher> | A list of voucher amounts and who is liable respectively |
customer | ​Customer​ | The Customer's first and last name |
siteId | number | The Zapper Merchant Site ID |
siteReference | string | The identifier of the point of sale till. This is required for routing of Zapper payments and invoices. |
transactionProcessorReference | string | The transaction id sent to the payment processor |
Example of a Zapper Payment Notification webhook body:
{"status": 1,"vouchers": [{"amount": 100,"merchantLiable": true}],"currencySymbol": "R""currencyISOCode": "ZAR","customer": {"firstName": "Adam","lastName": "E"},"invoicedAmount": 1000,"paymentReference": "8828NV78V30X5N0VY3","paymentUTCDate": "2019-09-26T13:44:19.8925818Z","invoiceReference": "invoiceReference1234","invoiceExternalReference": "merchantOrderId1234","tenderedAmount": 1100,"tipAmount": 100,"siteId": 1234,"siteReference": "siteReffy2","transactionProcessorReference": "ghr-red-vbf-1231"}
Value | Description |
1 | Success |
2 | Failed |
Field | Datatype | Required | Description |
firstName | string | Yes | The name of the customer |
lastName | string | Yes | The last name of the customer |
Field | Datatype | Required | Description |
merchantLiable | bool | Yes | Is the merchant liable for the tender |
amount | number | Yes | The redeemed amount in cents |