# Accepting Digital Wallets

Hyp currently supports the three major digital wallets used in Israel: [Apple Pay](https://www.apple.com/apple-pay/), [Google Pay](https://pay.google.com/), and bit.

These wallets let your customers breeze through checkout without having to type in their credit card details. It's a faster way to pay that usually leads to better conversion rates for your business.

For all digital wallet transactions, the card number Hyp receives and passes to you isn't the actual credit card number. Instead, it's a single-use token generated by the digital wallet provider. Because these tokens are single-use and transaction-specific, they can't be used for [recurring payments](/pay/advanced-features/recurring-payments.md).

You should avoid storing digital wallet card numbers or relying on them for things like analytics or customer identification. Since they don't consistently represent the same customer or card, they aren't reliable for tracking.

{% hint style="info" %}
This page describes how to integrate with digital wallets via Hyp Pay's payment page, which is the most common integration method. If you want to integrate Apple Pay or Google Pay using a native SDK instead, please get in touch with Hyp support by phone (\*6488, extension 3) or via [WhatsApp](https://wa.me/972732345000) for assistance.
{% endhint %}

## Google Pay

### Prerequisites

To use Google Pay, you need to enable it in your Hyp Pay account:

1. Log in to your Hyp Pay account.
2. Click **Google Pay** under **הגדרות** (**Settings**).
3. In the **Google Pay קבלת תשלום באמצעות** (**Accept payment with Google Pay**) section, select **אפשר תשלום באמצעות Google Pay בדף התשלום** (**Enable Google Pay on the checkout page**).
4. Click **שמור הגדרות** (**Save changes**).

### Payment page integration

Once you've enabled it in your account, the **Google Pay** button will pop up on your payment pages automatically. You don't need to make any API changes to start accepting Google Pay.

If you are using an iframe to show the payment page, make sure your `<iframe>` tag includes the `allow="payment"` attribute and the `allowpaymentrequest` property. This lets the browser show the Google Pay UI correctly.

Keep in mind that Google Pay only works on [supported devices](https://developers.google.com/pay/issuers/overview/supported-devices).

### Payment experience

Here's the Google Pay button on a standard payment page:

![Google Pay button](/files/H2uJsWSQvaSO4Obf3ky1)

When a customer clicks the button, a modal pop-up appears and the rest of the page grays out:

![Google Pay modal pop-up](/files/yddvdfLtcOjBuM2DMabS)

Once they hit **Pay**, we'll process the transaction and show them the success or error page.

## Apple Pay

### Prerequisites

To use Apple Pay, you need to enable it in your Hyp Pay account:

1. Log in to your Hyp Pay account.
2. Click **Apple Pay** under **הגדרות** (**Settings**).
3. In the **Apple Pay קבלת תשלום באמצעות** (**Accept payment with Apple Pay**) section, select **בדף התשלום Apple Pay אפשר תשלום באמצעות** (**Enable Apple Pay on the checkout page**).
4. Click **שמור הגדרות** (**Save changes**).

### Payment page integration

How you integrate Apple Pay depends on whether you're redirecting customers to a full payment page or embedding it in an iframe.

In both cases, Apple Pay only shows up when the customer is using Safari on a [supported device](https://support.apple.com/en-il/102896).

You'll be able to see the Apple Pay button in your test environment, but remember that the full payment workflow only works in production.

#### Redirect integration

If you use a full-page redirect, you're all set! The **Apple Pay** button will show up automatically once you enable it in your account settings.

#### Iframe integration

If you're using an iframe, you'll need to complete a few extra steps:

1. Verify your domain:
   1. Create a folder named `.well-known` in your web server's root directory.
   2. Download the [Apple Pay verification file](https://pay.hyp.co.il/cgi-bin/yaadpay/applepay_main.pl?action=DownloadVerFile) and save it in that folder. It needs to be reachable at `https://your-merchant-website.com/.well-known/apple-developer-merchantid-domain-association`.
2. Add the integration script in the `<head>` section of the page where you've embedded the iframe:

   ```html
   <script src="https://pps.creditguard.co.il/plugins/applePayOnIframe.js"></script>
   ```
3. Register your domains:
   1. In your Hyp Pay account, click **Apple Pay** under **הגדרות** (**Settings**).
   2. Click **הוסף דומיין חדש** (**Add a new domain**).
   3. Enter your domain (like `your-merchant-website.com`, without the `https://`) and click **הוסף דומיין** (**Add**). If you have staging or dev environments, make sure to add those domains too.
4. Make sure your hosting setup allows the necessary connections. If you're using Nginx, your configuration might look something like this:

   ```nginx
   add_header X-Frame-Options "SAMEORIGIN";
   add_header Access-Control-Allow-Origin *;
   add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS, PUT, DELETE, PATCH';

   location ~ .(?!well-known).* {
       deny all;
   }
   ```

### Payment experience

Here's what the Apple Pay button looks like on the payment page:

![Apple Pay button](/files/cPVKAlKI91z0YDfiCtuC)

When a customer clicks the **Apple Pay** button, they'll see an extra field for their **Personal ID**.

After they enter their ID and click **Pay**, the Apple Pay overlay pops up so they can choose their card and confirm the payment with Touch ID, Face ID, or their passcode.

Once they confirm, we'll process the payment and redirect them back to your website.

## bit

### Prerequisites

To accept [bit](https://www.bitpay.co.il/) payments, you'll need to enable them in your Hyp Pay account:

1. Log in to your Hyp Pay account.
2. Click **Bit** under **הגדרות** (**Settings**).
3. Enter your business details in the registration section and click **אני רוצה להצטרף** (**I want to join**).
4. Hyp will email you with a form to create a bit merchant account. Fill it out and send it back.
5. Preparing your bit merchant account may take a few days depending on your business activity and type of business. Once your account is ready, you'll receive a confirmation email.

As soon as you get that email, bit is active and the button will show up on your checkout page automatically.

### Payment page integration

Once bit is active, the **Pay with bit** button appears by default. No API changes or extra coding needed on your end.

Just a heads-up: the full bit payment flow only works in the production environment.

### Payment experience

Here's how the bit button looks on the payment page:

![bit payment button](/files/GdzjVgikzqzUfz2o1rWb)

When a customer chooses bit and clicks **Pay**, a bit overlay appears with a QR code. They need to scan this code with their bit app to finish the payment. They have 10 minutes to complete the scan.

Once the payment is done in the app, the payment page automatically redirects back to your website. If the time runs out, the customer can try again or pick a different payment method.

### Considerations

* The **Pay with bit** button won't show up for transactions over ₪5,000, as that's bit's maximum limit.
* bit payments only work with Israeli New Shekels (NIS).
* bit doesn't support installments. If a customer tries to pay in installments, bit will still charge the full amount in one go.
* Advanced features like [two-phase commits](/pay/advanced-features/two-phase-commits.md) (J5) or [postponed transactions](/pay/common-use-cases/postponing-transactions.md) aren't supported with bit.

## Troubleshooting

If you're having trouble with your iframe or seeing errors about "browser context," try these quick fixes:

* Make sure your iframe has the `allow=payment` attribute.
* Explicitly add the `allowPaymentRequest` property to your iframe code.


---

# 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/pay/common-use-cases/digital-wallets.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.