Help Center

Found 100 out of 200

Apple Pay

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 Modules --> Apple Pay.

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.

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".

Keep reading

Payment methods

Payment links

VAT for payments from abroad

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%

If a business wants VAT 0% to be automatically applied in invoices, a relatively good method is to rely on the country in which the payer’s card was issued (with the caveat that this method also has exceptions).

Therefore, Allpay provides a function to generate invoices with VAT 0% for payments made with foreign cards. However, for technical reasons, the system can only determine whether a payment was made with a foreign card after the transaction is completed.

Since the tax invoice (heshbonit mas/kabala) is generated after the actual payment, the system will indicate VAT 0% in the invoice, and the service cost will be equal to the final 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 setting VAT included in price in Settings → Company and displaying prices with VAT already included. This will appear more natural to international customers.

VAT collection 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 Charge VAT on foreign cards in Settings → Company. This will apply VAT to foreign cards the same way as to Israeli cards.

Keep reading

Documents

Hosted Fields: how to embed card input fields on a website

Hosted Fields allow you to embed card input fields into your website or application, fully adapting them to your system's design. They create a seamless interface experience and eliminate the need to redirect customers to an external payment page. This enables payments to be processed directly on your website or in your application, improving usability and conversion rates.

This feature is currently in development. Updates will be announced in the Telegram channel.

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

Keep reading

API

Additional input fields on the payment page

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 Settings ➙ Payment Links section.

2. Adding fields

‍When creating a payment link, click Advanced, then Manage Fields. 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 name translation

For payment links in multiple languages, field names can be translated.

In the Manage Fields section, switch the language using the language selection menu and add a translation for each field.

How to insert a link

HTML tags are allowed in input field names: a for links, b for bold text, i for italics, and 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

Keep reading

Payment links

API testing tools

To check requests for payment creation via API, two methods are available.

Allpay API Tester

With Allpay API Tester, you can perform requests for new payment, refund, create subscription, and other operations in both live and test modes, emulating requests from your server.

Simply insert the API login/key of any integration created in the Settings -> API Integrations section, and fill out the form fields according to the API documentation.

If test mode is enabled for the integration, requests will be executed in the test environment.

API Tag

Each transaction processed via the API has an API tag on it. By clicking on the tag, you can view headers and body of the associated request and response.

Keep reading

API

Teudat Zehut (Social ID number) on the payment page

Israeli citizens are required to enter their Teudat Zehut number, which is included in the payment receipt.

Since payments can come from outside Israel, as well as from tourists or Israeli residents without a Teudat Zehut, the payment page includes a checkbox labeled “I am not an Israeli citizen”, which hides the Teudat Zehut input field.

If the payment page is accessed from outside Israel, this checkbox is enabled by default.

Hiding the field for payment links

The Teudat Zehut input field and the “I am not an Israeli citizen” checkbox can be completely hidden from the payment page. This is useful for those accepting payments exclusively from abroad.

To enable this, go to Settings --> Payment Links and activate the switch Hide Teudat Zehut input field.

Make sure to consult your accountant before enabling this setting.

Hiding the field for API Payments

‍To pass the Teudat Zehut number or hide this field from the payment page, use the client_tehudat parameter as described in the API documentation.

‍

Keep reading

Payment links

Documents

API

Test Mode

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 Settings --> API Integrations 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 --> Payment Links --> Test Mode.

Once activated, all payment links will operate in test mode. Test cards are provided on the payment page.

Receipts are not generated in test mode. Don't forget to disable test mode to start accepting real payments.

‍

Keep reading

Integrations

Payment links

API

Passing parameters through the payment link URL

This feature allows you to manage the payment amount via URL, pass customer data filled out on your platform to the payment page, and control the customer's path after a successful payment.

First, you need to create a payment link in the Allpay dashboard and set its type to Customer indicates amount.

You can add the parameters amount for the payment amount, client_name, and client_email for customer data to the payment link URL.

For example, https://allpay.to/~pay/dynamic?amount=100&client_name=Jason%20Statham&client_email=jason@go.com

‍
If the values for the parameters client_name and client_email are not specified, we will request them from the customer during payment.

This way, you can use a single payment link for all customers, specifying an individual amount for each of them.

Product name

The product or service name cannot be transmitted this way, as it creates opportunities for manipulation. For example, it could allow an altered or inappropriate product name to be automatically included in the receipt generated after payment.

Parameters lang and client_tehudat

lang — language of the payment page. It is auto-detected by the customer's browser language, but you can control it by passing values AR (Arabic), EN (English), HE (Hebrew), or RU (Russian).

items — name and quantity of the product. If not provided, the name specified when creating the payment link will be displayed. The ability to pass this parameter through the URL is currently under development.

client_tehudat — the Tehudat Zehut (Social ID number). This is included in the payment receipt. To hide this field from the page, pass nine zeros.

Parameter add_field

You can also use the parameter add_field, the value of which will be passed unchanged in the redirect URL after a successful payment (see the article Redirect after payment for how to set up the redirect URL).

For example, https://allpay.to/~pay/dynamic?amount=100&add_field=any_text

In the example above, the parameter add_field=any_text will be passed unchanged in the redirect URL after payment. This allows you to track conversions, direct the customer to the desired stage of your chatbot funnel, and perform other necessary actions after payment.

If needed, you can set the value of add_field to a string with multiple parameters and parse them on your server side. For example, add_field=par1-value1,par2-value2.

Video tutorial

Creating payment forms

Using this approach and basic web development skills, you can create payment forms for placement on your website. These forms do not replace full capacity of our API but provide a simple and convenient solution for accepting payments.

You can allow customers to select product modifications or quantities, calculate the total based on selected options, and redirect the customer to proceed the payment.