Mobile app integration

Per app native o ibride, il pattern consigliato è:

• Il backend crea un Gateway (/docs/flowalp-pay/api/gateway/create).
• L’app apre l’URL di pagamento in una WebView sicura o nel browser di sistema.
• Al ritorno (deep link / custom URL scheme / Universal Link), l’app interroga il backend.
• Il backend conferma lo stato via webhook o retrieve API — non fidarti solo del ritorno in-app.

Buone pratiche

• Tieni API Secret solo sul backend.
• Preferisci browser di sistema / Custom Tabs / SFSafariViewController quando i wallet o 3-D Secure lo richiedono.
• Gestisci cancel e timeout come stati distinti da “pagato”.
• Allinea i redirect URL a deep link validati.

Testing

Esegui scenari success/fail/cancel su dispositivi reali prima del go-live. Vedi Testing (/docs/flowalp-pay/testing/overview) e Checklist (/docs/flowalp-pay/testing/launch-checklist).

Passaggi successivi

• Panoramica embedding (/docs/flowalp-pay/checkout/overview)
• Webhook (/docs/flowalp-pay/webhooks/configuration)