Help Center

In <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Team</span> you can add employees as users of your Allpay account.

Access permissions

The <span class="u-richtext-element">Team</span> section is available only to the business owner. Only the owner can add users, edit their details and manage access.

Users you add have access to all other sections of the account. They cannot add other users or edit their details. Custom access permissions are not currently available.

Adding a user

1. Open <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Team</span> and click the plus button.
2. Enter the user’s full name and position on the team.
3. Add at least one contact for signing in: an email address, phone number or Telegram.

You can add multiple contacts, including several of the same type, such as multiple email addresses. The same contact cannot be linked to different users.

Verifying contacts

Each contact you add must be verified within 48 hours. To do this, the user must sign in to Allpay using that contact.

Allpay does not send automatic invitations, so let the employee know that they have been given access. You can copy the sign-in link from the user’s profile.

If the user does not verify the contact within this time, the business owner can extend the deadline by another 48 hours by clicking the corresponding button.

Updating details

The business owner can edit a user’s details by clicking “Edit” on the user’s card.

The business owner’s details and contacts can only be updated if the owner personally contacts Allpay Support.

Disabling a user

A user can sign in to the account while the “Account active” toggle on their card is enabled.

If you turn it off, the user will lose access to the account and be automatically signed out. If they previously connected the account to an AI assistant through MCP, that access will also be revoked.

The business owner cannot be disabled.

Activity history

You can view all users’ activity in the “Activity log” tab.

Access to multiple companies

If the same user contact is listed for several companies, the user can switch between them in the settings menu or the “Profile” section.

Contacting support

When contacting Allpay Support about your account, use a contact listed under your name in the “Team” section.

If a request comes from a contact that is not listed for the business owner or an employee in the “Team” section, Allpay Support may decline to disclose sensitive account information.

A J5 transaction is a two-step payment process that begins with a pre-authorization. In the first step, the specified amount is reserved (held) on the buyer’s card for up to 168 hours (7 days) without actually charging the card.

To charge the reserved funds, the seller must initiate a charge request within that time frame and within the reserved amount. If the charge is for a smaller amount, the remaining balance is automatically released.

The term “J5” is used in Israeli payment systems as an internal code to refer to this type of transaction.

Use Cases

Delivery orders – The amount is reserved when the order is placed and charged after delivery is confirmed.

Variable price orders – For example, when buying products sold by weight (meat, fruits, vegetables), the final price is determined after weighing.

‍Pay as you go – The customer uses a service within a limit, and the final amount is calculated at the end.

Car rentals & hotels – The amount is reserved to cover possible damages or extra expenses.

Custom-made products – When ordering custom furniture or jewelry, the amount is reserved at checkout and charged when the product is ready.

Limitations

The charged amount cannot exceed the reserved amount.

Charging is allowed only once. Any attempt to charge again or after 168 hours will result in an error.

Supported Payment Methods

Both Israeli and international credit and debit cards are supported.

Quick payment methods (Apple Pay, Google Pay, Bit) are not supported for J5. These buttons will be hidden on the authorization page.

Important to know

An authorization may look like an actual payment to the customer: some card issuers send an SMS in the same format as they do when a card is charged. However, in the card issuer’s online account, the transaction is usually marked as “Amount not final” or something similar.

If you subsequently charge less than the authorized amount, the remainder is released automatically — there is no need to wait until the 168-hour period expires. However, the card issuer may need a few hours to update the transaction details and make the unused amount available to the customer again.

How to Use

J5 functionality is available to developers via the Allpay API: view API documentation.

Demo

When creating a payment link, you can enable installment payments and set the maximum number of installments — up to 12. The customer can choose how many installments to split the total into, within the limit you set.

If the customer chooses two or more installments, their card will be charged and you will receive the funds in monthly installments until the full amount is paid.

There is no additional installment fee for either the business or the customer. If you want to receive the full amount upfront, you can activate the “Installments upfront” service, which carries an additional fee.

Installment payments are available only with credit cards issued in Israel.

<span class="u-richtext-counter">1</span> Create a payment link

When creating the link, open the <span class="u-richtext-label">More</span> section, select <span class="u-richtext-element">Installments</span> as the payment type, and specify the maximum number of payments the customer will be able to choose.

<span class="u-richtext-counter">2</span> Send the link to the customer

On the payment page, the customer will see an option to choose the number of payments. If they leave it as one payment, the full amount will be charged immediately.

Example

