Help Center

Test mode allows you to test payments without processing real transactions. This mode is typically used by developers during website development.

For API integrations

Test mode is activated separately for each integration in the <span class="u-richtext-element">Settings</span> --> <span class="u-richtext-element">API Integrations</span> section.

The list of test cards is available in the API documentation.

For payment links

‍Test mode is also available for payment links created in the Allpay dashboard.

You can activate it in the settings of each individual payment link. Test card details will be provided on the payment page.

Test receipts

To generate test receipts in test mode, you need to enter the API keys from the test account of the corresponding service (e.g., Morning or EasyCount) in the module settings.

VAT 0% may apply to sales to foreign residents.

According to the law, a foreign resident is defined as an individual who permanently resides outside of Israel or a legal entity registered abroad.

When processing a payment, there is no reliable technical way to determine whether the payer is a foreign resident. Geolocation is unreliable, as an Israeli resident may be abroad at the time of payment.

Since the business is in direct contact with the customer to whom it sells goods or services and reports to the tax authorities, the business is responsible for correctly issuing the tax invoice.

Automatic application of VAT 0%

A relatively reliable approach is to rely on the country in which the customer's card was issued (with the understanding that this method also has exceptions).

By default, Allpay includes a built-in feature that generates receipts with 0% VAT for payments made with foreign cards.

For technical reasons, the system can determine whether a payment was made with a foreign card only after the payment is actually completed. Therefore, if 18% VAT is set in the payment link settings, the system will automatically apply 0% instead of 18% after the payment is completed.

Since the tax receipt (hashbonit mas/kabala) is generated after the payment is completed, the receipt will show 0% VAT, and the service price will be equal to the final payment amount.

Example:

Payment with Israeli card:

Service — 100 NIS

VAT — 17 NIS

Total — 117 NIS

Payment with foreign card:‍

Service — 117 NIS

VAT — 0 NIS

Total — 117 NIS

We recommend in payment link settings set <span class="u-richtext-element">VAT mode</span> → <span class="u-richtext-element">included in price</span> and display prices with VAT already included. This will appear more natural to international customers.

Applying VAT for foreign cards

If a business does not want to rely on determining foreign residency based on the card’s country, it is necessary to activate the checkbox <span class="u-richtext-element">Charge VAT on foreign cards</span> in <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Company</span>. This will apply VAT to foreign cards the same way as to Israeli cards.

To export transactions for a specific period or of a specific type, first apply a filter and then click the export button. You can also find the required transactions using search and then export them.

Don’t forget to reset applied filters so you don’t miss any payments.

You can request the customer's phone number, address, website, or other information by adding additional fields to the payment page.

This applies to payment links created through Allpay. If you are connected via the API, field setup is done on your website.

Adding input fields for payment links

1. Activating additional input fields  

Activate additional input fields in the <span class="u-richtext-element">Settings</span> ➙ <span class="u-richtext-element">Payment Links</span> section.  

2. Adding fields  

‍When creating a payment link, click <span class="u-richtext-element">Advanced</span>, then <span class="u-richtext-element">Manage Fields</span>. Add the required fields and their names, then click "Save".

The added fields will be available for ALL payment links.

3. Activating fields‍

Activate the toggle for the fields you want to display on the payment page for THIS SPECIFIC payment link.

If the field is also marked as required, the customer will not be able to proceed with the payment without filling it in.

4. After payment‍

The information entered by the customer is displayed in the transaction details on the main payment page. It is also included in payment notifications sent to Telegram, your email, and the customer.  

Field labels translation

Field labels can be translated into all available languages.

In the <span class="u-richtext-element">Field management</span> section, select a language using the language switcher and add a translation for each field.

If a translation is not added for a specific language, English will be used as the default language. Therefore, we recommend always adding an English translation.

How to insert a link  

HTML tags are allowed in input field names: <span class="u-richtext-element">a</span> for links, <span class="u-richtext-element">b</span> for bold text, <span class="u-richtext-element">i</span> for italics, and <span class="u-richtext-element">span</span> for applying custom styles.  For example, to insert a link into the name of a checkbox field, the name should look as follows:

Agree with <a href="https://allpay.co.il/terms">the terms</a>  

The result will look as follows:

«Agree with <a href="https://allpay.co.il/terms">the terms</a>»

Video tutorial

What is the request limit?
60 requests per minute. Contact support if you need a higher limit.

The Apple Pay button allows for quick payments using iPhone, Mac, and other Apple devices.

To make the button appear on the payment page, you need to activate the module in the <span class="u-richtext-element">Modules</span> --> <span class="u-richtext-element">Apple Pay</span>.

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

Exceptions

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

• on payment pages with an installment option if the customer selects more than one installment payment;
• on payment pages of the "subscription" type.

Shipping address

If the customer does not have a shipping address saved in their Apple Wallet, Apple Pay may request it during the payment process. Without this information, the payment may not be completed.

The address must be provided even if no physical delivery takes place — this is due to the way Apple Pay works in the current implementation.

Unsuccessful payments with the name «Applepay Payer»

Apple Pay transmits the customer's name to us only after a successful payment. Pressing the Apple Pay button initiates the payment process, and a transaction appears with the name "Applepay Payer" and the status "Unpaid". The customer then confirms the payment on their device, Apple Pay processes it, and returns the customer's name to us, which we display instead of "Applepay Payer", while the transaction status changes to "Paid successfully".

However, if the payment was not confirmed on the device or was not approved by Apple Pay, the customer's name will remain "Applepay Payer", and we will not see the reason for the decline.

In cases where the customer proceeds to payment from your website and has entered their name at the checkout stage, we will display it instead of "Applepay Payer".

Strong Customer Authentication (SCA) is a mandatory requirement of the European Union aimed at increasing payment security. It requires users to confirm online payments using at least two of the following three independent authentication factors:

1. ‍Something the user knows → password, PIN code.‍
2. ‍Something the user has → phone, bank card, token.
3. ‍Something the user is → biometrics (fingerprint, Face ID, voice).

This means that simply entering a password or an SMS code is not considered sufficient authentication unless it is accompanied by a second factor.

3D Secure as part of SCA

3D Secure (3DS) is a technology designed to protect online payments. It allows banks to request additional customer authentication when paying with a card online.

With 3DS, a bank may require two authentication factors, for example:

• SMS code + online banking password.
• Push notification in the banking app + biometrics.
• Face ID / Touch ID through the banking app.

How Apple Pay complies with SCA

Apple Pay automatically complies with SCA requirements because it uses:

• Biometrics (Face ID, Touch ID) → the “something you are” factor;
• Device (iPhone, Apple Watch) → the “something you have” factor.

When paying with Apple Pay, authentication occurs at the device level, so additional confirmation via 3DS is usually not required.

When creating a payment link, you can enable the option for installment payments by specifying the maximum number of payments the customer can choose.

If the customer selects two or more payments, the total amount will be charged to their card and transferred to you in monthly installments until the full amount is paid.

Installment payments work 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.