🔗

Link to plugin page: https://zeroqode.com/plugin/liqpay-payments-extended-plugin-for-bubble-1688393218658x883447829700292700

Demo to preview the settings

🔗

Bubble Editor: https://bubble.io/page?version=live&name=index&id=liqpaypaymentdemo&test_plugin=1587119712451x979557167010938900_current&tab=tabs-1

🔗

Live Demo: https://liqpaypaymentdemo.bubbleapps.io/

Introduction

The plugin is intended for payment through the LiqPAY system.

Connect the payment system LiqPay to your site.

Create a subscription

Unsubscribe

Easy Payment

Prerequisites

In order to interact with the plugin you'll need to get the PUBLIC and SECRET KEY from LiqPay.

How to setup

Go to LiqPay and click on the “Sign Up” or “Log in” button.

On the opened page, insert the phone number then click on the “Sign in” button.

⚠️

For successful account creation, you should have a Ukrainian number.

Fill out the form with the company name and email address then click on the “Create a shop” button.

On the right side of the home page, you will find the keys for the plugin settings.

Put the LiqPay test keys on the “PUBLIC_KEY - dev.” and “PRIVATE_KEY - dev.” inputs. And, put the LiqPay production keys on the “PUBLIC_KEY” and “PRIVATE_KEY” inputs.

PLUGIN ACTIONS DETAILED

CheckoutSubscription - This action should be used to create a subscription.

Fields:

Title	Description	Type
Amount	Payment amount. Example: 5, 7.34	number
Currency	Payment currency. Possible values: USD, EUR UAH, BYN, KZT. Additional currencies can be added at the company's request.	text
Description	Payment description.	text
Order ID	Unique purchase ID in your shop. The maximum length is 255 symbols.	text
Subscribe date start	Date of the first payment. Time must be specified in the following format 2015-03-31 00:00:00 UTC. If the past date is indicated - the subscription will be activated with the date and time of the request.	text
Subscribe periodicity	Period of payments. Possible values: month - once in a month; year - once in a year	text
Expired date	Expired date of payment into the following format 2015-03-31 00:00:00 UTC.	text (optional)
Language	Customer's language ru, uk, en.	text (optional)
Paytypes	Comma-separated methods for payment. Available methods: card, liqpay, liqpay, privat24, masterpass, masterpass, moment_part, cash, invoice, qr.	text (optional)
Result url	URL of your shop where the buyer would be redirected after completion of the purchase. Maximum length 510 symbols.	text (optional)
Info	Information to add details to payment. For example: "External information for payments”.	text (optional)
Product category	Product category in your shop. The maximum length is 25 symbols.	text (optional)
Product description	Product description in your shop. The maximum length is 500 symbols.	text (optional)
Product name	Product name in your shop. The maximum length is 100 symbols.	text (optional)
Product url	Product page address. The maximum length is 2000 symbols.	text (optional)
Server URL	URL API in your store for notifications of payment status change (server -> server). Maximum length is 510 symbols.	text (optional)

Returns:

Title	Description	Type
redirect to	The link for redirecting to payment page after the payment request.	text
error	The error message when the payment request fails.	text

CancelSubscription - This action should be used to cancel a subscription.

Fields:

Title	Description	Type
Order ID	Unique purchase ID in your shop. The maximum length is 255 symbols.	text

Returns:

Title	Description	Type
result	Payment status. Available values: error - Failed payment. Data is incorrect; failure - Failed payment; success - Successful payment; unsubscribed - Subscribed successfully deactivated.	text
error	The error message when the payment request fails.	text

CheckoutPay - This action should be used for a one time payment.

Fields:

Title	Description	Type
Amount	Payment amount. Example: 5, 7.34	number
Currency	Payment currency. Possible values: USD, EUR UAH, BYN, KZT. Additional currencies can be added at the company's request.	text
Description	Payment description.	text
Order ID	Unique purchase ID in your shop. The maximum length is 255 symbols.	text
Expired date	Expired date of payment into the following format 2015-03-31 00:00:00 UTC.	text
Language	Customer's language ru, uk, en.	text
Paytypes	Comma-separated methods for payment. Available methods: card, liqpay, liqpay, privat24, masterpass, masterpass, moment_part, cash, invoice, qr.	text
Result url	URL of your shop where the buyer would be redirected after completion of the purchase. Maximum length 510 symbols.	text
Info	Information to add details to payment. For example: "External information for payments”.	text
Product category	Product category in your shop. The maximum length is 25 symbols.	text
Product description	Product description in your shop. The maximum length is 500 symbols.	text
Product name	Product name in your shop. The maximum length is 100 symbols.	text
Product url	Product page address. The maximum length is 2000 symbols.	text

Returns:

Title	Description	Type
redirect to	The link for redirecting to payment page after the payment request.	text
error	The error message when the payment request fails.	text

Get Order Info - This action should be used for getting info about an order.

Fields:

Title	Description	Type
Order ID	Unique purchase ID in your shop. The maximum length is 255 symbols.	text