For a service costing 6,000₪, you enabled up to 5 installments. The customer chose to pay in 3 installments. At the time of payment, 2,000₪ will be charged, another 2,000₪ a month later, and the final 2,000₪ in the third month.

A receipt for installment payments is generated for the full amount immediately. The payment schedule is shown in the receipt.

If the installment payment fails

The most likely reasons are:

1. The customer’s card is not a credit card but a debit card;
2. The card was not issued by an Israeli bank;
3. The card’s credit limit (misgeret) is lower than the total payment amount.

Why installments are not available for foreign cards

Installment payments work only with Israeli credit cards within their credit limit. Since the system cannot manage credit limits of foreign banks, payment splitting on such cards is not supported.

This is a limitation of the financial system. In essence, installments are a form of credit. If the customer doesn’t have sufficient funds in their account, you (the business) still receive the next payment because the bank provides credit to the customer. Managing credit limits and collecting debts in case of nonpayment can only be guaranteed within the country.

If the customer cancels the card

You will continue receiving installment payments even if the customer closes or cancels the credit card that was used for the payment.

Each user can choose the language of emails and notifications from Allpay.

To change the language, go to <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Profile</span> and select an option in the “Email and notification language” field.

This setting applies to all emails and Telegram notifications about payments, payouts, and account status, as well as email newsletters.

Recipients outside your team

In the <span class="u-richtext-element">Notifications</span> section, you can specify email addresses and Telegram accounts for people who have not been added as users. They will receive notifications without access to the system.

These messages are sent in the system language selected in the company owner’s profile.

Customer emails

This setting does not affect customer emails. Customers receive payment emails in the language of the payment page.

In addition to shekels, Allpay supports payments in US dollars (USD) and euros (EUR).

Available payment currencies are shown in the <span class="u-richtext-element">Settings</span> ➙ <span class="u-richtext-element">Permissions</span> section.

By default, only payments in shekels are enabled after registration. To accept payments in USD or EUR, a separate permission must be requested.

Before requesting permission to accept payments in foreign currencies

In many cases, accepting payments in shekels is sufficient for a business. However, if your customers are located in Europe, the US, or other countries, it may be more convenient for them to view prices in USD or EUR.

For this purpose, we offer a special feature — currency display conversion. This means the customer will see the payment amount in, for example, euros, but the actual charge will be made in shekels based on their bank’s exchange rate.

No permission is required to use this feature — it is already available.
‍

More details: How to display the payment amount in USD or EUR.

We recommend using this solution in most cases.

Requesting permission to accept payments in foreign currencies

Go to <span class="u-richtext-element">Settings</span> ➙ <span class="u-richtext-element">Modules</span> and activate the “USD & EUR” module.

To activate it, you’ll need to upload a bank letter with the details of your foreign currency account. The letter must:

• Include the account number in IBAN format
• Include your name (or company name) and Teudat Zehut number (or company number)

Examples of bank letters:‍ Discount, Leumi, Hapoalim.

The confirmation letter can be downloaded from your bank's online account or obtained by visiting the bank in person. Letters that do not meet the above requirements will not be accepted.

The letter will be forwarded to the relevant credit company (Isracard or CAL — depending on how your business is connected to the Allpay system) with a request to approve foreign currency operations for your account.

The average approval time is 2–4 business days.

Allpay cannot guarantee approval for foreign currency transactions; however, we do everything possible to ensure that all our customers receive the necessary authorization.

When a business website has an English version and clearly displays products or services with prices in USD or EUR, it increases the likelihood of approval.

Once the approval is granted, the module status will change to “Active” and you will receive a notification. Please make sure notifications are enabled under <span class="u-richtext-element">Settings</span> ➙ <span class="u-richtext-element">Notifications</span>.

How to accept payments in foreign currency

When creating a payment link, you will see an option to switch the payment currency.

When creating payments via API, you can pass the values "USD" or "EUR" in the <span class="u-richtext-element">currency</span> parameter.

Commission and withdrawals

We do not charge any additional commission for foreign currency payments — standard rates apply.

However, your bank may charge a fee for receiving currency withdrawals. These withdrawals are made via the SWIFT system and go through a chain of three banks: our bank, your bank’s foreign branch, and your bank in Israel. The total fee per withdrawal can reach up to $40. We cannot influence this fee, but you can ask your bank for better terms.

For this reason, withdrawals are made starting from 100 USD/EUR. Any amount below 100 USD/EUR will be carried over to the next withdrawal.

Receipts

According to the law, official receipts (kabalot and heshbonit mas) must be issued in shekels.

