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 ​