Gift Cards
Hyp supports a variety of gift card brands used in Israel, issued by Finitione, Multipass, or Rav-Arnak.
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 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 that performs a capture transaction (J4) and sets the mpiValidation parameter to AutoComm.
This means two-phase commits and tokenization 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. 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, it must be done separately for each transaction, using the respective tranId identifier.
Inquiring about transactions
When performing transaction inquiries, 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 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, you need to retrieve the tranId for each transaction and then list them all, separated by spaces, inside the invoiceAtranId element:
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 does not apply. Instead, you need to hide the HTML element that contains the gift card button:
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:
Payment experience
Here's what the gift card payment button looks like on the payment page:
When the customer clicks the button, Hyp displays a list of supported gift card brands:
Clicking a brand opens a form to enter the gift card number and any additional required fields:
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):
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.
Last updated
Was this helpful?