# Gift Cards

Hyp supports a variety of gift card brands used in Israel, issued by Finitione, Multipass, or Rav-Arnak.

<details>

<summary>Show all brands</summary>

* Issued by Finitione:
  * Discont Young (דיסקונט צעירים)
  * Finitione
  * Gold Ztfon (גולד צפון)
  * istudent (אייסטודנט)
  * Leumi Gudeis (לאומי גודיז)
  * Pais Plus - Mifal haPais Club (פיס פלוס מועדון מפעל הפיס)
  * Pais Plus Rechargeable Gift Card (פיס פלוס תו נטען)
  * Pais Plus Shovar (פיס פלוס שוברים כספיים)
  * Visa Cal (ויזה כ.א.ל.)
  * Yours Club Rechargeable Gift Card (מועדון שלך תו נטען)
  * Yours Club Shovar (cash vouchers – מועדון שלך שוברים כספיים)
  * Yours Club Shovar (for retirees – מועדון שלך לגימלאי)
* Issued by Multipass:
  * BUYME
  * Dor Hadash Ba Shovarim (דור חדש בשוברים)
  * Extra Gift Card (אקסטרה גיפט קארד)
  * HiTechZone (הייטקזון)
  * Kesharim Plus (קשרים פלוס)
  * Mega Leaan (מגה לאן)
  * Multipass (מולטיפס)
  * Power Card
  * POWER GIFT (פאוור גיפט)
  * Raayonit (רעיונית)
  * Rami Levi - Tav Male Digitali (רמי לוי - התו המלא דיגיטלי)
  * Yenot Bitan - Tav Plus (יינות ביתן - תו פלוס)
* Issued by Rav-Arnak:
  * Ashmoret (אשמורת)
  * Asota (אסותא)
  * Behazdaha (בהצדעה)
  * Beyahad (ביחד)
  * Nofshonit (נופשונית)
  * Shavee (שווה)
  * Shupersal (שופרסל)

</details>

Your customers can split payments between multiple gift cards of different brands: up to five gift cards in a single purchase. If the funds available on gift cards are not enough to cover the transaction amount, the customer can add the missing funds using their regular credit card.

When the customer enters a gift card number, Hyp's payment page validates the number based on the card brand's prefix and numbering conventions.

## Prerequisites

Set up merchant accounts with all gift card providers (Finitione, Multipass, Rav-Arnak) that you want to enable for your customers.

Once this is done, [contact your Hyp representative](mailto:sales@hyp.co.il) to have gift cards enabled in your terminal. Let your Hyp representative know which gift card providers you have merchant accounts with.

## Payment page integration

As soon as gift cards are enabled in your terminal, the **Gift Card** button will appear on your payment pages by default.

However, there are several considerations about gift cards to keep in mind.

### Capture transactions only

Gift cards are only supported in the [regular payment page flow](/enterprise/payment-page-integration/integrating-hyps-payment-page-and-accepting-payment.md) that performs a capture transaction (J4) and sets the `mpiValidation` parameter to `AutoComm`.

This means [two-phase commits](/enterprise/two-phase-commits/overview.md) and [tokenization](/enterprise/additional-payment-scenarios/tokenization.md) are unavailable for payments using gift cards. If your payment page request uses anything other than `AutoComm` for `mpiValidation`, the resulting payment page will not display the gift card button, and no error will be returned.

### Most gift cards can't be saved

Most gift card brands cannot be tokenized and [saved for future use](/enterprise/changing-the-default-payment-page-appearance/suggesting-to-save-credit-card-data.md). A notable exception is gift cards issued by Finitione, which behave like regular credit cards and can be saved.

### Separate transactions for each card

Each gift card redeemed on the payment page constitutes a separate transaction. If you need to perform a [refund or cancellation](/enterprise/additional-payment-scenarios/refunds-and-cancellations.md), it must be done separately for each transaction, using the respective `tranId` identifier.

### Inquiring about transactions

When performing [transaction inquiries](/enterprise/inquiring-transactions/overview.md), use `txId` to inquire about all transactions associated with a payment involving gift cards, and `tranId` to inquire about a specific transaction.

### All gift cards used are listed in invoices

[Invoicing](/enterprise/documents-and-invoicing/overview.md) works the same as with regular credit card transactions, with one exception. Since each gift card constitutes a separate transaction, when you [create an invoice](/enterprise/documents-and-invoicing/issuing-invoices.md), you need to retrieve the `tranId` for each transaction and then list them all, separated by spaces, inside the `invoiceAtranId` element:

```xml
<ashrait>
    <request>
        <version>2000</version>
        <language>ENG</language>
        <command>addCgInvoice</command>
        <addCgInvoice>
            <invoiceAtranId>119284861 119385811 119290774</invoiceAtranId>
            ...
        </addCgInvoice>
    </request>
</ashrait>
```

In the payment details, the recipient will see the specific gift card or cards used, as well as the credit card if one was also used.

### Hiding gift cards from the list of payment methods

If you want to hide gift cards from the list of additional payment methods, the [usual method for hiding payment methods](/enterprise/changing-the-default-payment-page-appearance/hiding-payment-methods.md) does not apply. Instead, you need to [hide the HTML element](/enterprise/changing-the-default-payment-page-appearance/hiding-other-elements-from-the-page.md) that contains the gift card button:

```xml
<paymentPageData>
    <ppsJSONConfig>
        {
          "uiCustomData": {
            "customStyle": "#cg-gcs-btn-select{display: none;}"
          }
        }
    </ppsJSONConfig>
</paymentPageData>
```

Alternatively, if gift cards are the only additional payment method on your payment page, you can hide the entire section of additional payment methods like this:

```xml
<paymentPageData>
    <ppsJSONConfig>
        {
          "uiCustomData": {
            "customStyle": "#cg-pm-title,#cg-pm-options{display: none;}"
          }
        }
    </ppsJSONConfig>
</paymentPageData>
```

## Payment experience

Here's what the gift card payment button looks like on the payment page:

![A button for gift cards on a payment page](/files/Zc7oUeTfEFgdT3ojbW8D)

When the customer clicks the button, Hyp displays a list of supported gift card brands:

![The list of supported gift cards](/files/aO0pvZpSQKDsy91ffrOx)

Clicking a brand opens a form to enter the gift card number and any additional required fields:

![A form to enter gift card details](/files/sSO4BdJrRr6mdbmCUP3w)

After validating the entered details, Hyp shows a list of gift cards used so far. The customer can adjust the amount applied from each card or add more cards (up to five in total):

![The list of gift cards used](/files/HnIcac3SOF1sn1mQ2dUn)

After clicking **Continue**, if the total amount due is not fully covered by the selected gift cards, the customer can pay the remaining balance with a regular credit card.

Once the customer has completed all fields and clicked **Pay**, the payment is processed, and either the success page or the error page is displayed.

This flow works the same whether you use a full-page redirect or display the payment page in an iframe.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.hyp.co.il/enterprise/available-payment-options/gift-cards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
