FlowAlp Pay
Accept payments online and on-site with FlowAlp Pay — hosted checkout, pay links, QR codes, e-commerce plugins and a full REST API. Guides for merchants and developers.
- Getting started
- Payments
- Checkout & embedding
- API Reference
- Webhooks
- Payouts
- Integrations & plugins
- Testing & go-live
- SDKs
Getting started
Getting started
Choose an integration
Decision guide to FlowAlp Pay integrations: compare pay links and QR codes, shop plugins, hosted checkout via API, and full REST API integration.
Getting started
Create your FlowAlp Pay account
Sign up for FlowAlp Pay, get your tenant URL, complete account verification (KYC), and take your first steps in the merchant dashboard.
Getting started
Activate payment methods (TWINT, cards, wallets)
How to activate TWINT, cards, wallets, and other payment methods in the FlowAlp Pay dashboard, including acquiring contracts and test mode.
Getting started
Instance name
What the instance name is in FlowAlp Pay, where it appears in your payment page domain, and how to pass it in every Merchant API request.
Getting started
API credentials
Create FlowAlp Pay API keys in the merchant dashboard, understand what each credential contains, and follow secret handling best practices.
Getting started
First API request
Send your first FlowAlp Pay Merchant API request: verify credentials with SignatureCheck, then create a minimal Gateway with curl or PHP.
Payments
Payments
Accept a one-time payment
Accept one-time payments with FlowAlp Pay: create a Gateway, redirect to the hosted checkout, confirm via webhook and fulfill the order safely.
Payments
Payment methods: TWINT, cards, wallets and more
Overview of FlowAlp Pay payment methods: TWINT, cards, wallets, PayPal, Klarna and bank transfer — activation and per-payment restriction.
Payments
Pay links and QR codes
Create FlowAlp Pay payment links in the dashboard, share them by email or QR code, and automate invoices and donations via the Paylink API.
Payments
Pre-authorization: reserve and capture funds
Reserve funds at checkout with FlowAlp Pay pre-authorization, capture later via the Transaction endpoint — ideal for hotels, rentals and deposits.
Payments
Tokenization: charge saved payment methods
Tokenization with FlowAlp Pay: save a payment method at checkout (preAuthorization) and charge it later server-side — flexible, PCI-friendly billing.
Payments
Subscriptions and recurring payments
Recurring billing with FlowAlp Pay subscriptions: subscription checkout, renewal webhooks, API management — and when tokenization fits better.
Checkout & embedding
Checkout & embedding
Checkout embedding overview
Compare FlowAlp Pay checkout embedding options: redirect, iFrame, modal window and mobile apps, with guidance on choosing the right one.
Checkout & embedding
iFrame embedding
Embed the FlowAlp Pay payment form in your site with an iFrame: URLs, the allow attribute, payment method limits and resize/transaction events.
Checkout & embedding
Modal window
Open the FlowAlp Pay checkout in a modal window: dashboard snippet, custom JavaScript overlay, callback options and payment method limits.
Checkout & embedding
Mobile app integration
Integrate FlowAlp Pay in iOS and Android apps: create the Gateway server-side, open it in a WebView, handle events and return via deep links.
API Reference
API Reference
Merchant API overview
FlowAlp Pay Merchant API overview: base URL and versions, authentication, request format, main resources, errors and rate limits.
API Reference
API versions and changelog
How FlowAlp Pay API versioning works: supported versions v1.14 to v1.16, pinning a version, upgrade guidance and per-version changelog.
API Reference
Merchant API authentication
Authenticate FlowAlp Pay Merchant API requests with the x-api-key header or the ApiSignature HMAC-SHA256 parameter, with code examples.
API Reference
Request format
FlowAlp Pay Merchant API request format: URL structure, JSON and form-urlencoded bodies, HTTP verbs, amounts in minor units, examples.
API Reference
Merchant API errors
HTTP status codes of the FlowAlp Pay Merchant API, the JSON error response shape, and practical retry guidance with exponential backoff.
API Reference
Merchant API rate limits
FlowAlp Pay Merchant API rate limits: 600 requests per 5 minutes, 405/403 signals under load, and a retry strategy with backoff.
API Reference
SignatureCheck: verify API credentials
Validate your FlowAlp Pay API credentials and signature calculation with the SignatureCheck endpoint — curl and PHP examples included.
API Reference
Create a Gateway
Create a hosted FlowAlp Pay checkout with POST /Gateway/. Full parameter table, curl and PHP SDK examples, response fields and error codes.
API Reference
Retrieve a Gateway
Retrieve a FlowAlp Pay Gateway by ID to check its payment status (waiting, confirmed, authorized, reserved). curl and PHP SDK examples.
API Reference
Delete a Gateway
Delete a FlowAlp Pay Gateway by ID with the Merchant API: DELETE /Gateway/{id}/ request, curl and PHP SDK examples, response and errors.
API Reference
Create a Paylink
Create a FlowAlp Pay Paylink with POST /Invoice/: a hosted payment link to share by email or QR code. Parameters, examples and errors.
API Reference
Retrieve and list Paylinks
Retrieve a FlowAlp Pay Paylink by ID with GET /Invoice/{id}/ and verify its payment. curl and PHP SDK examples, response fields, errors.
API Reference
Update and delete a Paylink
Delete a FlowAlp Pay Paylink with DELETE /Invoice/{id}/ and learn how to replace one when parameters change. curl and PHP SDK examples.
API Reference
List and retrieve Transactions
List and filter FlowAlp Pay transactions or retrieve a single one by ID, with all transaction status values explained for the Merchant API.
API Reference
Charge, capture, refund and cancel Transactions
Charge tokenized payments, capture reservations, refund fully or partially and cancel waiting transactions with the FlowAlp Pay API.
API Reference
Subscriptions API
Create, retrieve, update and cancel FlowAlp Pay subscriptions via API, with recurring billing intervals, periods and VAT parameters.
API Reference
Payouts API
List FlowAlp Pay payouts and retrieve a single payout with its transactions, fees and bank reference to reconcile your settlements.
API Reference
Payment providers and method identifiers
Query the payment providers configured for your FlowAlp Pay account and look up all payment method identifiers such as TWINT or Visa.
Webhooks
Webhooks
Configure webhooks
Configure FlowAlp Pay webhooks: dashboard setup, content types, retry schedule, 20-second timeout, idempotent processing and secure order confirmation.
Webhooks
Webhook events and payloads
Reference for FlowAlp Pay webhook events: transaction, subscription and payout payloads with JSON examples, plus tips for idempotent processing.
Webhooks
Verify webhook signatures
Verify FlowAlp Pay webhook authenticity: HMAC-SHA256 signature checks in PHP, the ApiSignature pattern and credential tests via SignatureCheck.
Payouts
Integrations & plugins
Integrations & plugins
E-commerce integrations overview
Overview of FlowAlp Pay e-commerce plugins for WooCommerce, Shopify, Shopware, Magento 2 and more, plus the generic install and connect pattern.
Integrations & plugins
WooCommerce plugin guide
Step-by-step WooCommerce guide for FlowAlp Pay: activate the integration, install and connect the plugin, map payment methods and test orders.
Integrations & plugins
CMS integrations overview
Connect FlowAlp Pay to your CMS: WordPress, Drupal, WIX, Jimdo, Weebly and more — plus pay links as the universal no-code fallback.
Integrations & plugins
Business software overview
Connect FlowAlp Pay with business software: Bexio accounting, Zapier and Make automations, Planyo bookings, fundraising tools and more.
Integrations & plugins
Other integrations
Integration paths beyond shop and CMS plugins: FlowAlp Pay custom API builds, form and donation flows, and pay links as no-code fallback.
Testing & go-live
Testing & go-live
Testing for developers
How FlowAlp Pay test mode works: simulate payments without moving real money, what to test before go-live, and how to keep test data separate.
Testing & go-live
Test cards and scenarios
FlowAlp Pay test cards to simulate confirmed and declined card payments in test mode, plus scenarios for TWINT, wallets, and refunds.
Testing & go-live
Go-live checklist
Production checklist for FlowAlp Pay: swap to live credentials, verify webhooks and signatures, redirect URLs, error handling, and reconciliation.