Returns:

Title	Description	Type
Status	The status of the order.	text
Error	The error message when the action request fails.	text
payment_id	The ID of payment in the LiqPay system.	number
liqpay_order_id	The ID of the order in the LiqPay system.	text
amount	The amount of order.	number

Check LiqPay Notification - This action should be used for checking and decoding the LiqPay callback on the server.

Fields:

Title	Description	Type
Signature	The unique signature parameter that was obtained from the LiqPay request.	text
Data	The data parameter that was obtained from the LiqPay request.	text

Returns:

Title	Description	Type
is valid	Returns the genuinity of response from server LiqPay.	yes/no
all params	Returns all parameters from the data parameter in the stringified object.	text
payment ID	The ID of payment in the LiqPay system.	number
action	The transaction type. Possible values: pay - payment, hold - amount of hold on sender's account, paysplit - splitting payments, subscribe - creation of a regular payment, paydonate - donation, auth - card preauth, regular - regular payment	text
status	The status of the order.	text
type	The type of payment.	text
paytype	The method of payment. Possible values card - card payment, liqpay - with liqpay account, privat24 - with privat24 account, masterpass - with masterpass account, moment_part - installments, cash - cash, invoice - to email, qr - qr code scanning.	text
order ID	The order ID payment.	text
LiqPay order ID	The ID of the order in the LiqPay system.	text
sender first name	The first name of the sender.	text
sender last name	The last name of the sender.	text
amount	The amount of payment.	number
currency	The currency of payment.	text
created date	The date of payment creation.	date

Workflow example

How to create a subscription

This example presents how to use the “CheckoutSubscription” action for subscription creation.

On the page, the following form from the “Input” elements is created to get all data for the “CheckoutSubscription” action and the button for click listener.

In the workflow, when the Button Buy now is clicked is called the “CheckoutSubscription” action.

The “CheckoutSubscription” action has the following settings.

After the “CheckoutSubscription” action, is called the “Open an external website” action with the following settings.

☝

The “Open an external website” action will be called if no error for the “CheckoutSubscription” action.

How to cancel a subscription

This example presents how to use the “CancelSubscription” action for subscription cancellation.

On the page, the following form from the “Input” element is created to get the “Order ID” for the “CancelSubscription” action and the button for click listener.

In the workflow, when the Button Cancel subscription is clicked is called the “CancelSubscription” action.

The “CancelSubscription” action has the following settings.

How to pay for an order

This example presents how to use the “CheckoutPay” action to fully pay an order.

On the page, the following form from the “Input” elements is created to get all data for the “CheckoutPay” action and the button for click listener.

In the workflow, when the Button Buy now2 is clicked is called the “CheckoutPay” action.

The “CheckoutPay” action has the following settings.

After the “CheckoutPay” action, is called the “Open an external website” action with the following settings.

☝

The “Open an external website” action will be called if no error for the “CheckoutPay” action.

How to set up the Callback

This example presents how to catch all order changes from LiqPay.

The CheckoutSubscription action has set up the Server URL field with the following URL. Copy the URL from the created backend workflow, after clicking the Detect Data button.

In the backend workflows, the following API workflow is created.

☝

Make sure your app is exposing a Backend Workflow.

💡

Check this tutorial from points 4 to 11 for the initialization of the Backend API workflow.

☝

After initialization, the API workflow will catch the signature and data parameters from LiqPay.

The created API workflow has the following actions.

Check LiqPay Notification action.

Create a new LiqPay Notification thing action.

Changelogs

Update 06.03.24 - Version 1.14.0

Added new field “Server Url" in the CheckoutPay action.

Update 15.02.24 - Version 1.13.0

Added Check LiqPay Notification action & Server URL field for CheckoutSubscription.

Update 05.01.24 - Version 1.12.0

Added "Get Order Info" action.

Update 12.09.23 - Version 1.7.0

Upgrade to node18.

Update 28.08.23 - Version 1.4.0

Updated fields documentation.

Update 28.08.23 - Version 1.3.0

Updated fields documentation.

Update 12.07.23 - Version 1.2.0

Updated description.

Update 07.07.23 - Version 1.1.0

Updated logo.

Update 07.05.20 - Version 1.0.0

Change instruction.

LiqPay Payments Extended

Demo to preview the settings

Introduction

Prerequisites

How to setup

PLUGIN ACTIONS DETAILED

Workflow example

How to create a subscription

How to cancel a subscription

How to pay for an order

How to set up the Callback

Changelogs

Update 06.03.24 - Version 1.14.0

Update 15.02.24 - Version 1.13.0

Update 05.01.24 - Version 1.12.0

Update 12.09.23 - Version 1.7.0

Update 28.08.23 - Version 1.4.0

Update 28.08.23 - Version 1.3.0

Update 12.07.23 - Version 1.2.0

Update 07.07.23 - Version 1.1.0

Update 07.05.20 - Version 1.0.0