Therefore, for foreign currency payments, the service price in the receipt appears in the payment currency, while the VAT amount and total are shown in shekels based on the current exchange rate. We use exchange rates from Google Finance.

If your customer needs a receipt showing the total amount in the original payment currency (not in shekels), a copy can be downloaded from the EasyCount or Morning dashboard.

Hosted Fields allow you to embed card input fields on your website or app, fully adapting them to the system's design. They create a seamless interface experience and eliminate the need to redirect the customer to an external payment page. This improves usability and conversion rates.

The input fields for the card number, expiration date, and CVC are represented as an iFrame. We provide the ability to fully customize their CSS and embed them on your site as a single frame.

Tutorial

Setup

<span class="u-richtext-counter">1</span> In the <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Integrations</span> → <span class="u-richtext-element">My sites</span> enable Hosted Fields for the required integration.

<span class="u-richtext-counter" id="domains">2</span> Click <span class="u-richtext-element">Hosted Fields settings</span> and specify the domains where Hosted Fields will be used. Enter each domain or subdomain on a separate line without “https://”, for example: <span class="u-richtext-element">mysite.com</span>. To allow all subdomains, use the <span class="u-richtext-element">*</span> wildcard, for example: <span class="u-richtext-element">*.mysite.com</span>.

If needed, adjust the CSS styles for the input fields.

<span class="u-richtext-counter">3</span> On your website’s payment page, place an iFrame, assign any custom value to its <span class="u-richtext-element">id</span> parameter, and in the <span class="u-richtext-element">src</span> parameter specify the payment URL (payment_url) returned by Allpay in response to a payment creation request (see Payment request section in the API Reference). Payment URLs can also be generated using the Allpay API Tester.‍

<span class="u-richtext-counter">4</span> Add the following script to the payment page:

1<script src="https://allpay.to/js/allpay-hf.js"></script>
2    <script>
3    let Allpay = new AllpayPayment(
4        {
5            iframeId: 'iframe_id',
6            onSuccess: function() { alert('Payment success'); },
7            onError: function(error_n, error_msg) { alert('Payment error: ' + error_n + ' (' + error_msg + ')'); }
8        }
9    );
10    </script>

‍

In the script, replace the following parameters with your own:

• <span class="u-richtext-element">iframeId</span> — the id value of your iFrame.
• <span class="u-richtext-element">onSuccess</span> — the handler for successful payment completion (what should happen after successful payment).
• <span class="u-richtext-element">onError</span> — the handler for payment errors. For example, you can display the payment error message on the page.

<span class="u-richtext-counter">5</span> To initiate the process, execute the function <span class="u-richtext-element">Allpay.pay()</span>, for example, by assigning it to the "Pay" button:

<button onclick="Allpay.pay();">Pay</button>

Installments

If you enabled the installment option for the customer when creating the payment by passing a value in the <span class="u-richtext-element">inst</span> parameter, a field for selecting the number of payments will automatically appear in the frame.

Quick Pay Buttons

Apple Pay and Bit buttons will not be displayed in preview mode or within the iFrame if they are not activated in the <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Modules</span>.

Additionally, these buttons are not displayed in test mode. As well as in live mode for installment or subscription payments.

Apple Pay button

For the Apple Pay button to work correctly, complete the following two steps:

<span class="u-richtext-counter">1</span>Add the <span class="u-richtext-element">allow="payment *"</span> attribute to the <span class="u-richtext-element">iframe</span> tag. Example:

<iframe id="myPaymentIframe" allow="payment *" src="..." >

<span class="u-richtext-counter">2</span>Upload the Apple Pay certificate to your domain’s server. The certificate and installation instructions are available in the Hosted Fields settings in your Allpay account.

<span id=google-pay>Google Pay button</span>

For the Google Pay button to work on your domain, the domain must be verified by Google, after which your Google Merchant ID must be added to the payment system.

<span class="u-richtext-counter">1</span>Create a profile in the Google Pay & Wallet Console.

<span class="u-richtext-counter">2</span>In Google Pay API → Web integration, enter your domain and select Gateway as the integration type.

<span class="u-richtext-counter">3</span>Upload screenshots of the buyflow from your website. After activating Google Pay in Allpay’s payment modules, the Google Pay button will appear but will not work yet. This will allow you to take screenshots of the Item selection, Pre-purchase screen, and Payment method screen.

For the Google Pay API payment screen, upload a screenshot of the error that appears when you click the button. For the Post-purchase screen, upload a screenshot of your successful payment page, even if it does not mention Google Pay.

