Zyllio Documentation English
Pages
Tutoriels
Stripe Payments
Available from the Enterprise plan.
The Zyllio platform does not charge any fees on payments made through Stripe.
Stripe is an online payment infrastructure that allows businesses to manage and accept payments securely.
By integrating Zyllio with Stripe, you will benefit from its robust features, such as payment management, recurring billing, fraud protection, and much more.
Prerequisites
A valid Stripe account is required to connect the Stripe and Zyllio solutions.
Additionally, a subscription to the Zyllio Enterprise plan is needed to activate this feature.
Configuration
The Stripe integration can be activated from the Settings tab / Integration / Stripe by enabling the Enable button as shown in this image
Connect Your Stripe Account
Next, click the Connect with Stripe button to link your account with the Zyllio platform.
Log in and click on Submit.
Finally, click the Connect button.
Close the tab when the following message appears: “Your Stripe account has been connected. Please close this window.”
Test and Production Mode
We recommend conducting all your Zyllio application design and payment testing in Test Mode.
During the testing period, the Production Mode option should be disabled.
Production mode can be enabled once the application is finalized.
Currency
The currency parameter allows you to specify the currency for payments in your mobile application
Name
Currency
Dollar
USD
Euro
EUR
There are no rows in this table
Creating Products
From the Database tab, click and drag a Products table into the workspace.
This way, Zyllio creates a ready-to-use table with 7 sample products.
Creating Catalog Screens
From the Designer tab, select the List screen template and then select the Products table.
Click and drag the screen to create this first screen, then rename the screen to Products.
Next, create a detail screen by selecting a Details screen template, then choose the Products screen, and finally select the Products component.
Click and drag the screen to create this new screen, then rename it to Details.
Finalize the detail screen as follows:
And link the two screens from the Flow tab.
Authentication
Create an authentication screen using a Login screen template and then select the Users table.
Next, link the Enter button to the Products screen.
Designate the Login screen as the startup screen by clicking on the icon as shown below.
Creating a Cart
Add an Add to Cart button in the Details screen.
Define an Add Product action and fill in the following properties:
Propriété
Type
Valeur
Image
Variable
Products/Image
Price Id
Variable
Products/PriceId
Name
Variable
Products/Name
Description
Variable
Products/Description
Price
Variable
Products/Price
Currency
Variable
Products/Currency
Quantity
Fixed
1
There are no rows in this table
You will get:
Next, create a screen called Cart to display the cart.
Select a Cart component by choosing Fixed.
Drag the component into the screen as follows:
Link the Add To Cart button to the Cart screen.
Creating a Payment Button
Add a button called Pay that uses the Process Payment action
Define the price source
The screen below illustrates the configuration of the Stripe integration in your application.
The elements highlighted in yellow emphasize the configuration of the price source, which is essential for linking your database data to Stripe
Here is an explanation of the different fields:
Price Table
Select the table in your database that contains information about your products or services. This table serves as a reference for the prices that Stripe will use during transactions.
Price ID Column
Select the column that contains the unique identifiers for the prices (Price ID). These identifiers allow Stripe to link the prices defined in your database to those configured in your Stripe account.
Example: A column named "PriceId" containing values like price_12345.
Price Column
Select the column that contains the price values. This column defines the amount users will pay for a product or service.
Example: A column named "Price" with amounts in euros, such as 10.00.
At this stage, your application is ready to accept payments in test mode.
Testing a Payment
When conducting interactive tests, use a card number of type:
Enter this card number in the Dashboard or in a payment form.
Payments appear in the Transactions section.
Reconciling in Zyllio
Zyllio captures successful payments in a specific table called Orders. Simply create it from the table templates in the Database tab.
Here is an example of a successful transaction
Displaying User Orders
Simply create a new screen called Orders that lists the contents of the Orders table.
A filter is needed to display only the orders of the authenticated user.
Errors
Error
Stripe message
Reason
The payment failed, code 01
The price parameter should be the ID of a price object, rather than the literal numerical price. Please see https://stripe.com/docs/billing/prices-guide#create-prices for more information about how to set up price objects.
One or more products have a priceId that is not declared in the Stripe catalog.
The payment failed, code 01
The specified price supports currencies of `eur`, which does not include the expected currency of `usd`.
The currency of a product does not match the currency of the Stripe integration in the Zyllio Settings.
The payment failed, code 02
Requires payment method
The payment method is not valid.
The payment failed, code 03
Status unknown
Should not occur.
There are no rows in this table
Want to print your doc?
This is not the way.
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.