v1

latestOpenAPI 3.1.02026-07-2422707.0 MB

Collect 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

is_appliedboolean

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."
  }
}