Overview
Fliqr AI does not process card data directly. When a customer reaches the payment step, Fliqr AI hands off to Stripe’s hosted checkout or PayPal’s payment flow. Card and bank details are entered on the provider’s infrastructure. Fliqr AI receives a success or failure event via webhook and continues the conversation accordingly. This architecture means payment security compliance (PCI DSS) is handled by Stripe or PayPal, not by your Fliqr AI account or your server.Prerequisites
- A Stripe or PayPal account (or both)
- Products added to your catalog — see Catalog
- A checkout flow configured — see Cart & Checkout
Connect Stripe
1
Open Payment Settings
Go to E-Commerce → Payments → Add Provider → Stripe.
2
Enter your API keys
Paste your Stripe Secret Key and Publishable Key. You can find both in the Stripe Dashboard under Developers → API Keys.
3
Save
Click Save. Fliqr AI validates both keys before confirming the connection.
4
Test with a Stripe test card
Use your Stripe test API keys (prefix
sk_test_) and complete a test purchase using the card number 4242 4242 4242 4242 with any future expiry date and any 3-digit CVC. Verify that the order appears in E-Commerce → Orders with a Paid status.Connect PayPal
1
Open Payment Settings
Go to E-Commerce → Payments → Add Provider → PayPal.
2
Enter your credentials
Paste your PayPal Client ID and Secret. You can find these in the PayPal Developer Dashboard under My Apps & Credentials.
3
Select your environment
Choose Sandbox for testing or Live for production. You will need separate credentials for each environment — PayPal Sandbox credentials do not work in Live mode.
4
Save and test
Click Save. Run a test transaction using your PayPal Sandbox buyer account to confirm the connection works end-to-end.
How Payment Collection Works in a Flow
After your checkout block collects the customer’s order and shipping details, a Payment block handles the payment step:1
Add a Payment block
In the Flow Builder, add a Payment block after your Checkout block.
2
Select the provider
In the Payment block settings, choose Stripe or PayPal.
3
Configure the success and failure paths
The Payment block has two output paths: Payment Successful and Payment Failed. Connect:
- Successful → Your order confirmation message block
- Failed → A message asking the customer to try again, with an option to retry or contact support
4
What the customer experiences
On channels that support inline forms (Website Chat, Messenger), the customer sees a payment form within the conversation. On WhatsApp, they receive a payment link that opens Stripe Checkout or PayPal in their browser. After completing payment, they return to the chat and the confirmation flow runs.
Using Multiple Payment Providers
You can connect both Stripe and PayPal to the same account and let customers choose their preferred option. To offer a choice:- Add a Quick Reply block before the Payment block asking “How would you like to pay?”
- Create two paths — one leading to a Stripe Payment block, one to a PayPal Payment block.
- Both paths should converge at the same order confirmation block after successful payment.
Refunds
Refunds are initiated from your Stripe Dashboard or PayPal account, not from Fliqr AI. When you process a refund in either provider, the webhook notifies Fliqr AI and the order status updates to Refunded automatically. You can then trigger a refund notification flow if you have one configured under E-Commerce → Orders → Automation Rules.What’s Next
Order Management
Track order status, update fulfillment, and send automated shipping notifications.
Cart & Checkout
Review the full checkout flow configuration and channel-specific requirements.