Help Center

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 <span class="u-richtext-element">Customer indicates amount</span>.

You can add the parameters <span class="u-richtext-element">amount</span> for the payment amount, <span class="u-richtext-element">client_name</span>, and <span class="u-richtext-element">client_email</span> 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 <span class="u-richtext-element">client_name</span> and <span class="u-richtext-element">client_email</span> 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

<span class="u-richtext-element">lang</span> — 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).

<span class="u-richtext-element">items</span> — 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.

<span class="u-richtext-element">client_tehudat</span> — 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 <span class="u-richtext-element">add_field</span>, 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 <span class="u-richtext-element">add_field=any_text</span> 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 <span class="u-richtext-element">add_field</span> to a string with multiple parameters and parse them on your server side. For example, <span class="u-richtext-element">add_field=par1-value1,par2-value2</span>.

If Webhook sending is enabled for the link, the <span class="u-richtext-element">add_field</span> parameter will be included in the request body.

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.

Example in action:

You can view the source code for the forms used in the video at the following links:

https://allpay.to/demo/snippet-example-1.html

https://allpay.to/demo/snippet-example-2.html

Using ChatGPT, you can customize the functionality of the forms to suit your specific needs.

After payment, customer receives an email notification about the payment. Make sure this feature is enabled in <span class="u-richtext-element">Settings</span> -> <span class="u-richtext-element">Notifications</span>

An email notification by itself is not a receipt.

If you enable integration with the EasyCount electronic receipt system, the receipt will be created automatically, and a button for downloading it will be added to the notification.

Example of email notification

To accept online payments, you must have a website or a business page on a social network that provides information about your business.

Website Requirements

<span class="u-richtext-counter">1</span> The website content must clearly explain what you sell.

<span class="u-richtext-counter">2</span> Your website must include the following business contact details:

• Phone number (or WhatsApp), 
• Email address 
• Physical address (city, street, and house number)

If your business does not have a physical address, provide the one listed in your business registration certificate (Ishur Osek Patur/Murshe).

<span class="u-richtext-counter">3</span> Include a Privacy Policy and Terms of Service for selling products or providing services in English or Hebrew.

Privacy Policy template: ENG, HEB

Terms template (product sales): ENG, HEB

Terms template (service provision): ENG‍

These templates are examples. Allpay does not provide legal advice!

The website can be in any language and domain zone, but the Privacy Policy and Terms of Service must be in English or Hebrew.

<span class="u-richtext-counter">4</span> If your business requires licensing, display the relevant licenses and certificates on your website.

Social network page requirements

<span class="u-richtext-counter">1</span> The content must clearly indicate that the social network page is used for business purposes and specify the services or products offered.

<span class="u-richtext-counter">2</span> The page must include easily visible contact details:

• Phone number
• Email address
• Physical address (city, street, and house number).

If requirements are not met

Failure to meet these requirements may result in your request to process payments being denied.

Allpay, like any payment service in Israel, depends on an external regulator for issuing permissions. We do our best to help our clients obtain approval, but this is only possible with your cooperation.

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.

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

How to Use

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

Demo

В свойствах отклоненных платежей можно увидеть название ошибки и понять причину.

Коды ошибок

20004 Refusal by credit company. Please try a different card

Платёж не был одобрен банком, выпустившим карту. Для израильских карт это чаще всего связано с превышением кредитного лимита (мисгерет) или недостатком средств на счёте при оплате дебетовой картой. Для иностранных карт банк мог отклонить платёж, сочтя его подозрительным. В обоих случаях держателю карты следует обратиться в свой банк, чтобы уточнить причину отказа.

20010 Payment is not approved for debit cards

Попытка осуществить платеж в рассрочку по дебетовой карте. Такие платежи возможны только по кредитным картам и только выпущенным в Израиле. Больше информации.

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 <span class="u-richtext-element">Settings</span> -> <span class="u-richtext-element">API Integrations</span> 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 <span class="u-richtext-element">API</span> tag on it. By clicking on the tag, you can view headers and body of the associated request and response.

1. Open this link in Safari: Allpay App
2. Go to your browser's menu and select Add to Home Screen.
3. Save it.

Some types of businesses are considered high-risk and credit companies require more thorough verification when connecting a payment system.

In particular, these include advice in the field of finance and health, the sale of medicines and dietary supplements, the sale of tobacco and smoking mixtures, trading on the stock exchange, esoterics and spiritual practices, dating sites, and some others.

Before being approved to accept payments, such a business must undergo full verification, which includes security checks and signing a physical agreement with a credit company (Isracard, CAL, or MAX).

Verification process

<span class="u-richtext-counter">1</span> Fill in registration form.

<span class="u-richtext-counter">2</span> We will pre-check the data provided, request additional documents if necessary, and let you know if any changes to your site are required.

For activities in the field of health, psychology, coaching and business consulting, we will ask for a higher education diploma in the relevant field and certificates of completion of specialized programs.

<span class="u-richtext-counter">3</span> We will ask you to pay 150 ILS. These are the costs we bear for connecting each business, regardless of whether it is approved by the credit company or not.

The funds are non-refundable. But if the business is approved, they will be credited for the first three months of using Allpay. At the same time, we will do everything possible to ensure that approval is granted, and we expect maximum assistance from you.

<span class="u-richtext-counter">4</span> We will transfer the data to the credit company, which will verify it and appoint an agent to meet you and sign a physical contract. The review takes from one week to a month.

<span class="u-richtext-counter">5</span> An agent will contact you to arrange a meeting and sign a contract.

Often, an agent only speaks Hebrew, but all you have to do is arrange a meeting where you don't need to have a dialogue.

In some cases, verification can be done remotely by filling out an online form and recording a video. However, this depends on the credit company's decision.

<span class="u-richtext-counter">6</span> Usually, the agreement is approved within a week after signing, after which it is possible to accept payments via Allpay.

We will fully support you in this process and provide full support, waiting for your cooperation. However, we reserve the right to refuse at any stage.

List of special business categories

Spiritual practices

Dating

Investments

Financial, health and career advice

Drugs and supplements

Alternative medicine

Tobacco, smoking mixes

Stock exchange trading

Esotericism

And some others.