Skip to content

Challenge Flow: Step-by-Step Implementation Guide ​

The Challenge Flow is used when additional customer verification is required. This guide explains how to implement it correctly.

When Challenge Flow is Used ​

Challenge Flow happens in approximately 5% of transactions when:

  • New customers making their first purchase
  • Unusually large transaction amounts
  • Customers using new devices or browsers
  • Purchases from different countries/locations
  • Risk patterns detected by the issuer

Customer Experience in Challenge Flow ​

What Your Customer Sees ​

  1. Starts checkout normally - Enters card details and clicks "Pay"
  2. Sees authentication screen - Redirected to secure verification page
  3. Completes verification - Enters OTP, uses biometric, or confirms in banking app
  4. Returns to your site - Automatically redirected back with transaction result

Authentication Methods Customers May Encounter ​

  • SMS OTP: 6-digit code sent to their phone
  • Email OTP: Code sent to registered email address
  • Mobile Banking App: Push notification to confirm payment
  • Biometric: Fingerprint or face scan through banking app
  • PIN Entry: Banking PIN entered on secure page

Common Issues and Solutions ​

Challenge Iframe Not Loading ​

  • Cause: CORS or content security policy issues
  • Solution: Ensure your CSP allows iframe loading from PayNetWorx domains

Customer Abandons Challenge ​

  • Cause: Confusing or slow challenge process
  • Solution: Provide clear instructions and progress indicators

Remember: The Challenge Flow is your safety net. While it adds a step for customers, it prevents fraud and builds trust in your payment system.