v1
latestOpenAPI 3.1.02026-07-2422707.0 MBCollect invoice payment by redeeming a guest's gift card
This API helps you to collect payment for the amount of an invoice by redeeming the balance of a guest’s gift card.
You must first verify the balance of a guest’s gift card. If the gift card contains sufficient balance, you can then call this API to collect payment for the specified invoice.
This gift card redemption for an invoice enables you to display the relevant details in your Zenoti UI, and map it to the respective fields in Reports and Analytics.
You must specify appropriate data for the invoice_id parameter.
post/v1/invoices/{invoice_id}/payments/gift_card
Path parameters
invoice_idstring required
Mandatory Unique 32-character identifier of the guest's invoice.
Response
200
Example response
{
"is_applied": true,
"payment": {
"payment_option": {
"id": "a9c88fa7-d464-4216-835e-77e30c01e7fc",
"payment_mode": 1,
"payment_name": "Gift Card",
"card_number": "153"
},
"total_amount_paid": 23,
"amount_paid": 13,
"tip_amount": 10,
"transaction_id": "ab8bc8dc-5f69-4325-b06a-1d7586636568",
"payment_date": "2020-03-27T05:35:12.2",
"cash_regester_id": "00000000-0000-0000-0000-000000000000"
},
"error": {
"code": 716,
"message": "Error While Adding Payment."
}
}