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.
The following test cards are available in the Sandbox environment. Use them to simulate different transaction results, including 3D Secure (3DS) flows.
Card Brand
Card Number
Simulation Result
Mastercard
5200 0000 0000 1096
Successful payment
Visa
4000 0000 0000 1091
Successful payment
Mastercard
5200 0000 0000 1005
Successful (3DS frictionless)
Visa
4000 0000 0000 1000
Successful (3DS frictionless)
Mastercard
5200 0000 0000 1120
Failed (during verification)
Visa
4000 0000 0000 1125
Failed (during verification)
Mastercard
5200 0000 0000 1013
Failed (3DS frictionless failure)
Visa
4000 0000 0000 1018
Failed (3DS frictionless failure)
If you’re unsure which integration method fits your use case (Checkout vs Element SDK), refer to your onboarding document or contact QFPay support.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"QFPay Developer Centre","colors":{"primary":"#005FCC","light":"#4EA8FF","dark":"#004299"},"logo":{"light":"https://mintlify.s3.us-west-1.amazonaws.com/qfpay-8e347952/logo.png","dark":"https://mintcdn.com/qfpay-8e347952/d02nWBorZX3ongpm/images/logo_dark.jpg?fit=max\u0026auto=format\u0026n=d02nWBorZX3ongpm\u0026q=85\u0026s=d2daee818f0c5f75c3d5cb6fe108625a"},"favicon":{"light":"https://mintcdn.com/qfpay-8e347952/d02nWBorZX3ongpm/images/logo.png?fit=max\u0026auto=format\u0026n=d02nWBorZX3ongpm\u0026q=85\u0026s=4b7ccf1220fedeaf6cde662b6e80e792","dark":"https://mintcdn.com/qfpay-8e347952/d02nWBorZX3ongpm/images/logo_dark.jpg?fit=max\u0026auto=format\u0026n=d02nWBorZX3ongpm\u0026q=85\u0026s=d2daee818f0c5f75c3d5cb6fe108625a"},"appearance":{"default":"light"},"navbar":{"links":[{"href":"mailto:technical.support@qfpay.com","label":"Support"}]},"footer":{"socials":{"website":"https://qfpay.global"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","default":true,"href":"introduction"},{"language":"zh-Hant","href":"zh-Hant/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"qfpay-8e347952","hasAudioNarration":false,"actualSubdomain":"qfpay-8e347952","customDomains":["sdk.qfapi.com"],"gitSource":{"type":"github","owner":"qfpay","repo":"docs-mintlify","deployBranch":"develop","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af1a1e8c512f82174897f24","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"en","tag":"Integration","count":50},{"language":"zh-Hant","tag":"對接指南","count":50},{"language":"en","tag":"Online Payments","count":26},{"language":"zh-Hant","tag":"線上支付","count":26},{"language":"en","tag":"Integration by Payment Type","count":12},{"language":"en","tag":"Integration by Use Case","count":12},{"language":"zh-Hant","tag":"按支付方式整合","count":12},{"language":"zh-Hant","tag":"按支付場景整合","count":12},{"language":"en","tag":"API Reference","count":6},{"language":"zh-Hant","tag":"API 參考文件","count":6},{"language":"en","tag":"Shared Endpoints","count":5},{"language":"en","tag":"In-Store Payments","count":5},{"language":"en","tag":"Wechat","count":5},{"language":"zh-Hant","tag":"共用端點","count":5},{"language":"zh-Hant","tag":"實體店支付","count":5},{"language":"zh-Hant","tag":"微信支付","count":5},{"language":"en","tag":"Recurring Payments","count":4},{"language":"en","tag":"Preparation","count":4},{"language":"zh-Hant","tag":"定期付款","count":4},{"language":"zh-Hant","tag":"準備","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"technical.support@qfpay.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"integration/online-shop/integration-by-payment-type/visa-master-online-payment","slug":"/integration/online-shop/integration-by-payment-type/visa-master-online-payment","pageMetadata":{"title":"Visa / Mastercard Online Payments","description":null,"href":"/integration/online-shop/integration-by-payment-type/visa-master-online-payment"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,br:`br`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info,Table,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`This page provides integration guidance for online credit card payments using Visa and Mastercard. Our solution currently supports credit card payments in the `,_jsx(_components.a,{href:`/integration/preparation/environments`,children:`Hong Kong environment`}),`, covering all major card issuers.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`integration-methods`,children:`Integration Methods`}),`\n`,_jsx(_components.p,{children:`Merchants can choose from two integration options:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/integration/online-shop/checkout-integration/checkout`,children:_jsx(_components.strong,{children:`QFPay Checkout Services`})}),_jsx(_components.br,{}),`\n`,`A hosted payment page solution—ideal for merchants who prefer minimal PCI scope and faster setup.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/integration/online-shop/checkout-integration/payment-element`,children:_jsx(_components.strong,{children:`QFPay Payment Element SDK`})}),_jsx(_components.br,{}),`\n`,`A client-side SDK that embeds payment input fields directly into your website, offering full UX control and 3DS support.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`asynchronous-notification`,children:`Asynchronous Notification`}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`QFPay will send an asynchronous notification to your backend to confirm the transaction result.`})}),`\n`,_jsxs(_components.p,{children:[`Refer to `,_jsx(_components.a,{href:`/integration/common-api/async-notifications`,children:`Asynchronous Notification`}),` for details on the notification format and signature verification.`]}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`Example Notification Payload:`}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`18`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`18`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"cardtp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"cancel\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pay_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"802801\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"order_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"payment\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"clisn\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"054256\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"txdtm\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2021-12-08 07:04:15\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"out_trade_no\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"354267281\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"syssn\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"20211208180500020000001637\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sysdtm\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2021-12-08 15:04:16\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"paydtm\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2021-12-08 15:06:51\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"txcurrcd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"HKD\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"udid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"qiantai2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"userid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1130000355\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"txamt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"respcd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errmsg\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Always validate the notification using the provided signature, and never trust the notification result blindly.`})}),`\n`,_jsxs(Tip,{children:[_jsxs(_components.p,{children:[`You can use the `,_jsx(_components.a,{href:`/integration/common-api/transaction-enquiry`,children:_jsx(_components.strong,{children:`Transaction Enquiry`})}),` API as a fallback to confirm transaction status when:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Callback is delayed`}),`\n`,_jsx(_components.li,{children:`Signature verification fails`}),`\n`,_jsx(_components.li,{children:`Merchant server missed the notification`}),`\n`]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`test-cards`,children:`Test Cards`}),`\n`,_jsxs(_components.p,{children:[`The following test cards are available in the `,_jsx(_components.strong,{children:`Sandbox`}),` environment. Use them to simulate different transaction results, including 3D Secure (3DS) flows.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Card Brand`}),_jsx(_components.th,{children:`Card Number`}),_jsx(_components.th,{children:`Simulation Result`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Mastercard`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`5200 0000 0000 1096`}),_jsx(_components.td,{children:`Successful payment`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Visa`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`4000 0000 0000 1091`}),_jsx(_components.td,{children:`Successful payment`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Mastercard`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`5200 0000 0000 1005`}),_jsx(_components.td,{children:`Successful (3DS frictionless)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Visa`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`4000 0000 0000 1000`}),_jsx(_components.td,{children:`Successful (3DS frictionless)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Mastercard`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`5200 0000 0000 1120`}),_jsx(_components.td,{children:`Failed (during verification)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Visa`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`4000 0000 0000 1125`}),_jsx(_components.td,{children:`Failed (during verification)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Mastercard`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`5200 0000 0000 1013`}),_jsx(_components.td,{children:`Failed (3DS frictionless failure)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Visa`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`4000 0000 0000 1018`}),_jsx(_components.td,{children:`Failed (3DS frictionless failure)`})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`If you’re unsure which integration method fits your use case (Checkout vs Element SDK), refer to your onboarding document or contact QFPay support.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Visa / Mastercard Online Payments","description":null,"href":"/integration/online-shop/integration-by-payment-type/visa-master-online-payment"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Integration Methods","slug":"integration-methods","depth":2,"children":[]},{"title":"Asynchronous Notification","slug":"asynchronous-notification","depth":2,"children":[]},{"title":"Test Cards","slug":"test-cards","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"qfpay-8e347952","siteName":"QFPay Developer Centre","title":"Visa / Mastercard Online Payments - QFPay Developer Centre","contextualStarterQuestions":[{"_id":"6ab2323d36f3601e34c2c7f5","deploymentId":"6980640906bd66be2350a365","questionText":"Which integration method should I use?","status":"active","generatedBy":"contextual","path":"integration/online-shop/integration-by-payment-type/visa-master-online-payment","createdAt":"2026-09-22T07:46:05.566Z","updatedAt":"2026-09-22T07:46:05.566Z","__v":0},{"_id":"6ab2323d36f3601e34c2c7f7","deploymentId":"6980640906bd66be2350a365","questionText":"What test cards are available?","status":"active","generatedBy":"contextual","path":"integration/online-shop/integration-by-payment-type/visa-master-online-payment","createdAt":"2026-09-22T07:46:05.566Z","updatedAt":"2026-09-22T07:46:05.566Z","__v":0},{"_id":"6ab2323d36f3601e34c2c7f6","deploymentId":"6980640906bd66be2350a365","questionText":"How do I verify payment notifications?","status":"active","generatedBy":"contextual","path":"integration/online-shop/integration-by-payment-type/visa-master-online-payment","createdAt":"2026-09-22T07:46:05.566Z","updatedAt":"2026-09-22T07:46:05.566Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/integration/online-shop/integration-by-payment-type/visa-master-online-payment","matchLevel":0},"zh-Hant":{"href":"/zh-Hant/integration/online-shop/integration-by-payment-type/visa-master-online-payment","matchLevel":1}}},"lastModified":"2026-09-22T07:46:01.270Z","originalFileLocation":"integration/online-shop/integration-by-payment-type/visa-master-online-payment.md","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"QFPay Developer Centre\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/qfpay-8e347952/8ne0KolOvSTHgeon/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/qfpay-8e347952/8ne0KolOvSTHgeon/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/qfpay-8e347952/8ne0KolOvSTHgeon/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/qfpay-8e347952/8ne0KolOvSTHgeon/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/qfpay-8e347952/8ne0KolOvSTHgeon/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/qfpay-8e347952/8ne0KolOvSTHgeon/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/qfpay-8e347952/8ne0KolOvSTHgeon/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/qfpay-8e347952/8ne0KolOvSTHgeon/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/qfpay-8e347952/8ne0KolOvSTHgeon/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Visa / Mastercard Online Payments - QFPay Developer Centre\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"QFPay Developer Centre\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/visa-master-online-payment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://qfpay-8e347952.mintlify.site/_mintlify/api/og/v2?division=Integration+by+Payment+Type\u0026amp;title=Visa+%2F+Mastercard+Online+Payments\u0026amp;theme=98a0922fe001d0bfa88cf20e\u0026amp;signature=25b2626818dfa64b8d9034378b101b6a51769d582b24cba4a835a093266d9a62\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Visa / Mastercard Online Payments - QFPay Developer Centre\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://qfpay-8e347952.mintlify.site/_mintlify/api/og/v2?division=Integration+by+Payment+Type\u0026amp;title=Visa+%2F+Mastercard+Online+Payments\u0026amp;theme=98a0922fe001d0bfa88cf20e\u0026amp;signature=25b2626818dfa64b8d9034378b101b6a51769d582b24cba4a835a093266d9a62\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/qfpay-8e347952/8ne0KolOvSTHgeon/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"QFPay Developer Centre\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#005FCC\">\u003clink data-mint-head rel=\"canonical\" href=\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/visa-master-online-payment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integration/online-shop/integration-by-payment-type/visa-master-online-payment.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/visa-master-online-payment\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hant\" href=\"https://sdk.qfapi.com/zh-Hant/integration/online-shop/integration-by-payment-type/visa-master-online-payment\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/visa-master-online-payment\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://sdk.qfapi.com/#organization\",\"name\":\"QFPay Developer Centre\",\"url\":\"https://sdk.qfapi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintlify.s3.us-west-1.amazonaws.com/qfpay-8e347952/logo.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://sdk.qfapi.com#website\",\"name\":\"QFPay Developer Centre\",\"url\":\"https://sdk.qfapi.com\",\"publisher\":{\"@id\":\"https://sdk.qfapi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/visa-master-online-payment#webpage\",\"url\":\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/visa-master-online-payment\",\"name\":\"Visa / Mastercard Online Payments\",\"dateModified\":\"2026-09-22T07:46:01.270Z\",\"isPartOf\":{\"@id\":\"https://sdk.qfapi.com#website\"},\"breadcrumb\":{\"@id\":\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/visa-master-online-payment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/visa-master-online-payment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Online Payments\",\"item\":\"https://sdk.qfapi.com/integration/online-shop/checkout-integration/checkout\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Integration by Payment Type\",\"item\":\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/alipay/alipay-in-app\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Visa / Mastercard Online Payments\",\"item\":\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/visa-master-online-payment\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/visa-master-online-payment#article\",\"headline\":\"Visa / Mastercard Online Payments\",\"name\":\"Visa / Mastercard Online Payments\",\"url\":\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/visa-master-online-payment\",\"mainEntityOfPage\":{\"@id\":\"https://sdk.qfapi.com/integration/online-shop/integration-by-payment-type/visa-master-online-payment#webpage\"},\"dateModified\":\"2026-09-22T07:46:01.270Z\",\"publisher\":{\"@id\":\"https://sdk.qfapi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://sdk.qfapi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"QFPay Developer Centre\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"QFPay Developer Centre\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/integration/online-shop/integration-by-payment-type/visa-master-online-payment.md","siteName":"QFPay Developer Centre","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/introduction"}]},{"tab":"Integration","pages":[{"group":"Preparation","pages":[{"title":"Before You Begin","href":"/integration/preparation/before-you-begin"},{"title":"Credentials \u0026 Merchant Structure","href":"/integration/preparation/credentials-and-merchant-structure"},{"title":"Authentication \u0026 Signature","href":"/integration/preparation/authentication-and-signature"},{"title":"Environments","href":"/integration/preparation/environments"}]},{"group":"Business Scenarios","pages":[{"title":"Self-Service Retail Machine","href":"/integration/business-scenarios/self-service-retail"},{"title":"Physical Store / Restaurant","href":"/integration/business-scenarios/physical-store"}]},{"group":"API Reference","pages":[{"title":"API Usage Guidelines","href":"/integration/api-reference/api-usage-guidelines"},{"title":"Supported Currencies","href":"/integration/api-reference/currencies"},{"title":"Payment Types","href":"/integration/api-reference/paytypes"},{"title":"Request Format","href":"/integration/api-reference/request-format"},{"title":"Response Format","href":"/integration/api-reference/response-format"},{"title":"Transaction Status Codes","href":"/integration/api-reference/status-codes"}]},{"group":"In-Store Payments","pages":[{"title":"Merchant Present Mode (MPM)","href":"/integration/in-store/MPM"},{"title":"Consumer Present Mode (CPM)","href":"/integration/in-store/CPM"},{"group":"POS API","pages":[{"title":"App Call App Android SDK","href":"/integration/in-store/pos-api/app-call-app"},{"title":"ECR Integration Technical Specification","href":"/integration/in-store/pos-api/ecr"},{"title":"HTTPS Setup for ECR Integration","href":"/integration/in-store/pos-api/ecr-https"}]}]},{"group":"Online Payments","pages":[{"group":"Checkout Integration","pages":[{"title":"Hosted Checkout Page","href":"/integration/online-shop/checkout-integration/checkout"},{"title":"Element SDK","href":"/integration/online-shop/checkout-integration/payment-element"}]},{"group":"Integration by Payment Type","pages":[{"group":"Alipay","pages":[{"title":"Alipay In-App Payments","href":"/integration/online-shop/integration-by-payment-type/alipay/alipay-in-app"},{"title":"Alipay WAP / H5 Payments","href":"/integration/online-shop/integration-by-payment-type/alipay/alipay-wap-h5-payments"},{"title":"Alipay Web Payments","href":"/integration/online-shop/integration-by-payment-type/alipay/alipay-web-payments"}]},{"group":"FPS","pages":[{"title":"FPS App-to-App Integration","href":"/integration/online-shop/integration-by-payment-type/fps/fps-app-call-app"},{"title":"FPS e-Cert Certificate Application and Setup Guide","href":"/integration/online-shop/integration-by-payment-type/fps/fps-ecert-setup"}]},{"group":"Wechat","pages":[{"title":"WeChat In-App Payments (Native App)","href":"/integration/online-shop/integration-by-payment-type/wechat/wechat-in-app-payments"},{"title":"WeChat JSAPI Payment (Official Account)","href":"/integration/online-shop/integration-by-payment-type/wechat/wechat-jsapi-payment"},{"title":"WeChat Mini Programs","href":"/integration/online-shop/integration-by-payment-type/wechat/wechat-mini-programs"},{"title":"WeChat H5 Payment (Third-Party Browser)","href":"/integration/online-shop/integration-by-payment-type/wechat/wechat-pay-h5"},{"title":"WeChat QR Code Payment","description":"This guide helps merchants integrate WeChat online QR Code payments, including QR generation, verification, and timeout settings.","href":"/integration/online-shop/integration-by-payment-type/wechat/wechat-web-qr-payment"}]},{"title":"Visa / Mastercard Online Payments","href":"/integration/online-shop/integration-by-payment-type/visa-master-online-payment"},{"title":"Apple Pay Support","description":null,"href":"/integration/online-shop/integration-by-payment-type/applepay"}]},{"group":"Integration by Use Case","pages":[{"title":"Web Payment","href":"/integration/online-shop/integration-by-use-case/web-payment"},{"title":"WAP Payment (Mobile Browser)","href":"/integration/online-shop/integration-by-use-case/wap-payment"},{"title":"In-App Payment (Native App Integration)","href":"/integration/online-shop/integration-by-use-case/in-app-payment"},{"title":"Online Pre-authorisation API","href":"/integration/online-shop/integration-by-use-case/preauth"},{"title":"Card BIN Promotions","href":"/integration/online-shop/integration-by-use-case/card-bin-promotions"},{"group":"Saved Payment Methods","pages":[{"title":"Saved Payment Methods Overview","sidebarTitle":"Overview","href":"/integration/online-shop/integration-by-use-case/saved-payment-methods/overview"},{"title":"Customer \u0026 Token Setup","sidebarTitle":"Customer \u0026 Token Setup","href":"/integration/online-shop/integration-by-use-case/saved-payment-methods/customer-token-setup"},{"title":"Token Notification","sidebarTitle":"Token Notification","href":"/integration/online-shop/integration-by-use-case/saved-payment-methods/token-notification"}]},{"group":"Recurring Payments","pages":[{"title":"Recurring Payment Overview","href":"/integration/online-shop/integration-by-use-case/recurring-payments/recurring-overview"},{"title":"Subscription API Reference","href":"/integration/online-shop/integration-by-use-case/recurring-payments/recurring-api-reference"},{"title":"Subscription Webhook (Recurring Payment Notifications)","href":"/integration/online-shop/integration-by-use-case/recurring-payments/recurring-webhook"},{"title":"Integration Guide for Recurring Payments","href":"/integration/online-shop/integration-by-use-case/recurring-payments/recurring-integration-guide"}]}]}]},{"group":"Shared Endpoints","pages":[{"title":"Transaction Enquiry","href":"/integration/common-api/transaction-enquiry"},{"title":"Reversal API Guide","href":"/integration/common-api/reversal"},{"title":"Refund API Guide","href":"/integration/common-api/refund"},{"title":"Asynchronous Notifications","href":"/integration/common-api/async-notifications"},{"title":"Transaction Notes API","href":"/integration/common-api/transaction-note"}]},{"title":"Customs Declaration API","href":"/integration/customs-declaration"},{"title":"FAQs","href":"/integration/FAQs"}]}],"global":{"anchors":[{"anchor":"QFPay Main Site","icon":"book-open-cover","href":"https://www.qfpay.global"}]}},{"language":"zh-Hant","pages":[{"title":"zh-Hant","href":"/zh-Hant/integration/online-shop/integration-by-payment-type/visa-master-online-payment"}]}]},"basePath":"","title":"Visa / Mastercard Online Payments - QFPay Developer Centre","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":[],"chunks":[]}
