Embedding iFrame

L’iFrame permette di mostrare un tool merchant o una pagina di pagamento all’interno del tuo sito.

Esempio — Pages tool

# html
<iframe
  src="https://<instance>.pay.flowalp.com/pay?tid=<PAYMENT_TEMPLATE_ID>"
  width="530"
  height="700"
  allow="payment *">
</iframe>

Esempio — Terminal / vPOS

# html
<iframe
  src="https://<instance>.pay.flowalp.com/vpos"
  width="530"
  height="700"
  allow="payment *">
</iframe>

Per un Gateway creato via API, usa l’URL di pagamento restituito dalla create come src dell’iFrame.

Attributi obbligatori per alcuni wallet

Google Pay richiede allow="payment *".

Metodi non compatibili con iFrame

Alcuni metodi (es. PostFinance Pay, Reka Pay, PayPal, Coinbase) possono non funzionare in iFrame. In quel caso apri la pagina esterna aggiungendo:

# text
&breakIframe=true

Sicurezza e conferma

• Non esporre API Secret nel frontend.
• Conferma il pagamento lato server (webhook (/docs/flowalp-pay/webhooks/configuration)).

Passaggi successivi

• Modal window (/docs/flowalp-pay/checkout/modal-window)
• Panoramica embedding (/docs/flowalp-pay/checkout/overview)