<span class="u-richtext-counter">4</span>Submit your application and wait for Google’s approval. The review may take several business days.

<span class="u-richtext-counter">5</span>Copy your Google Merchant ID and enter it in the Hosted Fields settings in your Allpay account. It may take several days for the ID to be configured in the payment system, after which Google Pay payments will start working.

Your website may not pass Google’s review if it does not comply with the Google Pay and Wallet API's Acceptable Use Policy or the Google’s Terms of Service.

If you represent a nonprofit organization (amuta) follow Google’s instructions.

Embedding in a mobile app (WebView)

If you embed the payment page in a mobile app using a WebView (android.webkit.WebView or WKWebView), some payment methods may not work correctly. For example, Bit or 3D Secure verification may redirect the user to a payment or banking app using special links such as <span class="u-richtext-element">intent://</span>

Unlike a standard browser, WebView does not always handle these redirects automatically. As a result, the external app may not open, preventing the user from completing the payment.

We recommend opening the payment page using a system browser component:

• Chrome Custom Tabs on Android;
• SFSafariViewController on iOS.

These components behave similarly to a standard mobile browser and provide better support for redirects to payment and banking apps.

If you need to use WebView, handle navigation within the mobile app:

• open regular <span class="u-richtext-element">http://</span> and <span class="u-richtext-element">https://</span> links inside the WebView;
• pass links that use other schemes to the operating system so it can open the appropriate app;
• if the required app is not installed, use the provided fallback link to open the browser, App Store, or Google Play.

This limitation is related to how WebView handles external links, not to Hosted Fields itself.

The Google Pay button allows Android users to make quick payments from both mobile devices and computers.

To display the button on the payment page, activate the Google Pay module under <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Payment modules</span> → <span class="u-richtext-element">Google Pay</span>.

Exceptions

Since Google Pay does not allow card details to be saved for future charges, the button will be hidden:

• on payment pages offering installments if the customer selects more than one payment;
• on subscription payment pages.

Israeli ID Number

Google Pay does not provide the customer’s Israeli ID number, so it will not appear on the payment document. Asking customers to enter their Israeli ID number before clicking the Google Pay button defeats the purpose of quick payment. If collecting this number is mandatory, it is better not to use Google Pay.

Developers

If Google Pay is enabled in the payment module settings, the button will be displayed by default on payment pages created via the API. To hide the button, use the <span class="u-richtext-element">show_googlepay</span> parameter as described in the documentation.

If you use Hosted Fields to display the payment form directly on your website without redirecting the customer, your domain must be verified by Google before the Google Pay button can be used. Learn more in the Hosted Fields article.

The Google Pay button is not available in test mode.

The Apple Pay button allows customers to pay quickly using an iPhone, Mac, or another Apple device.

To display the button on the payment page, activate the module under <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Payment modules</span> → <span class="u-richtext-element">Apple Pay</span>.

The button is displayed only when the payment page is opened on an Apple device with a payment method added.

Exceptions

Since Apple Pay does not allow card details to be saved for future charges, the button will be hidden:

• on payment pages offering installments if the customer selects more than one payment;
• on subscription payment pages.

Israeli ID number

Apple Pay does not provide the customer’s Israeli ID number, so it will not appear on the payment document. Asking customers to enter their Israeli ID number before clicking the Apple Pay button defeats the purpose of quick payment. If collecting this number is mandatory, it is better not to use Apple Pay.

Unsuccessful payments under the name “Applepay Payer”

Apple Pay provides us with the customer’s name only after a successful payment.

Clicking the Apple Pay button initiates the payment process and creates a transaction under the name “Applepay Payer” with the status “Unpaid.” The customer then confirms the payment on their device. Apple Pay processes the payment and returns the customer’s name, which we display instead of “Applepay Payer,” while the transaction status changes to “Paid successfully.”

However, if the payment is not confirmed on the device or is declined by Apple Pay, the customer’s name will remain “Applepay Payer,” and we will not receive the reason for the decline. If the customer proceeds to payment from your website and entered their name during checkout, we will display that name instead of “Applepay Payer.”

Developers

If Apple Pay is enabled in the payment module settings, the button will be displayed by default on payment pages created via the API. To hide the button, use the <span class="u-richtext-element">show_applepay</span> parameter as described in the documentation.

The Apple Pay button is not available in test mode.

If you use Hosted Fields to display the payment form directly on your website without redirecting the customer, you will need to place an Apple certificate on your server before the Apple Pay button can be used. Learn more in the Hosted Fields article.