Skip to content

Bank apps do not open inside Facebook Messenger

Symptom. A buyer opens a checkout or invoice link from a Facebook or Messenger chat, picks their bank app (Khan Bank, Golomt, Social Pay, and so on) and nothing happens — the app never opens and the page just sits there.

Cause. On iOS, Facebook and Messenger open links in their own in-app browser instead of Safari. That in-app browser blocks the deeplinks bank apps rely on (custom URL schemes such as khanbank:// or golomtbank://), so the payment cannot continue.

This is a limitation of Facebook's in-app browser on iOS, not of Byl. Android is usually unaffected.

How the buyer fixes it

Open the link in an external browser (Safari) and continue the payment there:

  1. Tap the (more) button in the in-app browser's toolbar.
  2. Choose "Open in external browser" / "Open in Safari".
  3. Pick your bank app again on the page that opens in Safari — it will launch normally.

If that option is not available, copy the link from the address bar and paste it into Safari.

Byl warns about this automatically

Byl detects the iOS + Facebook/Messenger in-app browser combination. When it does, the hosted checkout and invoice pages show a warning at the top and an "Open in external browser" hint in the bottom corner, pointing the buyer to an external browser.

Turning the warning off

If you reach your customers another way — you only share links that open in Safari or Chrome, or you collect payments by QR code — you can turn the warning off per project:

Dashboard → Project → Settings → Branding → Messenger warning → switch it off and Save.

The warning is on by default. With it off, buyers arriving from iOS Messenger see no warning at all.

Prevention

  • When you share links on Facebook or Messenger, add a note asking buyers to open them in Safari.
  • For in-person or on-screen payments, use Terminal (QR) mode — the buyer opens their bank app themselves and scans the QR code.

Next steps