FlowAlp Pay developer overview

FlowAlp Pay is FlowAlp's white-label payment solution. It exposes a Merchant API and checkout tools you can integrate into websites, e-commerce platforms, apps, and business software.

This documentation is for developers, integrators, and merchants with technical skills. It does not assume knowledge of the underlying technology.

Core concepts

Concept | Role
Instance | Technical merchant identifier. Appears in the payment page domain and as the `instance` query parameter in API requests.
Merchant API | REST API at `https://api.pay.flowalp.com` to create Gateways, manage transactions, subscriptions, and other resources.
Gateway | Customizable checkout created via API for custom payment flows.
Merchant tools | Ready-to-use tools configured in the back office (little or no coding).
Plugin | Prebuilt integrations for e-commerce, CMS, and business software.

Integration options

Custom Gateway

Use a Gateway when payment must fit into your own checkout:

• create a Gateway via the Merchant API;
• redirect (or embed) the customer to the payment page;
• receive updates via webhook and server-side verification.

See Accept a payment and Create a Gateway.

TODO FlowAlp: creare e collegare la pagina interna payments/one

Plugins and existing integrations

Ready-made integrations are available for many e-commerce, CMS, and business platforms. See:

• E-commerce overview
• CMS overview
• Business software overview

TODO FlowAlp: creare e collegare le pagine overview integrazioni

Embedding

The Gateway (or merchant tools) can be presented as:

• redirect to the payment page;
• iFrame;
• modal window;
• mobile app integration.

See Embedding overview.

TODO FlowAlp: creare e collegare checkout/overview

Merchant tools

If you do not need a custom checkout, you can use tools configured in the merchant account without calling the API. Embedding these tools uses the same modes as the Gateway.

Recommended path

• Choose an integration
• Instance name
• API credentials
• Authentication
• First API request
• Webhooks and payment verification (do not rely on redirect alone)

FlowAlp Pay domains

Use | URL
Merchant API | `https://api.pay.flowalp.com`
Merchant login | `https://login.pay.flowalp.com`
Sign up | `https://signup.pay.flowalp.com`
Platform back office | `https://backoffice.pay.flowalp.com`
Payment page | `https://<instance>.pay.flowalp.com`

TODO FlowAlp: verify operational status of https://pay.flowalp.com (root host) before publication.

Next steps

• Choose an integration
• Merchant API overview