Both integration approaches require licensing and bank registration. See Licensing & Registration if you have not set this up yet.
Quick comparison
| Hosted Pages (recommended for most) | Direct API | |
|---|---|---|
| Integration time | Hours to days | Days to weeks |
| Frontend work | None for consent and auth flows | You build the entire UI |
| Auth flow handling | Fully managed (redirect, embedded, all SCA methods) | You manage redirects, callbacks, consent exchange |
| Bank selection UI | Built-in institution picker | You build your own |
| Payments | Single payments, VRP | Single, bulk, scheduled, periodic, VRP, international |
| Data consent | Handles consent/auth flow, returns consent token | You build the full consent flow |
| Data retrieval | Use the API with the Hosted consent token | Use the API with your own consent token |
| Data+ (enrichment) | Available (use API with Hosted consent token) | Available |
| Customisation | Branding (logo, colours) | Complete control |
| Delivery | Web redirect (not embeddable in native apps) | Any platform |
| Countries | Hosted Payments: United Kingdom, Germany, Lithuania, Netherlands, Belgium, Spain, France, Austria, Portugal. Hosted Data: United Kingdom, Germany, Lithuania, Netherlands, Belgium, Spain, France, Austria, Portugal, Sweden, Norway, Denmark, Ireland | All supported countries |
| Best for | Payment acceptance, data consent flows, quick launches, MVPs | Complex payment types, multi-country custom UX, native apps |
When to choose Hosted Pages
Choose Hosted Pages when:- You want to accept payments or obtain data consent and need to go live quickly
- You do not have frontend engineering resource to build authorisation flows
- You are building an MVP or testing open banking for the first time
- Your use case is single payments, VRP, or data access in supported Hosted Pages countries
- You want Yapily to handle the complexity of bank selection, redirects, SCA, and consent management
How Hosted works for each use case
For payments: Hosted manages the entire flow. You create a payment request, receive a URL, redirect your user, and the payment is executed once the user authorises. You receive webhooks on payment status changes. For data access: Hosted manages the consent and authorisation flow. Once the user authorises, you receive a consent token. You then use this token with the Yapily API to call data endpoints: accounts, balances, transactions, and Data+ enrichment. Learn more:When to choose the Direct API
Choose the Direct API when:- You need payment types not yet supported by Hosted Pages (bulk, scheduled, periodic, international)
- You are operating in countries not yet covered by Hosted Pages
- You need full control over the user experience and want to build a custom UI
- You are building a native mobile app (Hosted Pages is a web redirect experience)
- You have complex requirements such as multi-bank consent management or custom retry logic
Both approaches can be combined within the same product. For example, use Hosted Pages for standard payment collection and data consent, then use the Direct API for specialised payment types or additional data processing.
Feature availability
| Feature | Hosted Pages | Direct API |
|---|---|---|
| Single domestic payment | Yes | Yes |
| SEPA / SEPA Instant payment | Yes | Yes |
| International payment | No | Yes |
| Scheduled payment | No | Yes |
| Periodic payment (standing order) | No | Yes |
| Bulk payment | No | Yes |
| Variable Recurring Payment (VRP) | Yes | Yes |
| Pay By Link | Yes | No |
| Data consent (AIS authorisation) | Yes | Yes |
| Account and transaction retrieval | Via API with Hosted consent token | Yes |
| Transaction enrichment (Data+) | Via API with Hosted consent token | Yes |
| Identity verification (Validate) | Via API with Hosted consent token | Yes |
| Custom UI / branding | Limited (logo, colours) | Full control |
| Native app embedding | Not yet supported | Full control |
Hosted Pages coverage is expanding. Check the Hosted Pages documentation for the latest supported countries and features.
Which approach fits your situation?
| Your situation | Recommendation |
|---|---|
| Payments in a Hosted-supported country, standard UI is fine | Hosted Pages |
| Data consent in a Hosted-supported country | Hosted for consent, API for data retrieval |
| Identity verification | Hosted for consent, API for validation |
| Sweeping VRP in a Hosted-supported country | Hosted Pages |
| Bulk, scheduled, periodic, or international payments | Direct API |
| Country not covered by Hosted | Direct API |
| Native mobile app | Direct API |
| Custom consent or payment UI required | Direct API |
| Standing orders | Direct API |
Next steps
- I'll use Hosted Pages
- I'll use the Direct API
- I'll use both