This page provides integration guidance for online credit card payments using Visa and Mastercard. Our solution currently supports credit card payments in the Hong Kong environment, covering all major card issuers.
Integration Methods
Merchants can choose from two integration options:
- QFPay Checkout Services
A hosted payment page solution—ideal for merchants who prefer minimal PCI scope and faster setup.
- QFPay Payment Element SDK
A client-side SDK that embeds payment input fields directly into your website, offering full UX control and 3DS support.
Asynchronous Notification
QFPay will send an asynchronous notification to your backend to confirm the transaction result.
Example Notification Payload:
Always validate the notification using the provided signature, and never trust the notification result blindly.
You can use the Transaction Enquiry API as a fallback to confirm transaction status when:
- Callback is delayed
- Signature verification fails
- Merchant server missed the notification
Test Cards
The following test cards are available in the Sandbox environment. Use them to simulate different transaction results, including 3D Secure (3DS) flows.
If you’re unsure which integration method fits your use case (Checkout vs Element SDK), refer to your onboarding document or contact QFPay support.
