Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts. If omitted or empty, the request is executed using the master account.
More information at Connected Accounts.
A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.
Authorization mode. Pre-authorization requires account and channel support, card or card_present, and auto_capture=false. If supplied both here and inside payment_method, the values must match. When omitted, the payment method value is used, otherwise ordinary authorization applies.
REQUIRES_PAYMENT_METHOD: The PaymentIntent is waiting for the confirm request.
REQUIRES_CUSTOMER_ACTION: The PaymentIntent is waiting for further customer action of authentication, e.g. 3DS verification and QR code scan. Please check the next_action.
REQUIRES_CAPTURE: The PaymentIntent is waiting for your capture to complete the payment.
PENDING: The PaymentIntent is pending the final result from the provider. No further action is required.
SUCCEEDED: The PaymentIntent has succeeded. The payment is complete.
CANCELLED: The PaymentIntent has been canceled by your request. The payment is closed.
FAILED: The PaymentIntent has failed.
PARTIALLY_CAPTURED: A partially captured authorization has an outstanding balance; do not submit another capture.
EXPIRED: The pre-authorization expired and was released.
Remaining pre-authorized amount available for capture. A final capture consumes the available authorization; inspect capture_records for channel processing results.
Aggregate capture amount recorded on the PaymentIntent. Capture acceptance can update this value before channel completion; check capture_records for processing results.
Snapshot of the customer associated with this PaymentIntent. Returned when customer or customer_id was supplied at creation time. The customer's unique identifier is exposed at the top level as customer_id; the id field is not included inside this object.
PaymentIntent's client secret for browser or app. Returned by PaymentIntent create API or PaymentIntent retrieve API. The provided client_secret is valid for 60 minutes.
Latest PaymentAttempt; null when no payment attempt is available.
Latest payment attempt
No payment attempt
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"UQPAY Developer Docs","colors":{"primary":"#1A56DB","light":"#3B82F6","dark":"#1E40AF"},"logo":{"light":"https://mintcdn.com/uqpay-ecc4f4d8/-ww49FTUjAmlhKN6/images/logo-light.png?fit=max\u0026auto=format\u0026n=-ww49FTUjAmlhKN6\u0026q=85\u0026s=f7d617f71b284158f3d0d2a8e2872806","dark":"https://mintcdn.com/uqpay-ecc4f4d8/-ww49FTUjAmlhKN6/images/logo-dark.png?fit=max\u0026auto=format\u0026n=-ww49FTUjAmlhKN6\u0026q=85\u0026s=3fd4b4156eb5c214e01f731ef3f34eb3","href":"/"},"favicon":"https://mintcdn.com/uqpay-ecc4f4d8/LSVZGfPa5IJvbfLG/images/favicon.png?fit=max\u0026auto=format\u0026n=LSVZGfPa5IJvbfLG\u0026q=85\u0026s=b827dc48353a177e8a524fd888b06f90","contextual":{"options":["cursor","vscode","mcp","add-mcp"],"display":"header"},"variables":{"sdk-release-line":"3.1","sdk-node-current":"3.1.0","sdk-python-current":"3.1.0","sdk-go-current":"3.1.0","sdk-java-current":"3.1.0","sdk-cli-current":"3.1.0"},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","default":true,"navbar":{"links":[{"href":"/changelog","label":"Changelog"}]},"href":"account-center/v1.6/guide/overview"},{"language":"zh","navbar":{"links":[{"href":"/zh/changelog","label":"更新日志"}]},"href":"zh/account-center/v1.6/guide/overview"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"uqpay-ecc4f4d8","hasAudioNarration":false,"actualSubdomain":"uqpay-ecc4f4d8","customDomains":["developers-sandbox.uqpaytech.com"],"gitSource":{"type":"github","owner":"marshall-uq","repo":"uqpay-developer-docs","deployBranch":"sandbox","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ab7d43e1f314e367e7a139f","collectionId":"cda03377-3e47-4f38-a089-845d2586e57c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ab7d43e1f314e367e7a139f"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ab7d43e1f314e367e7a139f","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"en","tag":"API Reference","count":136},{"language":"zh","tag":"API 参考","count":136},{"language":"en","tag":"Guide","count":93},{"language":"zh","tag":"指南","count":93},{"language":"en","tag":"Card Issuance","count":78},{"language":"zh","tag":"Card Issuance","count":78},{"language":"en","tag":"Stablecoin Account","count":70},{"language":"zh","tag":"Stablecoin Account","count":66},{"language":"en","tag":"Global Account","count":52},{"language":"zh","tag":"Global Account","count":52},{"language":"en","tag":"AI Knowledge Base","count":47},{"language":"en","tag":"Global Acquiring","count":47},{"language":"zh","tag":"AI 知识库","count":47},{"language":"zh","tag":"Global Acquiring","count":47},{"language":"en","tag":"Webhooks","count":40},{"language":"zh","tag":"Webhooks","count":40},{"language":"en","tag":"Account Center","count":37},{"language":"en","tag":"Card Issuance API","count":37},{"language":"zh","tag":"Account Center","count":37},{"language":"zh","tag":"Card Issuance API","count":37}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"#assistant-entry,#assistant-entry-mobile,#chat-assistant-sheet{display:none!important}[data-component-part=products-selector-item]:has(svg[style*=sparkles]),[data-component-part=products-selector-trigger]:has(svg[style*=sparkles]){display:none!important}.landing-page{margin:-1.5rem -1.5rem 0}.landing-hero{padding:5rem 1.5rem 4rem;position:relative;border-bottom:1px solid #e5e7eb}.landing-badge{display:inline-block;padding:.3rem .85rem;background:#eff6ff;border:1px solid #bfdbfe;border-radius:100px;color:#1d4ed8;font-size:.8rem;font-weight:500;letter-spacing:.01em;margin-bottom:1.5rem}.landing-quickstart{margin-top:-2rem;position:relative;z-index:10;padding-bottom:1rem}.landing-steps-container{background:#fff;border-radius:1rem;box-shadow:0 4px 24px rgba(0,0,0,.06),0 1px 3px rgba(0,0,0,.03);border:1px solid #e5e7eb;overflow:hidden}.landing-step{display:flex;align-items:center;gap:1rem;padding:1.25rem 1.5rem;text-decoration:none;transition:background .15s ease;border-right:1px solid #f0f0f0}.landing-step:last-child{border-right:none}.landing-step:hover{background:#f8fafc;text-decoration:none}.landing-step-number{display:flex;align-items:center;justify-content:center;min-width:2.25rem;height:2.25rem;background:#1a56db;color:#fff;font-weight:700;font-size:.85rem;border-radius:.5rem}.landing-step-title{display:block;font-weight:600;font-size:.9rem;color:#111827}.landing-step-desc{display:block;font-size:.8rem;color:#6b7280;margin-top:.1rem}.landing-devtools{background:#f8fafc;border-radius:1.5rem;margin:0 1rem 2rem}.landing-page [class*=Card]{transition:transform .2s ease,box-shadow .2s ease}.landing-page [class*=Card]:hover{transform:translateY(-2px);box-shadow:0 8px 24px rgba(0,0,0,.06)}.dark .landing-hero{border-bottom-color:#1f2937}.dark .landing-badge{background:rgba(29,78,216,.15);border-color:rgba(59,130,246,.3);color:#60a5fa}.dark .landing-steps-container{background:#1f2937;border-color:#374151;box-shadow:0 4px 24px rgba(0,0,0,.3)}.dark .landing-step{border-right-color:#374151}.dark .landing-step:hover{background:#263244}.dark .landing-step-number{background:#2563eb}.dark .landing-step-title{color:#f3f4f6}.dark .landing-step-desc{color:#9ca3af}.dark .landing-devtools{background:#111827}@media (max-width:768px){.landing-step{border-right:none;border-bottom:1px solid #f0f0f0}.landing-step:last-child{border-bottom:none}.dark .landing-step{border-bottom-color:#374151}}@media (min-width:900px){#error-code-table{width:100%!important;min-width:0!important;table-layout:fixed}#error-code-table td,#error-code-table th{min-width:0!important;padding-left:.75rem;padding-right:.75rem;vertical-align:top;overflow-wrap:anywhere}#error-code-table th:nth-child(1){width:20%}#error-code-table th:nth-child(2){width:28%}#error-code-table th:nth-child(3){width:23%}#error-code-table th:nth-child(4){width:29%}#error-code-table code.mint-whitespace-nowrap,#error-code-table code.whitespace-nowrap{display:inline-block;max-width:100%;white-space:normal!important;overflow-wrap:anywhere;word-break:break-word}}"}],"page":{"pagePath":"global-acquiring/v1.6/api-reference/confirm-payment-intent","slug":"/global-acquiring/v1.6/api-reference/confirm-payment-intent","pageMetadata":{"title":"Confirm a PaymentIntent","description":"Confirms a payment intent for processing","deprecated":null,"version":null,"sidebarTitle":"Confirm payment intent","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/payment_intents/{id}/confirm","href":"/global-acquiring/v1.6/api-reference/confirm-payment-intent","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Confirms a payment intent for processing\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Confirm a PaymentIntent","description":"Confirms a payment intent for processing","deprecated":null,"version":null,"sidebarTitle":"Confirm payment intent","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/payment_intents/{id}/confirm","href":"/global-acquiring/v1.6/api-reference/confirm-payment-intent","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/uqpay-ecc4f4d8/77dcf16d44608ed8/error-code-table.js"],"openApiReferenceData":{"operation":{"summary":"Confirm a PaymentIntent","description":"Confirms a payment intent for processing","operationId":"confirm-payment-intent","x-mint":{"href":"/global-acquiring/v1.6/api-reference/confirm-payment-intent"},"tags":["Payment Intents"],"parameters":["01bb9fe4-5f7b-4cd8-97b6-fba12781e31a","4f0a32c9-6b0f-4314-a699-38516b02654e","e791a23e-7d6d-497a-a181-23887d90ae60","90e2f600-baf6-42d8-a530-1df8eaf61071"],"requestBody":"1bd93bcf-a268-4170-a0f0-fbee23e6a452","responses":{"200":"e2a70d76-2b52-4849-bdd9-8427fe48b4f1"},"method":"post","type":"path","servers":["d847b3de-ab64-4f74-88d8-0cd213f288af","ddf4e041-e7fd-46dd-87b9-25d8dd2de8af"],"security":["0b896c3b-909f-48d8-b424-aabe1fc8d157"],"path":"/v2/payment_intents/{id}/confirm","baseUrlOptions":["https://api-sandbox.uqpaytech.com/api","https://api.uqpay.com/api"],"title":"Confirm a PaymentIntent","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"01bb9fe4-5f7b-4cd8-97b6-fba12781e31a":{"name":"id","in":"path","required":true,"description":"The unique ID of a payment intent.","schema":{"type":"string","example":"PI1925112193204883441","isRequired":true,"description":"The unique ID of a payment intent.","uniqueKey":"","typeLabel":"string"}},"4f0a32c9-6b0f-4314-a699-38516b02654e":{"in":"header","name":"x-on-behalf-of","schema":{"type":"string","isRequired":false,"description":"Specifies the sub-account on whose behalf the request is made. This should be set to the `account_id`, which can be retrieved via the [List Connected Accounts](/account-center/v1.6/api-reference/list-connected-accounts). If omitted or empty, the request is executed using the master account.\nMore information at [Connected Accounts](/account-center/v1.6/guide/connected-accounts).\n","uniqueKey":"","typeLabel":"string"},"required":false,"description":"Specifies the sub-account on whose behalf the request is made. This should be set to the `account_id`, which can be retrieved via the [List Connected Accounts](/account-center/v1.6/api-reference/list-connected-accounts). If omitted or empty, the request is executed using the master account.\nMore information at [Connected Accounts](/account-center/v1.6/guide/connected-accounts).\n","example":"18523f72-f4de-4f9c-bb8e-ec7d1c4f32be"},"e791a23e-7d6d-497a-a181-23887d90ae60":{"in":"header","name":"x-idempotency-key","schema":{"type":"string","format":"uuid","isRequired":true,"description":"A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"required":true,"description":"A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.","example":"2adesf8e-9d63-44bc-b975-9b6ae3440dde"},"90e2f600-baf6-42d8-a530-1df8eaf61071":{"in":"header","name":"x-client-id","schema":{"type":"string","isRequired":true,"description":"The API client id generated by UQPAY","uniqueKey":"","typeLabel":"string"},"required":true,"description":"The API client id generated by UQPAY","example":"Up1HIsjiETgON9PMGPXLy7"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"authorization_type":{"type":"string","description":"Authorization mode. Pre-authorization requires account and channel support, card or card_present, and auto_capture=false. If supplied both here and inside payment_method, the values must match. When omitted, the payment method value is used, otherwise ordinary authorization applies.","enum":["authorization","pre_authorization"],"uniqueKey":"authorization_type","typeLabel":"enum\u003cstring>"},"payment_method":{"oneOf":[{"type":"object","title":"card","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","card"],"properties":{"type":{"type":"string","enum":["card"],"isRequired":true,"uniqueKey":"payment_method.oneOf.0.type","typeLabel":"enum\u003cstring>"},"card":{"type":"object","required":["card_name","card_number","expiry_month","expiry_year","cvc","network","billing","three_ds_action"],"properties":{"card_name":{"type":"string","description":"Card holder name. Maximum length is 128.","isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.card_name","typeLabel":"string"},"card_number":{"type":"string","description":"Card number.","isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.card_number","typeLabel":"string"},"expiry_month":{"type":"string","description":"Two digit number representing the card's expiration month.","isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.expiry_month","typeLabel":"string"},"expiry_year":{"type":"string","description":"Four digit number representing the card's expiration year.","isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.expiry_year","typeLabel":"string"},"cvc":{"type":"string","description":"The CVC code of this card is mandatory for all transactions, except for those initiated by the merchant or involving network tokenization.","isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.cvc","typeLabel":"string"},"network":{"type":"string","description":"The card network. The card networks listed are accepted values for this field. Availability is evaluated at the account level.","enum":["visa","mastercard","unionpay"],"isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.network","typeLabel":"enum\u003cstring>"},"billing":{"description":"Billing information of the customer.","type":"object","required":["first_name","last_name","email","address"],"properties":{"first_name":{"type":"string","description":"First name of the customer. Maximum length is 128.","maxLength":128,"example":"John","isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.billing.first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Last name of the customer. Maximum length is 128.","maxLength":128,"example":"Doe","isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.billing.last_name","typeLabel":"string"},"email":{"type":"string","description":"Email address of the customer.","maxLength":225,"example":"[email protected]","format":"email","isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.billing.email","typeLabel":"string\u003cemail>"},"address":{"type":"object","required":["country_code","city","street","postcode"],"properties":{"country_code":{"type":"string","description":"The two-letter country code in ISO 3166-1 alpha-2 format.","minLength":2,"maxLength":2,"example":"SG","isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.billing.address.country_code","typeLabel":"string"},"city":{"type":"string","description":"City of the address. Maximum of 100 characters.","maxLength":100,"example":"Singapore","isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.billing.address.city","typeLabel":"string"},"street":{"type":"string","description":"Street of the address. Maximum of 100 characters.","maxLength":100,"example":"444 Orchard Rd, Midpoint Orchard, Singapore ","isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.billing.address.street","typeLabel":"string"},"postcode":{"type":"string","description":"Postcode of the address. Maximum of 10 characters.","maxLength":10,"example":"924011","isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.billing.address.postcode","typeLabel":"string"},"state":{"type":"string","description":"State or province of the address. Maximum of 100 characters.\n\n- Required when `country_code` is \"US\" or \"CA\".\n","maxLength":100,"example":"","uniqueKey":"payment_method.oneOf.0.card.billing.address.state","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.billing.address","typeLabel":"object"},"phone_number":{"type":"string","description":"Phone number of the customer.","maxLength":36,"example":"12025550123","uniqueKey":"payment_method.oneOf.0.card.billing.phone_number","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.billing","typeLabel":"object"},"three_ds_action":{"type":"string","description":"Controls 3D Secure behavior for this payment:\n- `enforce_3ds`: Always trigger 3DS authentication, regardless of issuer risk assessment.\n- `skip_3ds`: Skip 3DS authentication. The liability for chargebacks remains with the merchant.\n","enum":["enforce_3ds","skip_3ds"],"isRequired":true,"uniqueKey":"payment_method.oneOf.0.card.three_ds_action","typeLabel":"enum\u003cstring>"},"auto_capture":{"type":"boolean","default":false,"description":"Specifies whether the funds should be requested automatically after the payment is authorized. Set it to `false` if you want to capture the funds sometimes later.","uniqueKey":"payment_method.oneOf.0.card.auto_capture","typeLabel":"boolean"},"authorization_type":{"type":"string","description":"Authorization mode. Pre-authorization requires account and channel support and auto_capture=false. Match the top-level authorization_type when both are supplied. Use authorization_expires_at from the response for the holding deadline.","enum":["authorization","pre_authorization"],"uniqueKey":"payment_method.oneOf.0.card.authorization_type","typeLabel":"enum\u003cstring>"},"three_ds":{"type":"object","properties":{"return_url":{"type":"string","description":"Return URL for 3ds callbacks (in case 3ds is triggered).","uniqueKey":"payment_method.oneOf.0.card.three_ds.return_url","typeLabel":"string"},"acs_response":{"type":"string","description":"3DS ACS response (application/x-www-form-urlencoded).","uniqueKey":"payment_method.oneOf.0.card.three_ds.acs_response","typeLabel":"string"},"device_data_collection_res":{"type":"string","description":"Device data collection response.","uniqueKey":"payment_method.oneOf.0.card.three_ds.device_data_collection_res","typeLabel":"string"},"ds_transaction_id":{"type":"string","description":"3DS transactionId.","uniqueKey":"payment_method.oneOf.0.card.three_ds.ds_transaction_id","typeLabel":"string"}},"uniqueKey":"payment_method.oneOf.0.card.three_ds","typeLabel":"object"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.0.card","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.0","typeLabel":"card · object"},{"type":"object","title":"card_present","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","card_present"],"properties":{"type":{"type":"string","enum":["card_present"],"isRequired":true,"uniqueKey":"payment_method.oneOf.1.type","typeLabel":"enum\u003cstring>"},"card_present":{"type":"object","required":["card_number","expiry_month","expiry_year","pan_entry_mode"],"properties":{"card_number":{"type":"string","description":"Card number.","isRequired":true,"uniqueKey":"payment_method.oneOf.1.card_present.card_number","typeLabel":"string"},"expiry_month":{"type":"string","description":"MM","isRequired":true,"uniqueKey":"payment_method.oneOf.1.card_present.expiry_month","typeLabel":"string"},"expiry_year":{"type":"string","description":"YYYY","isRequired":true,"uniqueKey":"payment_method.oneOf.1.card_present.expiry_year","typeLabel":"string"},"pan_entry_mode":{"type":"string","enum":["manual_entry","chip","magstripe","contactless_chip","contactless_magstripe"],"description":"The way the terminal reads the card information:\n- `manual_entry`: Manually keyed into POS terminal\n- `chip`: Read from direct contact with a chip card\n- `magstripe`: Read from direct contact with magnetic stripe card\n- `contactless_chip`: Read from a contactless interface using chip data\n- `contactless_magstripe`: Read from a contactless interface using magnetic stripe data (MSD)\n","isRequired":true,"uniqueKey":"payment_method.oneOf.1.card_present.pan_entry_mode","typeLabel":"enum\u003cstring>"},"authorization_type":{"type":"string","enum":["authorization","pre_authorization"],"description":"Authorization mode. Must match the top-level value when both are supplied.","uniqueKey":"payment_method.oneOf.1.card_present.authorization_type","typeLabel":"enum\u003cstring>"},"auto_capture":{"type":"boolean","description":"Whether to capture automatically. Must be false for pre-authorization.","uniqueKey":"payment_method.oneOf.1.card_present.auto_capture","typeLabel":"boolean"},"cardholder_verification_method":{"type":"string","description":"Method used to verify the cardholder's identity at the point of sale.\n- `online_pin`: Cardholder entered a PIN that was verified online by the issuer.\n- `manual_signature`: Cardholder provided a handwritten signature.\n- `skipped`: Cardholder verification was not performed (e.g., contactless under floor limit).\n","enum":["online_pin","manual_signature","skipped"],"uniqueKey":"payment_method.oneOf.1.card_present.cardholder_verification_method","typeLabel":"enum\u003cstring>"},"encrypted_pin":{"type":"string","description":"Encrypted personal identification number.","uniqueKey":"payment_method.oneOf.1.card_present.encrypted_pin","typeLabel":"string"},"fallback":{"type":"boolean","default":false,"description":"The default is false. Set to true when:\n- Chip card at a chip-capable terminal was unable to process transactions using data on the chip or magnetic strip and use entry mode manual\n- Chip card at a chip-capable terminal was unable to process transactions using data on the chip and use entry mode `contact_magnetic_stripe_card`\n","uniqueKey":"payment_method.oneOf.1.card_present.fallback","typeLabel":"boolean"},"fallback_reason":{"type":"string","enum":["chip_read_failure"],"description":"Fallback reason applicable when fallback is true.\nSet to `chip_read_failure` when all of the following conditions are met:\n- The transaction is initiated at a chip-capable terminal\n- `pan_entry_mode` is `magstripe`\n- The previous transaction initiated by the terminal was an unsuccessful chip read\n","uniqueKey":"payment_method.oneOf.1.card_present.fallback_reason","typeLabel":"enum\u003cstring>"},"emv_tags":{"type":"string","description":"Tag-length-value (TLV)-encoded data read from a chip card.\n","uniqueKey":"payment_method.oneOf.1.card_present.emv_tags","typeLabel":"string"},"track1":{"type":"string","description":"Track 1 read from magnetic stripe card","uniqueKey":"payment_method.oneOf.1.card_present.track1","typeLabel":"string"},"track2":{"type":"string","description":"Track 2 is read from a magnetic stripe card or is track 2\nequivalent data get from the chip card.\nTrack 2 is required when pan_entry_mode is not `manual_entry`.\n","uniqueKey":"payment_method.oneOf.1.card_present.track2","typeLabel":"string"},"terminal_info":{"type":"object","properties":{"terminal_id":{"type":"string","maxLength":8,"description":"An up to 8 digit alphanumeric ID used to identify the terminal at the card acceptor location of the user's POS system.","uniqueKey":"payment_method.oneOf.1.card_present.terminal_info.terminal_id","typeLabel":"string"},"mobile_device":{"type":"boolean","default":false,"description":"Indicate whether the POS terminal is a mobile POS device.","uniqueKey":"payment_method.oneOf.1.card_present.terminal_info.mobile_device","typeLabel":"boolean"},"system_trace_audit_number":{"type":"string","maxLength":6,"minLength":6,"pattern":"^[0-9]{6}$","description":"System Trace Audit Number. A 6-digit numeric sequence that uniquely identifies each transaction processed by a terminal. Critical for transaction reconciliation and dispute resolution.","uniqueKey":"payment_method.oneOf.1.card_present.terminal_info.system_trace_audit_number","typeLabel":"string"},"use_embedded_reader":{"type":"boolean","default":true,"description":"Indicate whether the reader is embedded in a mobile POS device.","uniqueKey":"payment_method.oneOf.1.card_present.terminal_info.use_embedded_reader","typeLabel":"boolean"}},"uniqueKey":"payment_method.oneOf.1.card_present.terminal_info","typeLabel":"object"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.1.card_present","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.1","typeLabel":"card_present · object"},{"type":"object","title":"applepay","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","applepay"],"properties":{"type":{"type":"string","enum":["applepay"],"isRequired":true,"uniqueKey":"payment_method.oneOf.2.type","typeLabel":"enum\u003cstring>"},"applepay":{"type":"object","required":["flow","network","token_type","auth_method","network_token"],"description":"Apple Pay payment information. Required when `type` is set to `applepay`.","properties":{"flow":{"type":"string","description":"Specifies the checkout flow type:\n- `redirect`: Redirect-based online payment\n- `mobile_web`: Mobile browser (H5) payment\n- `mobile_app`: Native app payment\n- `contactless`: In-person NFC contactless payment\n","enum":["redirect","mobile_web","mobile_app","contactless"],"isRequired":true,"uniqueKey":"payment_method.oneOf.2.applepay.flow","typeLabel":"enum\u003cstring>"},"network":{"type":"string","description":"The card network (lowercase).","enum":["visa","mastercard","amex","discover","jcb"],"isRequired":true,"uniqueKey":"payment_method.oneOf.2.applepay.network","typeLabel":"enum\u003cstring>"},"token_type":{"type":"string","description":"The token data format:\n- `decrypted`: Merchant has decrypted the Apple Pay token and provides structured DPAN + Cryptogram data\n- `encrypted`: Raw encrypted Apple Pay token (reserved for future use)\n","enum":["decrypted","encrypted"],"isRequired":true,"uniqueKey":"payment_method.oneOf.2.applepay.token_type","typeLabel":"enum\u003cstring>"},"auth_method":{"type":"string","description":"The authentication method used by Apple Pay:\n- `cryptogram_3ds`: Token includes a cryptogram, 3DS is already applied. No additional 3DS required.\n- `pan_only`: Token contains only PAN data. Additional 3DS verification may be triggered.\n","enum":["cryptogram_3ds","pan_only"],"isRequired":true,"uniqueKey":"payment_method.oneOf.2.applepay.auth_method","typeLabel":"enum\u003cstring>"},"network_token":{"type":"object","required":["number","expiry_month","expiry_year","cryptogram"],"description":"The decrypted Network Token data. Required when `token_type` is `decrypted`.","properties":{"number":{"type":"string","description":"Device Primary Account Number (DPAN), 12-52 characters.","minLength":12,"maxLength":52,"example":"4176660000000027","isRequired":true,"uniqueKey":"payment_method.oneOf.2.applepay.network_token.number","typeLabel":"string"},"expiry_month":{"type":"string","description":"Two-digit expiration month (01-12).","minLength":2,"maxLength":2,"example":"12","isRequired":true,"uniqueKey":"payment_method.oneOf.2.applepay.network_token.expiry_month","typeLabel":"string"},"expiry_year":{"type":"string","description":"Four-digit expiration year.","minLength":4,"maxLength":4,"example":"2027","isRequired":true,"uniqueKey":"payment_method.oneOf.2.applepay.network_token.expiry_year","typeLabel":"string"},"cryptogram":{"type":"string","description":"Online Payment Cryptogram (Base64 encoded). Only required when `auth_method` is `cryptogram_3ds`.","example":"AgAAAAAABk4DWZ4C28yUQAAAAAA=","isRequired":true,"uniqueKey":"payment_method.oneOf.2.applepay.network_token.cryptogram","typeLabel":"string"},"eci":{"type":"string","description":"Electronic Commerce Indicator. Only required when `auth_method` is `cryptogram_3ds`. Typical value: `07`.","example":"07","uniqueKey":"payment_method.oneOf.2.applepay.network_token.eci","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.2.applepay.network_token","typeLabel":"object"},"os_type":{"type":"string","description":"Required when `flow` is `mobile_web` or `mobile_app`. Fixed value `ios` for Apple Pay.","enum":["ios"],"uniqueKey":"payment_method.oneOf.2.applepay.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment. Set to `true` for in-person (contactless) payments, `false` for online payments.","default":false,"uniqueKey":"payment_method.oneOf.2.applepay.is_present","typeLabel":"boolean"},"card_type":{"type":"string","description":"The type of the card.","enum":["debit","credit"],"uniqueKey":"payment_method.oneOf.2.applepay.card_type","typeLabel":"enum\u003cstring>"},"billing_contact":{"type":"object","description":"Billing contact information from Apple Pay.","properties":{"first_name":{"type":"string","description":"Given name (first name).","uniqueKey":"payment_method.oneOf.2.applepay.billing_contact.first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Family name (last name).","uniqueKey":"payment_method.oneOf.2.applepay.billing_contact.last_name","typeLabel":"string"},"email":{"type":"string","format":"email","description":"Email address.","uniqueKey":"payment_method.oneOf.2.applepay.billing_contact.email","typeLabel":"string\u003cemail>"},"phone":{"type":"string","description":"Phone number.","uniqueKey":"payment_method.oneOf.2.applepay.billing_contact.phone","typeLabel":"string"},"address":{"type":"object","description":"Billing address.","properties":{"street":{"type":"string","description":"Street address.","uniqueKey":"payment_method.oneOf.2.applepay.billing_contact.address.street","typeLabel":"string"},"city":{"type":"string","description":"City.","uniqueKey":"payment_method.oneOf.2.applepay.billing_contact.address.city","typeLabel":"string"},"state":{"type":"string","description":"State or province.","uniqueKey":"payment_method.oneOf.2.applepay.billing_contact.address.state","typeLabel":"string"},"postal_code":{"type":"string","description":"Postal code.","uniqueKey":"payment_method.oneOf.2.applepay.billing_contact.address.postal_code","typeLabel":"string"},"country_code":{"type":"string","description":"Country code (ISO 3166-1 alpha-2).","uniqueKey":"payment_method.oneOf.2.applepay.billing_contact.address.country_code","typeLabel":"string"}},"uniqueKey":"payment_method.oneOf.2.applepay.billing_contact.address","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.2.applepay.billing_contact","typeLabel":"object"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.2.applepay","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.2","typeLabel":"applepay · object"},{"type":"object","title":"googlepay","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","googlepay"],"properties":{"type":{"type":"string","enum":["googlepay"],"isRequired":true,"uniqueKey":"payment_method.oneOf.3.type","typeLabel":"enum\u003cstring>"},"googlepay":{"type":"object","required":["flow","network","token_type","auth_method","network_token"],"description":"Google Pay payment information. Required when `type` is set to `googlepay`.","properties":{"flow":{"type":"string","description":"Specifies the checkout flow type:\n- `redirect`: Redirect-based online payment\n- `mobile_web`: Mobile browser (H5) payment\n- `mobile_app`: Native app payment\n- `contactless`: In-person NFC contactless payment\n","enum":["redirect","mobile_web","mobile_app","contactless"],"isRequired":true,"uniqueKey":"payment_method.oneOf.3.googlepay.flow","typeLabel":"enum\u003cstring>"},"network":{"type":"string","description":"The card network (lowercase).","enum":["visa","mastercard","amex","discover","jcb"],"isRequired":true,"uniqueKey":"payment_method.oneOf.3.googlepay.network","typeLabel":"enum\u003cstring>"},"token_type":{"type":"string","description":"The token data format:\n- `decrypted`: Merchant has decrypted the Google Pay token and provides structured DPAN + Cryptogram data\n- `encrypted`: Raw encrypted Google Pay token (reserved for future use)\n","enum":["decrypted","encrypted"],"isRequired":true,"uniqueKey":"payment_method.oneOf.3.googlepay.token_type","typeLabel":"enum\u003cstring>"},"auth_method":{"type":"string","description":"The authentication method used by Google Pay:\n- `cryptogram_3ds`: Token includes a cryptogram, 3DS is already applied. No additional 3DS required.\n- `pan_only`: Token contains only PAN data. Additional 3DS verification may be triggered.\n","enum":["cryptogram_3ds","pan_only"],"isRequired":true,"uniqueKey":"payment_method.oneOf.3.googlepay.auth_method","typeLabel":"enum\u003cstring>"},"network_token":{"type":"object","required":["number","expiry_month","expiry_year"],"description":"The decrypted Network Token data. Required when `token_type` is `decrypted`.","properties":{"number":{"type":"string","description":"Device Primary Account Number (DPAN), 12-52 characters.","minLength":12,"maxLength":52,"example":"4176660000000027","isRequired":true,"uniqueKey":"payment_method.oneOf.3.googlepay.network_token.number","typeLabel":"string"},"expiry_month":{"type":"string","description":"Two-digit expiration month (01-12).","minLength":2,"maxLength":2,"example":"12","isRequired":true,"uniqueKey":"payment_method.oneOf.3.googlepay.network_token.expiry_month","typeLabel":"string"},"expiry_year":{"type":"string","description":"Four-digit expiration year.","minLength":4,"maxLength":4,"example":"2027","isRequired":true,"uniqueKey":"payment_method.oneOf.3.googlepay.network_token.expiry_year","typeLabel":"string"},"cryptogram":{"type":"string","description":"Online Payment Cryptogram (Base64 encoded). Only required when `auth_method` is `cryptogram_3ds`.","example":"AgAAAAAABk4DWZ4C28yUQAAAAAA=","uniqueKey":"payment_method.oneOf.3.googlepay.network_token.cryptogram","typeLabel":"string"},"eci":{"type":"string","description":"Electronic Commerce Indicator. Only required when `auth_method` is `cryptogram_3ds`. Typical value: `05`.","example":"05","uniqueKey":"payment_method.oneOf.3.googlepay.network_token.eci","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.3.googlepay.network_token","typeLabel":"object"},"os_type":{"type":"string","description":"Required when `flow` is `mobile_web` or `mobile_app`. One of `ios`, `android`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.3.googlepay.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment. Set to `true` for in-person (contactless) payments, `false` for online payments.","default":false,"uniqueKey":"payment_method.oneOf.3.googlepay.is_present","typeLabel":"boolean"},"card_type":{"type":"string","description":"The type of the card.","enum":["debit","credit"],"uniqueKey":"payment_method.oneOf.3.googlepay.card_type","typeLabel":"enum\u003cstring>"},"billing_address":{"type":"object","description":"Billing address information from Google Pay.","properties":{"first_name":{"type":"string","description":"First name.","uniqueKey":"payment_method.oneOf.3.googlepay.billing_address.first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Last name.","uniqueKey":"payment_method.oneOf.3.googlepay.billing_address.last_name","typeLabel":"string"},"email":{"type":"string","format":"email","description":"Email address.","uniqueKey":"payment_method.oneOf.3.googlepay.billing_address.email","typeLabel":"string\u003cemail>"},"phone":{"type":"string","description":"Phone number.","uniqueKey":"payment_method.oneOf.3.googlepay.billing_address.phone","typeLabel":"string"},"address1":{"type":"string","description":"Address line 1.","uniqueKey":"payment_method.oneOf.3.googlepay.billing_address.address1","typeLabel":"string"},"address2":{"type":"string","description":"Address line 2.","uniqueKey":"payment_method.oneOf.3.googlepay.billing_address.address2","typeLabel":"string"},"locality":{"type":"string","description":"City or locality.","uniqueKey":"payment_method.oneOf.3.googlepay.billing_address.locality","typeLabel":"string"},"administrative_area":{"type":"string","description":"State, province, or administrative area.","uniqueKey":"payment_method.oneOf.3.googlepay.billing_address.administrative_area","typeLabel":"string"},"postal_code":{"type":"string","description":"Postal code.","uniqueKey":"payment_method.oneOf.3.googlepay.billing_address.postal_code","typeLabel":"string"},"country_code":{"type":"string","description":"Country code (ISO 3166-1 alpha-2).","uniqueKey":"payment_method.oneOf.3.googlepay.billing_address.country_code","typeLabel":"string"}},"uniqueKey":"payment_method.oneOf.3.googlepay.billing_address","typeLabel":"object"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.3.googlepay","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.3","typeLabel":"googlepay · object"},{"type":"object","title":"alipaycn","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","alipaycn"],"properties":{"type":{"type":"string","enum":["alipaycn"],"isRequired":true,"uniqueKey":"payment_method.oneOf.4.type","typeLabel":"enum\u003cstring>"},"alipaycn":{"type":"object","required":["flow"],"description":"AlipayCN payment information. Required when `type` is set to `alipaycn`","properties":{"flow":{"type":"string","description":"The specific payment flow to use.","enum":["qrcode"],"isRequired":true,"uniqueKey":"payment_method.oneOf.4.alipaycn.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Required when flow is `mobile_web` or `mobile_app`. One of `ios`, `android`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.4.alipaycn.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.4.alipaycn.is_present","typeLabel":"boolean"},"payment_code":{"type":"string","description":"The customer presents a payment code (generated from a payment app like an e-wallet) to the merchant for scanning.","uniqueKey":"payment_method.oneOf.4.alipaycn.payment_code","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.4.alipaycn","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.4","typeLabel":"alipaycn · object"},{"type":"object","title":"alipayhk","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","alipayhk"],"properties":{"type":{"type":"string","enum":["alipayhk"],"isRequired":true,"uniqueKey":"payment_method.oneOf.5.type","typeLabel":"enum\u003cstring>"},"alipayhk":{"type":"object","required":["flow"],"description":"AlipayHK payment information. Required when `type` is set to `alipayhk`","properties":{"flow":{"type":"string","description":"The specific payment flow to use.","enum":["qrcode"],"isRequired":true,"uniqueKey":"payment_method.oneOf.5.alipayhk.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Required when flow is `mobile_web` or `mobile_app`. One of `ios`, `android`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.5.alipayhk.os_type","typeLabel":"enum\u003cstring>"},"payment_code":{"type":"string","description":"The customer presents a payment code (generated from a payment app like an e-wallet) to the merchant for scanning.","uniqueKey":"payment_method.oneOf.5.alipayhk.payment_code","typeLabel":"string"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.5.alipayhk.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.5.alipayhk","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.5","typeLabel":"alipayhk · object"},{"type":"object","title":"unionpay","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","unionpay"],"properties":{"type":{"type":"string","enum":["unionpay"],"isRequired":true,"uniqueKey":"payment_method.oneOf.6.type","typeLabel":"enum\u003cstring>"},"unionpay":{"type":"object","required":["flow"],"description":"UnionPay payment information. Required when `type` is set to `unionpay`","properties":{"flow":{"type":"string","description":"The UnionPay checkout flow:\n- `qrcode`: Merchant-presented QR code for the customer to scan with the UnionPay app.\n- `securepay`: Server-to-server secure payment (redirect-based online checkout).\n","enum":["qrcode","securepay"],"isRequired":true,"uniqueKey":"payment_method.oneOf.6.unionpay.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Required when flow is `mobile_app`. One of `ios`, `android`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.6.unionpay.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.6.unionpay.is_present","typeLabel":"boolean"},"payment_code":{"type":"string","description":"The customer presents a payment code (generated from a payment app like an e-wallet) to the merchant for scanning.","uniqueKey":"payment_method.oneOf.6.unionpay.payment_code","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.6.unionpay","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.6","typeLabel":"unionpay · object"},{"type":"object","title":"wechatpay","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","wechatpay"],"properties":{"type":{"type":"string","enum":["wechatpay"],"isRequired":true,"uniqueKey":"payment_method.oneOf.7.type","typeLabel":"enum\u003cstring>"},"wechatpay":{"type":"object","required":["flow"],"description":"WeChat Pay payment information. Required when `type` is set to `wechatpay`.","properties":{"flow":{"type":"string","description":"The WeChat Pay checkout flow:\n- `qrcode`: Merchant-presented QR code for the customer to scan.\n- `mini_program`: Payment inside a WeChat Mini Program.\n- `mobile_app`: Payment triggered from a native mobile app via WeChat SDK.\n- `mobile_web`: Payment triggered from a mobile browser (H5), redirects to WeChat.\n- `official_account`: Payment inside a WeChat Official Account (JSAPI).\n","enum":["qrcode","mini_program","mobile_app","mobile_web","official_account"],"isRequired":true,"uniqueKey":"payment_method.oneOf.7.wechatpay.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Required when flow is `mobile_web` or `mobile_app`. One of `ios`, `android`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.7.wechatpay.os_type","typeLabel":"enum\u003cstring>"},"payment_code":{"type":"string","description":"The customer presents a payment code (generated from a payment app like an e-wallet) to the merchant for scanning.","uniqueKey":"payment_method.oneOf.7.wechatpay.payment_code","typeLabel":"string"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.7.wechatpay.is_present","typeLabel":"boolean"},"open_id":{"type":"string","description":"Required when `flow` is `mini_program`, `mobile_app` or `official_account`.","uniqueKey":"payment_method.oneOf.7.wechatpay.open_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.7.wechatpay","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.7","typeLabel":"wechatpay · object"},{"type":"object","title":"grabpay","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","grabpay"],"properties":{"type":{"type":"string","enum":["grabpay"],"isRequired":true,"uniqueKey":"payment_method.oneOf.8.type","typeLabel":"enum\u003cstring>"},"grabpay":{"type":"object","required":["flow"],"description":"GrabPay payment information. Required when `type` is set to `grabpay`.","properties":{"flow":{"type":"string","description":"Specifies the checkout flow type.","enum":["qrcode"],"isRequired":true,"uniqueKey":"payment_method.oneOf.8.grabpay.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Required when flow is `mobile_web`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.8.grabpay.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.8.grabpay.is_present","typeLabel":"boolean"},"payment_code":{"type":"string","description":"The customer presents a payment code (generated from a payment app like an e-wallet) to the merchant for scanning.","uniqueKey":"payment_method.oneOf.8.grabpay.payment_code","typeLabel":"string"},"shopper_name":{"type":"string","description":"The name of the shopper.","uniqueKey":"payment_method.oneOf.8.grabpay.shopper_name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.8.grabpay","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.8","typeLabel":"grabpay · object"},{"type":"object","title":"crypto","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","crypto"],"properties":{"type":{"type":"string","enum":["crypto"],"isRequired":true,"uniqueKey":"payment_method.oneOf.9.type","typeLabel":"enum\u003cstring>"},"crypto":{"type":"object","required":["flow","is_present"],"description":"Cryptocurrency payment information. Required when `type` is set to `crypto`.\n\n**Important:** Currency must be `USD`.\n\n**Legal Notice:**\nThis API Reference is issued and published by UQPAY PTY LTD (UQPAY Australia), a member of the UQPAY Group. As the sole publishing entity, UQPAY Australia assumes full and exclusive responsibility for the content, versioning, and maintenance of this document. Unless expressly stated otherwise, no other entity within the UQPAY Group shall be considered a publisher or held liable for the information contained herein.\n","properties":{"flow":{"type":"string","description":"The specific payment flow to use:\n- `redirect`: Redirects customer to a crypto payment gateway\n- `qrcode`: Generates a QR code for direct blockchain payment\n","enum":["redirect","qrcode"],"isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.flow","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment. Must be `false` for crypto payments.","enum":[false],"isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.is_present","typeLabel":"enum\u003cboolean>"},"network":{"type":"string","description":"Blockchain network for the transaction. Required when `flow` is `qrcode`.\n- `ETH`: Ethereum network\n- `TRON`: TRON network\n","enum":["ETH","TRON"],"uniqueKey":"payment_method.oneOf.9.crypto.network","typeLabel":"enum\u003cstring>"},"payer_info":{"type":"object","description":"Payer compliance information collected to satisfy the AML/CTF Travel Rule for virtual asset transfers.\n\n**Conditional requirement:** Required when the order amount reaches the compliance threshold configured by UQPAY for the merchant; otherwise this object can be omitted entirely.\n","required":["name","identifier"],"properties":{"name":{"type":"string","description":"Full legal name of the payer (individual or entity).","minLength":1,"maxLength":100,"example":"John Smith","isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.name","typeLabel":"string"},"identifier":{"type":"object","description":"A unique identifier for the payer. Exactly one identifier must be provided, selected via the `type` field. The structure of `value` varies based on `type`.\n","required":["type","value"],"properties":{"type":{"type":"string","description":"The category of identifier provided:\n- `document_number`: A government-issued identification document\n- `birth_info`: Date and place of birth\n- `address`: Structured residential or business address\n","enum":["document_number","birth_info","address"],"isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"object","title":"DocumentNumber","description":"The identifier payload. Structure depends on `type`.","required":["doc_type","number"],"properties":{"doc_type":{"type":"string","description":"The type of government-issued document.","enum":["passport","national_id","drivers_license"],"isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.0.doc_type","typeLabel":"enum\u003cstring>"},"number":{"type":"string","description":"The document number as printed on the document.","example":"A1234567","isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.0.number","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.0","typeLabel":"DocumentNumber · object"},{"type":"object","title":"BirthInfo","description":"The identifier payload. Structure depends on `type`.","required":["date","city","country"],"properties":{"date":{"type":"string","format":"date","description":"Date of birth in `YYYY-MM-DD` format.","example":"1990-01-01","isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.1.date","typeLabel":"string\u003cdate>"},"city":{"type":"string","description":"City of birth.","minLength":2,"maxLength":100,"example":"Sydney","isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.1.city","typeLabel":"string"},"country":{"type":"string","description":"Country of birth as an ISO 3166-1 alpha-3 code.","example":"AUS","isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.1.country","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.1","typeLabel":"BirthInfo · object"},{"type":"object","title":"Address","description":"The identifier payload. Structure depends on `type`.","required":["street","city","state","postcode","country"],"properties":{"street":{"type":"string","description":"Street address line.","example":"123 George St","isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.2.street","typeLabel":"string"},"city":{"type":"string","description":"City name.","example":"Sydney","isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.2.city","typeLabel":"string"},"state":{"type":"string","description":"State, province, or region.","example":"NSW","isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.2.state","typeLabel":"string"},"postcode":{"type":"string","description":"Postal or ZIP code.","example":"2000","isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.2.postcode","typeLabel":"string"},"country":{"type":"string","description":"Country as an ISO 3166-1 alpha-3 code. Defaults to `AUS` if not specified by the payer.","example":"AUS","isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.2.country","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value.oneOf.2","typeLabel":"Address · object"}],"isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier.value","typeLabel":"DocumentNumber · object | BirthInfo · object | Address · object"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto.payer_info.identifier","typeLabel":"object"},"email":{"type":"string","format":"email","description":"Payer email address. Validated for standard email format when provided.","minLength":5,"maxLength":100,"example":"[email protected]","uniqueKey":"payment_method.oneOf.9.crypto.payer_info.email","typeLabel":"string\u003cemail>"}},"uniqueKey":"payment_method.oneOf.9.crypto.payer_info","typeLabel":"object"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.9.crypto","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.9","typeLabel":"crypto · object"},{"type":"object","title":"paynow","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","paynow"],"properties":{"type":{"type":"string","enum":["paynow"],"isRequired":true,"uniqueKey":"payment_method.oneOf.10.type","typeLabel":"enum\u003cstring>"},"paynow":{"type":"object","required":["flow"],"description":"PayNow payment information. Required when `type` is set to `paynow`.","properties":{"flow":{"type":"string","description":"The checkout flow. Only `qrcode` (merchant-presented QR code) is supported.","enum":["qrcode"],"isRequired":true,"uniqueKey":"payment_method.oneOf.10.paynow.flow","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.10.paynow.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.10.paynow","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.10","typeLabel":"paynow · object"},{"type":"object","title":"truemoney","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","truemoney"],"properties":{"type":{"type":"string","enum":["truemoney"],"isRequired":true,"uniqueKey":"payment_method.oneOf.11.type","typeLabel":"enum\u003cstring>"},"truemoney":{"type":"object","required":["flow"],"description":"Truemoney payment information. Required when `type` is set to `truemoney`.","properties":{"flow":{"type":"string","description":"The specific payment flow to use.","enum":["qrcode"],"isRequired":true,"uniqueKey":"payment_method.oneOf.11.truemoney.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Required when flow is `mobile_web` or `mobile_app`. One of `ios`, `android`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.11.truemoney.os_type","typeLabel":"enum\u003cstring>"},"payment_code":{"type":"string","description":"The customer presents a payment code (generated from a payment app like an e-wallet) to the merchant for scanning.","uniqueKey":"payment_method.oneOf.11.truemoney.payment_code","typeLabel":"string"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.11.truemoney.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.11.truemoney","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.11","typeLabel":"truemoney · object"},{"type":"object","title":"tng","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","tng"],"properties":{"type":{"type":"string","enum":["tng"],"isRequired":true,"uniqueKey":"payment_method.oneOf.12.type","typeLabel":"enum\u003cstring>"},"tng":{"type":"object","required":["flow"],"description":"Touch'n Go payment information. Required when `type` is set to `tng`.","properties":{"flow":{"type":"string","description":"The specific payment flow to use.","enum":["qrcode"],"isRequired":true,"uniqueKey":"payment_method.oneOf.12.tng.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Required when flow is `mobile_web` or `mobile_app`. One of `ios`, `android`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.12.tng.os_type","typeLabel":"enum\u003cstring>"},"payment_code":{"type":"string","description":"The customer presents a payment code (generated from a payment app like an e-wallet) to the merchant for scanning.","uniqueKey":"payment_method.oneOf.12.tng.payment_code","typeLabel":"string"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.12.tng.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.12.tng","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.12","typeLabel":"tng · object"},{"type":"object","title":"gcash","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","gcash"],"properties":{"type":{"type":"string","enum":["gcash"],"isRequired":true,"uniqueKey":"payment_method.oneOf.13.type","typeLabel":"enum\u003cstring>"},"gcash":{"type":"object","required":["flow"],"description":"GCash payment information. Required when `type` is set to `gcash`.","properties":{"flow":{"type":"string","description":"The specific payment flow to use.","enum":["qrcode"],"isRequired":true,"uniqueKey":"payment_method.oneOf.13.gcash.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Required when flow is `mobile_web` or `mobile_app`. One of `ios`, `android`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.13.gcash.os_type","typeLabel":"enum\u003cstring>"},"payment_code":{"type":"string","description":"The customer presents a payment code (generated from a payment app like an e-wallet) to the merchant for scanning.","uniqueKey":"payment_method.oneOf.13.gcash.payment_code","typeLabel":"string"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.13.gcash.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.13.gcash","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.13","typeLabel":"gcash · object"},{"type":"object","title":"dana","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","dana"],"properties":{"type":{"type":"string","enum":["dana"],"isRequired":true,"uniqueKey":"payment_method.oneOf.14.type","typeLabel":"enum\u003cstring>"},"dana":{"type":"object","required":["flow"],"description":"Dana payment information. Required when `type` is set to `dana`.","properties":{"flow":{"type":"string","description":"The specific payment flow to use.","enum":["qrcode"],"isRequired":true,"uniqueKey":"payment_method.oneOf.14.dana.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Required when flow is `mobile_web` or `mobile_app`. One of `ios`, `android`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.14.dana.os_type","typeLabel":"enum\u003cstring>"},"payment_code":{"type":"string","description":"The customer presents a payment code (generated from a payment app like an e-wallet) to the merchant for scanning.","uniqueKey":"payment_method.oneOf.14.dana.payment_code","typeLabel":"string"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.14.dana.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.14.dana","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.14","typeLabel":"dana · object"},{"type":"object","title":"kakaopay","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","kakaopay"],"properties":{"type":{"type":"string","enum":["kakaopay"],"isRequired":true,"uniqueKey":"payment_method.oneOf.15.type","typeLabel":"enum\u003cstring>"},"kakaopay":{"type":"object","required":["flow"],"description":"KakaoPay payment information. Required when `type` is set to `kakaopay`.","properties":{"flow":{"type":"string","description":"The specific payment flow to use.","enum":["qrcode"],"isRequired":true,"uniqueKey":"payment_method.oneOf.15.kakaopay.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Required when flow is `mobile_web` or `mobile_app`. One of `ios`, `android`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.15.kakaopay.os_type","typeLabel":"enum\u003cstring>"},"payment_code":{"type":"string","description":"The customer presents a payment code (generated from a payment app like an e-wallet) to the merchant for scanning.","uniqueKey":"payment_method.oneOf.15.kakaopay.payment_code","typeLabel":"string"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.15.kakaopay.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.15.kakaopay","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.15","typeLabel":"kakaopay · object"},{"type":"object","title":"toss","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","toss"],"properties":{"type":{"type":"string","enum":["toss"],"isRequired":true,"uniqueKey":"payment_method.oneOf.16.type","typeLabel":"enum\u003cstring>"},"toss":{"type":"object","required":["flow"],"description":"Toss Pay payment information. Required when `type` is set to `toss`.","properties":{"flow":{"type":"string","description":"The specific payment flow to use.","enum":["qrcode"],"isRequired":true,"uniqueKey":"payment_method.oneOf.16.toss.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Required when flow is `mobile_web` or `mobile_app`. One of `ios`, `android`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.16.toss.os_type","typeLabel":"enum\u003cstring>"},"payment_code":{"type":"string","description":"The customer presents a payment code (generated from a payment app like an e-wallet) to the merchant for scanning.","uniqueKey":"payment_method.oneOf.16.toss.payment_code","typeLabel":"string"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.16.toss.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.16.toss","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.16","typeLabel":"toss · object"},{"type":"object","title":"naverpay","description":"The payment method details to confirm the PaymentIntent. The PaymentIntent will be confirmed automatically when `payment_method` is set.","required":["type","naverpay"],"properties":{"type":{"type":"string","enum":["naverpay"],"isRequired":true,"uniqueKey":"payment_method.oneOf.17.type","typeLabel":"enum\u003cstring>"},"naverpay":{"type":"object","required":["flow"],"description":"Naver Pay payment information. Required when `type` is set to `naverpay`.","properties":{"flow":{"type":"string","description":"The specific payment flow to use.","enum":["qrcode"],"isRequired":true,"uniqueKey":"payment_method.oneOf.17.naverpay.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Required when flow is `mobile_web` or `mobile_app`. One of `ios`, `android`.","enum":["ios","android"],"uniqueKey":"payment_method.oneOf.17.naverpay.os_type","typeLabel":"enum\u003cstring>"},"payment_code":{"type":"string","description":"The customer presents a payment code (generated from a payment app like an e-wallet) to the merchant for scanning.","uniqueKey":"payment_method.oneOf.17.naverpay.payment_code","typeLabel":"string"},"is_present":{"type":"boolean","description":"Whether the customer is physically present during payment.","default":false,"uniqueKey":"payment_method.oneOf.17.naverpay.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"payment_method.oneOf.17.naverpay","typeLabel":"object"}},"uniqueKey":"payment_method.oneOf.17","typeLabel":"naverpay · object"}],"uniqueKey":"payment_method","typeLabel":"card · object | card_present · object | applepay · object | googlepay · object | alipaycn · object | alipayhk · object | unionpay · object | wechatpay · object | grabpay · object | crypto · object | paynow · object | truemoney · object | tng · object | gcash · object | dana · object | kakaopay · object | toss · object | naverpay · object"},"ip_address":{"type":"string","maxLength":45,"description":"IPv4 or IPv6 address of the device.\n\nRequired when `payment_method.card.three_ds_action=enforce_3ds`.\nOptional otherwise.\n","example":"212.121.222.123","uniqueKey":"ip_address","typeLabel":"string"},"browser_info":{"type":"object","description":"Browser information collected for risk and fraud prevention.\nRequired when `three_ds_action=enforce_3ds`\n","required":["accept_header","browser","language","screen_color_depth","screen_height","screen_width"],"properties":{"accept_header":{"type":"string","maxLength":256,"description":"Browser accept header","example":"*/*","isRequired":true,"uniqueKey":"browser_info.accept_header","typeLabel":"string"},"browser":{"type":"object","description":"Browser specific information","required":["user_agent"],"properties":{"user_agent":{"type":"string","maxLength":256,"description":"Browser user agent string","example":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)","isRequired":true,"uniqueKey":"browser_info.browser.user_agent","typeLabel":"string"},"java_enabled":{"type":"boolean","description":"Whether Java is enabled in browser","uniqueKey":"browser_info.browser.java_enabled","typeLabel":"boolean"},"javascript_enabled":{"type":"boolean","description":"Whether JavaScript is enabled in browser","uniqueKey":"browser_info.browser.javascript_enabled","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"browser_info.browser","typeLabel":"object"},"language":{"type":"string","maxLength":8,"pattern":"^[a-zA-Z]{2}(-[a-zA-Z]{2})?$","description":"ISO language code (e.g. EN) or language-region (e.g. en-US)","example":"en-US","isRequired":true,"uniqueKey":"browser_info.language","typeLabel":"string"},"screen_color_depth":{"type":"integer","minimum":1,"maximum":48,"description":"Screen color depth in bits","example":24,"isRequired":true,"uniqueKey":"browser_info.screen_color_depth","typeLabel":"integer"},"screen_height":{"type":"integer","minimum":1,"maximum":9999,"description":"Screen height in pixels","example":1080,"isRequired":true,"uniqueKey":"browser_info.screen_height","typeLabel":"integer"},"screen_width":{"type":"integer","minimum":1,"maximum":9999,"description":"Screen width in pixels","example":1920,"isRequired":true,"uniqueKey":"browser_info.screen_width","typeLabel":"integer"},"device_id":{"type":"string","maxLength":36,"description":"Unique device identifier","example":"00000000-000000000000000","uniqueKey":"browser_info.device_id","typeLabel":"string"},"location":{"type":"object","description":"Device geolocation if available","properties":{"lat":{"type":"string","maxLength":12,"pattern":"^-?\\d{1,3}\\.\\d+$","description":"Latitude coordinate","example":"-37.81892","uniqueKey":"browser_info.location.lat","typeLabel":"string"},"lon":{"type":"string","maxLength":12,"pattern":"^-?\\d{1,3}\\.\\d+$","description":"Longitude coordinate","example":"144.95913","uniqueKey":"browser_info.location.lon","typeLabel":"string"}},"uniqueKey":"browser_info.location","typeLabel":"object"},"mobile":{"type":"object","description":"Mobile device–specific information. This object is required when the transaction is initiated from a mobile client. For web-based integrations, this object should be set to null.","properties":{"device_model":{"type":"string","maxLength":46,"description":"Mobile device model name","example":"Apple IPHONE 7","uniqueKey":"browser_info.mobile.device_model","typeLabel":"string"},"os_type":{"type":"string","enum":["IOS","ANDROID"],"description":"Mobile operating system","uniqueKey":"browser_info.mobile.os_type","typeLabel":"enum\u003cstring>"},"os_version":{"type":"string","maxLength":32,"description":"Operating system version","example":"IOS 14.5","uniqueKey":"browser_info.mobile.os_version","typeLabel":"string"}},"uniqueKey":"browser_info.mobile","typeLabel":"object"},"timezone":{"type":"string","maxLength":8,"description":"Timezone offset from UTC (e.g. -2 or 8)","example":"-2","uniqueKey":"browser_info.timezone","typeLabel":"string"}},"uniqueKey":"browser_info","typeLabel":"object"},"return_url":{"type":"string","maxLength":1024,"description":"The web page URL or application scheme URI to redirect the customer after payment authentication.","uniqueKey":"return_url","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"payment_method":{"type":"card","card":{"card_name":"\u003cstring>","card_number":"\u003cstring>","expiry_month":"\u003cstring>","expiry_year":"\u003cstring>","cvc":"\u003cstring>","billing":{"first_name":"John","last_name":"Doe","email":"[email protected]","address":{"country_code":"SG","city":"Singapore","street":"444 Orchard Rd, Midpoint Orchard, Singapore ","postcode":"924011","state":""},"phone_number":"12025550123"},"auto_capture":false,"three_ds":{"return_url":"\u003cstring>","acs_response":"\u003cstring>","device_data_collection_res":"\u003cstring>","ds_transaction_id":"\u003cstring>"}}},"ip_address":"212.121.222.123","return_url":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e2a70d76-2b52-4849-bdd9-8427fe48b4f1":{"description":"Payment intent confirmed successfully","content":{"application/json":{"schema":{"type":"object","required":["payment_intent_id","amount","currency","intent_status"],"properties":{"payment_intent_id":{"type":"string","example":"b1c2d3e4-f5a6-b7c8-d9e0-f1a2b3c4d5e6","description":"Unique identifier for the PaymentIntent","maxLength":36,"isRequired":true,"uniqueKey":"payment_intent_id","typeLabel":"string"},"amount":{"type":"string","example":"10.12","description":"Payment amount. This is the order amount you would like to charge your customer.","isRequired":true,"uniqueKey":"amount","typeLabel":"string"},"currency":{"type":"string","description":"Three-letter currency code","example":"SGD","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"intent_status":{"type":"string","description":"Status of this PaymentIntent.\n\n- `REQUIRES_PAYMENT_METHOD`: The PaymentIntent is waiting for the confirm request.\n- `REQUIRES_CUSTOMER_ACTION`: The PaymentIntent is waiting for further customer action of authentication, e.g. 3DS verification and QR code scan. Please check the `next_action`.\n- `REQUIRES_CAPTURE`: The PaymentIntent is waiting for your capture to complete the payment.\n- `PENDING`: The PaymentIntent is pending the final result from the provider. No further action is required.\n- `SUCCEEDED`: The PaymentIntent has succeeded. The payment is complete.\n- `CANCELLED`: The PaymentIntent has been canceled by your request. The payment is closed.\n- `FAILED`: The PaymentIntent has failed.\n- `PARTIALLY_CAPTURED`: A partially captured authorization has an outstanding balance; do not submit another capture.\n- `EXPIRED`: The pre-authorization expired and was released.\n","enum":["PARTIALLY_CAPTURED","EXPIRED","REQUIRES_PAYMENT_METHOD","REQUIRES_CUSTOMER_ACTION","REQUIRES_CAPTURE","PENDING","SUCCEEDED","CANCELLED","FAILED"],"example":"SUCCEEDED","isRequired":true,"uniqueKey":"intent_status","typeLabel":"enum\u003cstring>"},"current_funds_action":{"type":"object","description":"Refund or authorization-release details, when available in Retrieve or List PaymentIntents.","uniqueKey":"current_funds_action","typeLabel":"object"},"capture_records":{"type":"array","description":"Capture records returned by Retrieve and List PaymentIntents.","items":{"type":"object","properties":{"capture_id":{"type":"string","description":"Unique identifier of the capture.","uniqueKey":"capture_records.items.[INDEX].capture_id","typeLabel":"string"},"merchant_capture_order_id":{"oneOf":[{"type":"string","description":"Merchant capture reference, if supplied for the capture.","uniqueKey":"capture_records.items.[INDEX].merchant_capture_order_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Merchant capture reference, if supplied for the capture.","uniqueKey":"capture_records.items.[INDEX].merchant_capture_order_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"capture_records.items.[INDEX].merchant_capture_order_id","typeLabel":"string | null"},"capture_sequence":{"type":"integer","description":"Sequence of this capture within the authorization.","uniqueKey":"capture_records.items.[INDEX].capture_sequence","typeLabel":"integer"},"capture_amount":{"type":"string","description":"Amount of this capture.","uniqueKey":"capture_records.items.[INDEX].capture_amount","typeLabel":"string"},"currency":{"type":"string","description":"Currency of this capture.","uniqueKey":"capture_records.items.[INDEX].currency","typeLabel":"string"},"capture_mode":{"type":"string","description":"Whether the capture closes the authorization. The capture API accepts only final capture.","enum":["final","non_final"],"uniqueKey":"capture_records.items.[INDEX].capture_mode","typeLabel":"enum\u003cstring>"},"channel_capture_status":{"type":"integer","description":"Processing result: 0 pending, 1 processing, 2 completed, 3 failed. Capture acceptance is not channel completion.","enum":[0,1,2,3],"uniqueKey":"capture_records.items.[INDEX].channel_capture_status","typeLabel":"enum\u003cinteger>"},"arn":{"type":"string","description":"Acquirer reference number, when available.","uniqueKey":"capture_records.items.[INDEX].arn","typeLabel":"string"},"channel_capture_time":{"oneOf":[{"type":"string","description":"Channel capture timestamp, when available.","format":"date-time","uniqueKey":"capture_records.items.[INDEX].channel_capture_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"Channel capture timestamp, when available.","format":"date-time","uniqueKey":"capture_records.items.[INDEX].channel_capture_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"capture_records.items.[INDEX].channel_capture_time","typeLabel":"string\u003cdate-time> | null"},"request_time":{"type":"string","description":"Time the capture was requested.","format":"date-time","uniqueKey":"capture_records.items.[INDEX].request_time","typeLabel":"string\u003cdate-time>"},"complete_time":{"oneOf":[{"type":"string","description":"Completion timestamp, when available.","format":"date-time","uniqueKey":"capture_records.items.[INDEX].complete_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"Completion timestamp, when available.","format":"date-time","uniqueKey":"capture_records.items.[INDEX].complete_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"capture_records.items.[INDEX].complete_time","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"capture_records.items.[INDEX]","typeLabel":"object"},"uniqueKey":"capture_records","typeLabel":"object[]"},"authorization_type":{"type":"string","description":"Authorization mode for this payment.","enum":["authorization","pre_authorization"],"uniqueKey":"authorization_type","typeLabel":"enum\u003cstring>"},"authorization_expires_at":{"oneOf":[{"type":"string","description":"Pre-authorization expiry. Null when no expiry is recorded. Use the returned time rather than a fixed holding period.","format":"date-time","uniqueKey":"authorization_expires_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"Pre-authorization expiry. Null when no expiry is recorded. Use the returned time rather than a fixed holding period.","format":"date-time","uniqueKey":"authorization_expires_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"authorization_expires_at","typeLabel":"string\u003cdate-time> | null"},"available_to_capture":{"type":"string","description":"Remaining pre-authorized amount available for capture. A final capture consumes the available authorization; inspect capture_records for channel processing results.","uniqueKey":"available_to_capture","typeLabel":"string"},"available_to_void":{"type":"string","description":"Remaining pre-authorized amount, equal to available_to_capture. A positive value alone does not mean cancellation is permitted.","uniqueKey":"available_to_void","typeLabel":"string"},"description":{"type":"string","description":"Descriptor while creating a PaymentIntent.","maxLength":255,"uniqueKey":"description","typeLabel":"string"},"available_payment_method_types":{"oneOf":[{"type":"array","description":"Available payment method types for this PaymentIntent.","items":{"type":"string","uniqueKey":"available_payment_method_types.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"available_payment_method_types.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Available payment method types for this PaymentIntent.","items":{"type":"string"},"uniqueKey":"available_payment_method_types.oneOf.1","typeLabel":"null"}],"uniqueKey":"available_payment_method_types","typeLabel":"string[] | null"},"captured_amount":{"type":"string","example":"10.12","description":"Aggregate capture amount recorded on the PaymentIntent. Capture acceptance can update this value before channel completion; check capture_records for processing results.","uniqueKey":"captured_amount","typeLabel":"string"},"customer":{"type":"object","properties":{"id":{"type":"string","description":"Unique customer ID","example":"cus_hkduz3gvz1feg25e87fjcahsxq","uniqueKey":"customer.id","typeLabel":"string"},"external_customer_id":{"type":"string","description":"Identifier for the customer in your own system, echoed back when supplied at creation time.","example":"CUS_1715740800123","maxLength":128,"uniqueKey":"customer.external_customer_id","typeLabel":"string"},"first_name":{"type":"string","description":"Customer's first name","example":"John","maxLength":64,"uniqueKey":"customer.first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Customer's last name","example":"Doe","maxLength":64,"uniqueKey":"customer.last_name","typeLabel":"string"},"email":{"type":"string","format":"email","description":"Customer's email address","example":"[email protected]","maxLength":254,"uniqueKey":"customer.email","typeLabel":"string\u003cemail>"},"phone_number":{"type":"string","description":"Customer's phone number","example":"+1 123456789","maxLength":32,"uniqueKey":"customer.phone_number","typeLabel":"string"},"address":{"type":"object","required":["country_code","city","street","postcode"],"properties":{"country_code":{"type":"string","description":"The two-letter country code in ISO 3166-1 alpha-2 format.","minLength":2,"maxLength":2,"example":"SG","isRequired":true,"uniqueKey":"customer.address.country_code","typeLabel":"string"},"city":{"type":"string","description":"City of the address. Maximum of 100 characters.","maxLength":100,"example":"Singapore","isRequired":true,"uniqueKey":"customer.address.city","typeLabel":"string"},"street":{"type":"string","description":"Street of the address. Maximum of 100 characters.","maxLength":100,"example":"444 Orchard Rd, Midpoint Orchard, Singapore ","isRequired":true,"uniqueKey":"customer.address.street","typeLabel":"string"},"postcode":{"type":"string","description":"Postcode of the address. Maximum of 10 characters.","maxLength":10,"example":"924011","isRequired":true,"uniqueKey":"customer.address.postcode","typeLabel":"string"},"state":{"type":"string","description":"State or province of the address. Maximum of 100 characters.\n\n- Required when `country_code` is \"US\" or \"CA\".\n","maxLength":100,"example":"","uniqueKey":"customer.address.state","typeLabel":"string"}},"uniqueKey":"customer.address","typeLabel":"object"},"metadata":{"additionalProperties":{"maxLength":512,"type":"string","uniqueKey":"customer.metadata.additionalProperties","typeLabel":"string"},"example":{"key1":"value1","key2":"value2"},"description":"Any key-value object. Max length = 512 bytes. This must be valid JSON data.","type":"object","uniqueKey":"customer.metadata","typeLabel":"object"},"create_time":{"type":"string","format":"date/time","example":"2025-03-21T17:17:32+08:00","description":"Last time at which this customer was created.","uniqueKey":"customer.create_time","typeLabel":"string\u003cdate/time>"},"update_time":{"type":"string","format":"date/time","example":"2025-03-21T17:17:32+08:00","description":"Last time at which this customer was updated or operated on.","uniqueKey":"customer.update_time","typeLabel":"string\u003cdate/time>"}},"description":"Snapshot of the customer associated with this PaymentIntent. Returned when `customer` or `customer_id` was supplied at creation time. The customer's unique identifier is exposed at the top level as `customer_id`; the `id` field is not included inside this object.","uniqueKey":"customer","typeLabel":"object"},"customer_id":{"type":"string","description":"ID of the customer associated with this PaymentIntent. Empty for guest checkout.","example":"cus_asyknf3wlfxhs1s6plamk80i8v","maxLength":36,"uniqueKey":"customer_id","typeLabel":"string"},"cancel_time":{"oneOf":[{"type":"string","title":"Event timestamp","description":"Cancellation timestamp; an empty string when no cancellation time is recorded.","format":"date-time","uniqueKey":"cancel_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"string","title":"Event time unavailable","description":"Cancellation timestamp; an empty string when no cancellation time is recorded.","enum":[""],"uniqueKey":"cancel_time.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"cancel_time","typeLabel":"string\u003cdate-time> | enum\u003cstring>"},"cancellation_reason":{"type":"string","description":"Reason for canceling this PaymentIntent.","example":"Order cancelled","uniqueKey":"cancellation_reason","typeLabel":"string"},"client_secret":{"type":"string","description":"PaymentIntent's client secret for browser or app. Returned by PaymentIntent create API or PaymentIntent retrieve API. The provided client_secret is valid for 60 minutes.","example":"eyJhbGciOiJI***********ujNdZ1DF9CqWEfF1jphxI","uniqueKey":"client_secret","typeLabel":"string"},"merchant_order_id":{"type":"string","maxLength":36,"description":"The merchant reference id created in merchant's system that corresponds to this PaymentIntent","example":"1bf70d90-9ed0-48ce-9370-9bd7ef6ab9ee","uniqueKey":"merchant_order_id","typeLabel":"string"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"maxLength":512,"type":"string","uniqueKey":"metadata.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Metadata associated with the payment. Returns `null` when no metadata is set.","uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"maxLength":512,"type":"string","uniqueKey":"metadata.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Metadata associated with the payment. Returns `null` when no metadata is set.","uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | null"},"next_action":{"oneOf":[{"type":"object","description":"Null when no next action is available; otherwise follow the returned action instructions.","required":["type"],"properties":{"type":{"type":"string","description":"The type of action required to continue the payment.\n- `redirect_to_url`: Redirect the customer to a URL for authentication (e.g., 3DS verification or wallet login).\n- `display_qr_code`: Display a QR code for the customer to scan with their payment app.\n- `display_bank_details`: Display bank account details for the customer to complete a manual bank transfer.\n- `redirect_iframe`: Embed the provided iframe HTML into your page to display an inline authentication interface.\n","enum":["redirect_to_url","display_qr_code","display_bank_details","redirect_iframe"],"isRequired":true,"uniqueKey":"next_action.oneOf.0.type","typeLabel":"enum\u003cstring>"},"redirect_to_url":{"type":"object","description":"Contains instructions for authenticating a payment by redirecting your customer to another page or application.","properties":{"url":{"type":"string","format":"uri","description":"The URL you must redirect your customer to in order to authenticate the payment.","example":"https://example.checkout-page.com","uniqueKey":"next_action.oneOf.0.redirect_to_url.url","typeLabel":"string\u003curi>"},"return_url":{"oneOf":[{"type":"string","title":"Return URL","description":"Return URL after authentication; empty when no return URL is provided.","format":"uri","minLength":1,"example":"https://example.payment-result-page.com","uniqueKey":"next_action.oneOf.0.redirect_to_url.return_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"string","title":"No return URL","description":"Return URL after authentication; empty when no return URL is provided.","enum":[""],"example":"https://example.payment-result-page.com","uniqueKey":"next_action.oneOf.0.redirect_to_url.return_url.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"next_action.oneOf.0.redirect_to_url.return_url","typeLabel":"string\u003curi> | enum\u003cstring>"}},"uniqueKey":"next_action.oneOf.0.redirect_to_url","typeLabel":"object"},"redirect_iframe":{"type":"object","description":"Contains instructions for authenticating a payment using an iframe embed method. The client needs to embed the returned iframe script content into their page to complete the payment authentication flow.","properties":{"iframe":{"type":"string","format":"html","description":"Complete iframe HTML script content containing the authentication page embed code. The client must directly embed this script into their page to display the authentication interface.","uniqueKey":"next_action.oneOf.0.redirect_iframe.iframe","typeLabel":"string\u003chtml>"}},"uniqueKey":"next_action.oneOf.0.redirect_iframe","typeLabel":"object"},"display_qr_code":{"type":"object","description":"The field that contains QR code info.","properties":{"qr_code_url":{"type":"string","description":"The URL to the hosted WeChat Pay instructions page, which allows customers to view the WeChat Pay QR code.","example":"https://sg-acquiring-bucket-sandbox.s3.ap-southeast-1.amazonaws.com/payment/20250829/qrcode_PA1961262701099356160?X-Amz-Algorithm=AWS4-HMAC-SHA256\\u0026X-Amz-Credential=ASIAY******f987429","uniqueKey":"next_action.oneOf.0.display_qr_code.qr_code_url","typeLabel":"string"},"expires_at":{"type":"string","format":"date-time","description":"The date (unix timestamp) when the QR code expires.","uniqueKey":"next_action.oneOf.0.display_qr_code.expires_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"next_action.oneOf.0.display_qr_code","typeLabel":"object"},"display_bank_details":{"type":"object","description":"Contains the bank transfer details necessary for the customer to complete the payment.","properties":{"bank_name":{"type":"string","description":"The bank name of the account.","uniqueKey":"next_action.oneOf.0.display_bank_details.bank_name","typeLabel":"string"},"account_number":{"type":"string","description":"The account number.","example":"GB71950018692652646598","uniqueKey":"next_action.oneOf.0.display_bank_details.account_number","typeLabel":"string"},"routing_number":{"type":"string","description":"The routing number.","example":"012345678","uniqueKey":"next_action.oneOf.0.display_bank_details.routing_number","typeLabel":"string"}},"uniqueKey":"next_action.oneOf.0.display_bank_details","typeLabel":"object"}},"uniqueKey":"next_action.oneOf.0","typeLabel":"object"},{"type":"null","description":"Null when no next action is available; otherwise follow the returned action instructions.","required":["type"],"properties":{"type":{"type":"string","description":"The type of action required to continue the payment.\n- `redirect_to_url`: Redirect the customer to a URL for authentication (e.g., 3DS verification or wallet login).\n- `display_qr_code`: Display a QR code for the customer to scan with their payment app.\n- `display_bank_details`: Display bank account details for the customer to complete a manual bank transfer.\n- `redirect_iframe`: Embed the provided iframe HTML into your page to display an inline authentication interface.\n","enum":["redirect_to_url","display_qr_code","display_bank_details","redirect_iframe"]},"redirect_to_url":{"type":"object","description":"Contains instructions for authenticating a payment by redirecting your customer to another page or application.","properties":{"url":{"type":"string","format":"uri","description":"The URL you must redirect your customer to in order to authenticate the payment.","example":"https://example.checkout-page.com"},"return_url":{"oneOf":[{"type":"string","title":"Return URL","description":"Return URL after authentication; empty when no return URL is provided.","format":"uri","minLength":1,"example":"https://example.payment-result-page.com"},{"type":"string","title":"No return URL","description":"Return URL after authentication; empty when no return URL is provided.","enum":[""],"example":"https://example.payment-result-page.com"}]}}},"redirect_iframe":{"type":"object","description":"Contains instructions for authenticating a payment using an iframe embed method. The client needs to embed the returned iframe script content into their page to complete the payment authentication flow.","properties":{"iframe":{"type":"string","format":"html","description":"Complete iframe HTML script content containing the authentication page embed code. The client must directly embed this script into their page to display the authentication interface."}}},"display_qr_code":{"type":"object","description":"The field that contains QR code info.","properties":{"qr_code_url":{"type":"string","description":"The URL to the hosted WeChat Pay instructions page, which allows customers to view the WeChat Pay QR code.","example":"https://sg-acquiring-bucket-sandbox.s3.ap-southeast-1.amazonaws.com/payment/20250829/qrcode_PA1961262701099356160?X-Amz-Algorithm=AWS4-HMAC-SHA256\\u0026X-Amz-Credential=ASIAY******f987429"},"expires_at":{"type":"string","format":"date-time","description":"The date (unix timestamp) when the QR code expires."}}},"display_bank_details":{"type":"object","description":"Contains the bank transfer details necessary for the customer to complete the payment.","properties":{"bank_name":{"type":"string","description":"The bank name of the account."},"account_number":{"type":"string","description":"The account number.","example":"GB71950018692652646598"},"routing_number":{"type":"string","description":"The routing number.","example":"012345678"}}}},"uniqueKey":"next_action.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_action","typeLabel":"object | null"},"return_url":{"type":"string","description":"The web page URL or application scheme URI to redirect the customer after payment authentication.","example":"https://127.0.0.1:8080/api/v1/callback","uniqueKey":"return_url","typeLabel":"string"},"create_time":{"type":"string","format":"date/time","example":"2024-03-01T00:00:00+08:00","description":"Time at which this PaymentIntent was created.","uniqueKey":"create_time","typeLabel":"string\u003cdate/time>"},"complete_time":{"oneOf":[{"type":"string","title":"Event timestamp","description":"Completion timestamp; an empty string when no completion time is recorded.","format":"date-time","uniqueKey":"complete_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"string","title":"Event time unavailable","description":"Completion timestamp; an empty string when no completion time is recorded.","enum":[""],"uniqueKey":"complete_time.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"complete_time","typeLabel":"string\u003cdate-time> | enum\u003cstring>"},"update_time":{"type":"string","format":"date/time","example":"2024-03-01T00:00:00+08:00","description":"Last time at which this PaymentIntent was updated or operated on.","uniqueKey":"update_time","typeLabel":"string\u003cdate/time>"},"latest_payment_attempt":{"oneOf":[{"type":"object","title":"Latest payment attempt","description":"Latest PaymentAttempt; null when no payment attempt is available.","required":["attempt_id","amount","currency"],"properties":{"attempt_id":{"type":"string","description":"Unique identifier for the attempt.","example":"24fc62b4-90d1-42e3-96ab-dd54ccc648b3","isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.attempt_id","typeLabel":"string"},"amount":{"type":"string","example":"9.98","description":"Amount of the PaymentAttempt.","isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.amount","typeLabel":"string"},"currency":{"type":"string","description":"Three-letter currency code","example":"SGD","isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.currency","typeLabel":"string"},"authorization_type":{"type":"string","description":"Authorization mode for this payment.","enum":["authorization","pre_authorization"],"uniqueKey":"latest_payment_attempt.oneOf.0.authorization_type","typeLabel":"enum\u003cstring>"},"refunded_amount":{"type":"string","description":"Refunded amount.","example":"0.00","uniqueKey":"latest_payment_attempt.oneOf.0.refunded_amount","typeLabel":"string"},"create_time":{"type":"string","format":"date/time","example":"2025-03-21T17:17:32+08:00","description":"The time at which this PaymentAttempt was created.","uniqueKey":"latest_payment_attempt.oneOf.0.create_time","typeLabel":"string\u003cdate/time>"},"update_time":{"type":"string","format":"date/time","example":"2025-03-21T17:17:32+08:00","description":"Last time at which this PaymentAttempt was updated or operated on.","uniqueKey":"latest_payment_attempt.oneOf.0.update_time","typeLabel":"string\u003cdate/time>"},"complete_time":{"oneOf":[{"type":"string","title":"Event timestamp","description":"Completion timestamp; an empty string when no completion time is recorded.","format":"date-time","uniqueKey":"latest_payment_attempt.oneOf.0.complete_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"string","title":"Event time unavailable","description":"Completion timestamp; an empty string when no completion time is recorded.","enum":[""],"uniqueKey":"latest_payment_attempt.oneOf.0.complete_time.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"latest_payment_attempt.oneOf.0.complete_time","typeLabel":"string\u003cdate-time> | enum\u003cstring>"},"cancellation_reason":{"type":"string","description":"Reason for canceling this PaymentIntent.","example":"Order cancelled","uniqueKey":"latest_payment_attempt.oneOf.0.cancellation_reason","typeLabel":"string"},"auth_code":{"type":"string","description":"Authorization code returned by the issuer upon successful authorization.","example":"A12B3C","uniqueKey":"latest_payment_attempt.oneOf.0.auth_code","typeLabel":"string"},"arn":{"type":"string","description":"Acquirer Reference Number (ARN). A 23-digit identifier used for cross-institution reconciliation and chargeback tracking.","example":"74537604221222132710572","uniqueKey":"latest_payment_attempt.oneOf.0.arn","typeLabel":"string"},"rrn":{"type":"string","description":"Retrieval Reference Number (RRN). A 12-digit identifier used for transaction lookup and customer service queries.","example":"123456789012","uniqueKey":"latest_payment_attempt.oneOf.0.rrn","typeLabel":"string"},"advice_code":{"type":"string","description":"An empty string means no advice code was provided.\n\nIssuer advice code indicating the recommended action after a decline. Helps merchants implement intelligent retry strategies.\n\n- `01`: New attempt may succeed. Retry recommended.\n- `02`: Do not retry. Try a different payment method.\n- `03`: Do not retry. Cardholder should contact their issuer.\n- `21`: Cancel all pending authorizations. Card may be compromised.\n- `85`: Do not retry. Issuer will not approve this transaction type.\n","enum":["01","02","03","21","85",""],"example":"01","uniqueKey":"latest_payment_attempt.oneOf.0.advice_code","typeLabel":"enum\u003cstring>"},"authentication_data":{"type":"object","description":"Authentication and verification data for this payment attempt.","properties":{"cvv_result":{"type":"string","description":"An empty string means no verification result is available.\n\nCVV/CVC verification result returned by the issuer.\n\n- `M`: Match.\n- `N`: No match.\n- `P`: Not processed.\n- `U`: Unsupported.\n","enum":["M","N","P","U",""],"uniqueKey":"latest_payment_attempt.oneOf.0.authentication_data.cvv_result","typeLabel":"enum\u003cstring>"},"avs_result":{"type":"string","description":"Address Verification System (AVS) result. Indicates whether the billing address provided matches the issuer's records.","example":"Y","uniqueKey":"latest_payment_attempt.oneOf.0.authentication_data.avs_result","typeLabel":"string"},"three_ds":{"type":"object","properties":{"three_ds_version":{"type":"string","description":"The 3D Secure protocol version used for authentication.","example":"2.2.0","uniqueKey":"latest_payment_attempt.oneOf.0.authentication_data.three_ds.three_ds_version","typeLabel":"string"},"eci":{"type":"string","description":"Electronic Commerce Indicator. A two-digit code indicating the security level of the transaction and the liability shift outcome.","example":"05","uniqueKey":"latest_payment_attempt.oneOf.0.authentication_data.three_ds.eci","typeLabel":"string"},"cavv":{"type":"string","description":"Cardholder Authentication Verification Value. A cryptographic value generated by the issuer's Access Control Server confirming successful authentication.","example":"AAABCZIhcQAAAABZlyFxAAAAAAA=","uniqueKey":"latest_payment_attempt.oneOf.0.authentication_data.three_ds.cavv","typeLabel":"string"},"three_ds_authentication_status":{"type":"string","description":"An empty string means no authentication result is available.\n\nThe result of the 3DS authentication.\n\n- `Y`: Authentication successful.\n- `A`: Authentication attempted. Liability shift is granted but full authentication was not completed.\n- `N`: Authentication failed or denied.\n- `U`: Authentication could not be performed due to technical or other issues.\n- `R`: Authentication rejected by the issuer.\n- `C`: Challenge required. Additional verification steps are needed.\n","example":"Y","enum":["Y","A","N","U","R","C",""],"uniqueKey":"latest_payment_attempt.oneOf.0.authentication_data.three_ds.three_ds_authentication_status","typeLabel":"enum\u003cstring>"},"three_ds_cancellation_reason":{"type":"string","description":"The reason the 3DS authentication flow was cancelled, if applicable.","example":"01","uniqueKey":"latest_payment_attempt.oneOf.0.authentication_data.three_ds.three_ds_cancellation_reason","typeLabel":"string"}},"uniqueKey":"latest_payment_attempt.oneOf.0.authentication_data.three_ds","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.authentication_data","typeLabel":"object"},"payment_method":{"oneOf":[{"type":"object","title":"card","description":"The payment method details used for this PaymentAttempt.","required":["type","card"],"properties":{"type":{"type":"string","enum":["card"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.type","typeLabel":"enum\u003cstring>"},"card":{"type":"object","required":["card_name","card_number","network","authorization_type"],"properties":{"card_name":{"type":"string","description":"Card holder name. Maximum length is 128.","example":"john doe","isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.card_name","typeLabel":"string"},"card_number":{"type":"string","description":"Masked card number. First 6 digits (BIN) and last 4 digits are visible.","example":"541333******4047","isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.card_number","typeLabel":"string"},"network":{"type":"string","description":"The card network. Examples include `visa`, `mastercard`, `unionpay`.","enum":["visa","mastercard","unionpay"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.network","typeLabel":"enum\u003cstring>"},"authorization_type":{"type":"string","description":"Authorization mode. Pre-authorization requires account and channel support and auto_capture=false. Match the top-level authorization_type when both are supplied. Use authorization_expires_at from the response for the holding deadline.","enum":["authorization","pre_authorization"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.authorization_type","typeLabel":"enum\u003cstring>"},"brand":{"type":"string","description":"The card brand.","example":"visa","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.brand","typeLabel":"string"},"bin":{"type":"string","description":"Bank Identification Number. The first 6–8 digits of the card number identifying the issuing institution.","example":"541333","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.bin","typeLabel":"string"},"last4":{"type":"string","description":"The last four digits of the card number.","example":"4047","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.last4","typeLabel":"string"},"card_type":{"type":"string","description":"The card funding type.","enum":["credit","debit","prepaid"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.card_type","typeLabel":"enum\u003cstring>"},"expiry_month":{"type":"string","description":"Two-digit expiry month of the card.","example":"12","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.expiry_month","typeLabel":"string"},"expiry_year":{"type":"string","description":"Four-digit expiry year of the card.","example":"2027","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.expiry_year","typeLabel":"string"},"billing":{"description":"Billing information of the customer.","type":"object","required":["first_name","last_name","email","address"],"properties":{"first_name":{"type":"string","description":"First name of the customer. Maximum length is 128.","maxLength":128,"example":"John","isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.billing.first_name","typeLabel":"string"},"last_name":{"type":"string","description":"Last name of the customer. Maximum length is 128.","maxLength":128,"example":"Doe","isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.billing.last_name","typeLabel":"string"},"email":{"type":"string","description":"Email address of the customer.","maxLength":225,"example":"[email protected]","format":"email","isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.billing.email","typeLabel":"string\u003cemail>"},"address":{"type":"object","required":["country_code","city","street","postcode"],"properties":{"country_code":{"type":"string","description":"The two-letter country code in ISO 3166-1 alpha-2 format.","minLength":2,"maxLength":2,"example":"SG","isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.billing.address.country_code","typeLabel":"string"},"city":{"type":"string","description":"City of the address. Maximum of 100 characters.","maxLength":100,"example":"Singapore","isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.billing.address.city","typeLabel":"string"},"street":{"type":"string","description":"Street of the address. Maximum of 100 characters.","maxLength":100,"example":"444 Orchard Rd, Midpoint Orchard, Singapore ","isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.billing.address.street","typeLabel":"string"},"postcode":{"type":"string","description":"Postcode of the address. Maximum of 10 characters.","maxLength":10,"example":"924011","isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.billing.address.postcode","typeLabel":"string"},"state":{"type":"string","description":"State or province of the address. Maximum of 100 characters.\n\n- Required when `country_code` is \"US\" or \"CA\".\n","maxLength":100,"example":"","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.billing.address.state","typeLabel":"string"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.billing.address","typeLabel":"object"},"phone_number":{"type":"string","description":"Phone number of the customer.","maxLength":36,"example":"12025550123","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.billing.phone_number","typeLabel":"string"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.billing","typeLabel":"object"},"auto_capture":{"type":"boolean","default":true,"description":"Specifies whether the funds should be requested automatically after the payment is authorized. Default to `true`. Set it to `false` if you want to capture the funds sometimes later.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card.auto_capture","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0.card","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.0","typeLabel":"card · object"},{"type":"object","title":"applepay","description":"The payment method details used for this PaymentAttempt.","required":["type","applepay"],"properties":{"type":{"type":"string","enum":["applepay"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.1.type","typeLabel":"enum\u003cstring>"},"applepay":{"type":"object","description":"Apple Pay payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["redirect","mobile_web","mobile_app","contactless"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.1.applepay.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"The operating system type of the customer device.","enum":["ios"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.1.applepay.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.1.applepay.is_present","typeLabel":"boolean"},"network":{"type":"string","enum":["visa","mastercard","amex","discover","jcb"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.1.applepay.network","typeLabel":"enum\u003cstring>"},"card_type":{"type":"string","description":"The type of card used (e.g., credit, debit).","enum":["debit","credit"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.1.applepay.card_type","typeLabel":"enum\u003cstring>"},"token_type":{"type":"string","enum":["decrypted","encrypted"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.1.applepay.token_type","typeLabel":"enum\u003cstring>"},"auth_method":{"type":"string","enum":["cryptogram_3ds","pan_only"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.1.applepay.auth_method","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.1.applepay","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.1","typeLabel":"applepay · object"},{"type":"object","title":"googlepay","description":"The payment method details used for this PaymentAttempt.","required":["type","googlepay"],"properties":{"type":{"type":"string","enum":["googlepay"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.2.type","typeLabel":"enum\u003cstring>"},"googlepay":{"type":"object","description":"Google Pay payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["redirect","mobile_web","mobile_app","contactless"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.2.googlepay.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"The operating system type of the customer device.","enum":["ios","android"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.2.googlepay.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.2.googlepay.is_present","typeLabel":"boolean"},"network":{"type":"string","enum":["visa","mastercard","amex","discover","jcb"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.2.googlepay.network","typeLabel":"enum\u003cstring>"},"card_type":{"type":"string","description":"The type of card used (e.g., credit, debit).","enum":["debit","credit"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.2.googlepay.card_type","typeLabel":"enum\u003cstring>"},"token_type":{"type":"string","enum":["decrypted","encrypted"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.2.googlepay.token_type","typeLabel":"enum\u003cstring>"},"auth_method":{"type":"string","enum":["cryptogram_3ds","pan_only"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.2.googlepay.auth_method","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.2.googlepay","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.2","typeLabel":"googlepay · object"},{"type":"object","title":"alipaycn","description":"The payment method details used for this PaymentAttempt.","required":["type","alipaycn"],"properties":{"type":{"type":"string","enum":["alipaycn"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.3.type","typeLabel":"enum\u003cstring>"},"alipaycn":{"type":"object","description":"AlipayCN payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.3.alipaycn.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"The operating system type of the customer device.","enum":["ios","android"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.3.alipaycn.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.3.alipaycn.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.3.alipaycn","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.3","typeLabel":"alipaycn · object"},{"type":"object","title":"alipayhk","description":"The payment method details used for this PaymentAttempt.","required":["type","alipayhk"],"properties":{"type":{"type":"string","enum":["alipayhk"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.4.type","typeLabel":"enum\u003cstring>"},"alipayhk":{"type":"object","description":"AlipayHK payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.4.alipayhk.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"The operating system type of the customer device.","enum":["ios","android"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.4.alipayhk.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.4.alipayhk.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.4.alipayhk","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.4","typeLabel":"alipayhk · object"},{"type":"object","title":"unionpay","description":"The payment method details used for this PaymentAttempt.","required":["type","unionpay"],"properties":{"type":{"type":"string","enum":["unionpay"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.5.type","typeLabel":"enum\u003cstring>"},"unionpay":{"type":"object","description":"UnionPay payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode","securepay"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.5.unionpay.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"The operating system type of the customer device.","enum":["ios","android"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.5.unionpay.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.5.unionpay.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.5.unionpay","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.5","typeLabel":"unionpay · object"},{"type":"object","title":"wechatpay","description":"The payment method details used for this PaymentAttempt.","required":["type","wechatpay"],"properties":{"type":{"type":"string","enum":["wechatpay"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.6.type","typeLabel":"enum\u003cstring>"},"wechatpay":{"type":"object","description":"WeChat Pay payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode","mini_program","mobile_app","mobile_web","official_account"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.6.wechatpay.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Customer device operating system; empty when not supplied for the payment flow.","enum":["ios","android",""],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.6.wechatpay.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.6.wechatpay.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.6.wechatpay","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.6","typeLabel":"wechatpay · object"},{"type":"object","title":"grabpay","description":"The payment method details used for this PaymentAttempt.","required":["type","grabpay"],"properties":{"type":{"type":"string","enum":["grabpay"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.7.type","typeLabel":"enum\u003cstring>"},"grabpay":{"type":"object","description":"GrabPay payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.7.grabpay.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"Customer device operating system; empty when not supplied for the payment flow.","enum":["ios","android",""],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.7.grabpay.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.7.grabpay.is_present","typeLabel":"boolean"},"shopper_name":{"type":"string","description":"The name of the shopper.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.7.grabpay.shopper_name","typeLabel":"string"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.7.grabpay","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.7","typeLabel":"grabpay · object"},{"type":"object","title":"crypto","description":"The payment method details used for this PaymentAttempt.","required":["type","crypto"],"properties":{"type":{"type":"string","enum":["crypto"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.8.type","typeLabel":"enum\u003cstring>"},"crypto":{"type":"object","description":"Cryptocurrency payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["redirect","qrcode"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.8.crypto.flow","typeLabel":"enum\u003cstring>"},"network":{"type":"string","enum":["ETH","TRON"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.8.crypto.network","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.8.crypto.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.8.crypto","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.8","typeLabel":"crypto · object"},{"type":"object","title":"paynow","description":"The payment method details used for this PaymentAttempt.","required":["type","paynow"],"properties":{"type":{"type":"string","enum":["paynow"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.9.type","typeLabel":"enum\u003cstring>"},"paynow":{"type":"object","description":"PayNow payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.9.paynow.flow","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.9.paynow.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.9.paynow","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.9","typeLabel":"paynow · object"},{"type":"object","title":"truemoney","description":"The payment method details used for this PaymentAttempt.","required":["type","truemoney"],"properties":{"type":{"type":"string","enum":["truemoney"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.10.type","typeLabel":"enum\u003cstring>"},"truemoney":{"type":"object","description":"Truemoney payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.10.truemoney.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"The operating system type of the customer device.","enum":["ios","android"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.10.truemoney.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.10.truemoney.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.10.truemoney","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.10","typeLabel":"truemoney · object"},{"type":"object","title":"tng","description":"The payment method details used for this PaymentAttempt.","required":["type","tng"],"properties":{"type":{"type":"string","enum":["tng"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.11.type","typeLabel":"enum\u003cstring>"},"tng":{"type":"object","description":"Touch'n Go payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.11.tng.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"The operating system type of the customer device. An empty string means the operating system was not provided.","enum":["ios","android",""],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.11.tng.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.11.tng.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.11.tng","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.11","typeLabel":"tng · object"},{"type":"object","title":"gcash","description":"The payment method details used for this PaymentAttempt.","required":["type","gcash"],"properties":{"type":{"type":"string","enum":["gcash"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.12.type","typeLabel":"enum\u003cstring>"},"gcash":{"type":"object","description":"GCash payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.12.gcash.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"The operating system type of the customer device.","enum":["ios","android"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.12.gcash.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.12.gcash.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.12.gcash","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.12","typeLabel":"gcash · object"},{"type":"object","title":"dana","description":"The payment method details used for this PaymentAttempt.","required":["type","dana"],"properties":{"type":{"type":"string","enum":["dana"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.13.type","typeLabel":"enum\u003cstring>"},"dana":{"type":"object","description":"Dana payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.13.dana.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"The operating system type of the customer device.","enum":["ios","android"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.13.dana.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.13.dana.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.13.dana","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.13","typeLabel":"dana · object"},{"type":"object","title":"kakaopay","description":"The payment method details used for this PaymentAttempt.","required":["type","kakaopay"],"properties":{"type":{"type":"string","enum":["kakaopay"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.14.type","typeLabel":"enum\u003cstring>"},"kakaopay":{"type":"object","description":"KakaoPay payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.14.kakaopay.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"The operating system type of the customer device.","enum":["ios","android"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.14.kakaopay.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.14.kakaopay.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.14.kakaopay","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.14","typeLabel":"kakaopay · object"},{"type":"object","title":"toss","description":"The payment method details used for this PaymentAttempt.","required":["type","toss"],"properties":{"type":{"type":"string","enum":["toss"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.15.type","typeLabel":"enum\u003cstring>"},"toss":{"type":"object","description":"Toss Pay payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.15.toss.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"The operating system type of the customer device.","enum":["ios","android"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.15.toss.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.15.toss.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.15.toss","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.15","typeLabel":"toss · object"},{"type":"object","title":"naverpay","description":"The payment method details used for this PaymentAttempt.","required":["type","naverpay"],"properties":{"type":{"type":"string","enum":["naverpay"],"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.16.type","typeLabel":"enum\u003cstring>"},"naverpay":{"type":"object","description":"Naver Pay payment information returned in the response.","properties":{"flow":{"type":"string","description":"The checkout flow used for this payment.","enum":["qrcode"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.16.naverpay.flow","typeLabel":"enum\u003cstring>"},"os_type":{"type":"string","description":"The operating system type of the customer device.","enum":["ios","android"],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.16.naverpay.os_type","typeLabel":"enum\u003cstring>"},"is_present":{"type":"boolean","description":"Whether this is an in-person (offline) payment.","uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.16.naverpay.is_present","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.16.naverpay","typeLabel":"object"}},"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method.oneOf.16","typeLabel":"naverpay · object"}],"uniqueKey":"latest_payment_attempt.oneOf.0.payment_method","typeLabel":"card · object | applepay · object | googlepay · object | alipaycn · object | alipayhk · object | unionpay · object | wechatpay · object | grabpay · object | crypto · object | paynow · object | truemoney · object | tng · object | gcash · object | dana · object | kakaopay · object | toss · object | naverpay · object"},"failure_code":{"type":"string","description":"PaymentAttempt failure code. Possible values are defined in [Error Code Reference.payment_error](/global-acquiring/v1.6/guide/error-codes) section.","example":"","uniqueKey":"latest_payment_attempt.oneOf.0.failure_code","typeLabel":"string"},"attempt_status":{"type":"string","description":"The status of the attempt.\n- `INITIATED`: The payment attempt has been created based on the initial request.\n- `AUTHENTICATION_REDIRECTED`: Waiting for the customer to complete identity verification, such as 3D Secure or QR code scanning.\n- `PENDING_AUTHORIZATION`: The authorization request has been received and is pending a final decision from the payment provider.\n- `AUTHORIZED`: The authorization has been successfully completed. Payment will be captured automatically or manually depending on configuration.\n- `CAPTURE_REQUESTED`: The capture request has been submitted successfully, and the payment is considered complete.\n- `SETTLED`: Funds have been settled from the payment provider and received by UQPAY.\n- `SUCCEEDED`: UQPAY has settled funds to your wallet.\n- `CANCELLED`: The payment attempt has been cancelled. Any authorized funds, if applicable, will be returned to the customer.\n- `EXPIRED`: The payment attempt was not completed within the allowed time window and has expired.\n- `FAILED`: The payment attempt has failed. Please create a new PaymentAttempt to retry.\n","example":"INITIATED","enum":["INITIATED","AUTHENTICATION_REDIRECTED","PENDING_AUTHORIZATION","AUTHORIZED","CAPTURE_REQUESTED","SETTLED","SUCCEEDED","CANCELLED","EXPIRED","FAILED"],"uniqueKey":"latest_payment_attempt.oneOf.0.attempt_status","typeLabel":"enum\u003cstring>"}},"uniqueKey":"latest_payment_attempt.oneOf.0","typeLabel":"Latest payment attempt · object"},{"type":"object","title":"No payment attempt","description":"Latest PaymentAttempt; null when no payment attempt is available.","enum":[null],"uniqueKey":"latest_payment_attempt.oneOf.1","typeLabel":"No payment attempt · object"},{"type":"null","title":"No payment attempt","description":"Latest PaymentAttempt; null when no payment attempt is available.","enum":[null],"uniqueKey":"latest_payment_attempt.oneOf.2","typeLabel":"null"}],"uniqueKey":"latest_payment_attempt","typeLabel":"Latest payment attempt · object | No payment attempt · object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"payment_intent_id":"b1c2d3e4-f5a6-b7c8-d9e0-f1a2b3c4d5e6","amount":"10.12","currency":"SGD","intent_status":"SUCCEEDED","current_funds_action":{},"capture_records":[{"capture_id":"\u003cstring>","merchant_capture_order_id":"\u003cstring>","capture_sequence":123,"capture_amount":"\u003cstring>","currency":"\u003cstring>","capture_mode":"final","channel_capture_status":0,"arn":"\u003cstring>","channel_capture_time":"2023-11-07T05:31:56Z","request_time":"2023-11-07T05:31:56Z","complete_time":"2023-11-07T05:31:56Z"}],"authorization_type":"authorization","authorization_expires_at":"2023-11-07T05:31:56Z","available_to_capture":"\u003cstring>","available_to_void":"\u003cstring>","description":"\u003cstring>","available_payment_method_types":["\u003cstring>"],"captured_amount":"10.12","customer":{"id":"cus_hkduz3gvz1feg25e87fjcahsxq","external_customer_id":"CUS_1715740800123","first_name":"John","last_name":"Doe","email":"[email protected]","phone_number":"+1 123456789","address":{"country_code":"SG","city":"Singapore","street":"444 Orchard Rd, Midpoint Orchard, Singapore ","postcode":"924011","state":""},"metadata":{"key1":"value1","key2":"value2"},"create_time":"2025-03-21T17:17:32+08:00","update_time":"2025-03-21T17:17:32+08:00"},"customer_id":"cus_asyknf3wlfxhs1s6plamk80i8v","cancel_time":"2023-11-07T05:31:56Z","cancellation_reason":"Order cancelled","client_secret":"eyJhbGciOiJI***********ujNdZ1DF9CqWEfF1jphxI","merchant_order_id":"1bf70d90-9ed0-48ce-9370-9bd7ef6ab9ee","metadata":{},"next_action":{"type":"redirect_to_url","redirect_to_url":{"url":"https://example.checkout-page.com","return_url":"https://example.payment-result-page.com"},"redirect_iframe":{"iframe":"\u003cstring>"},"display_qr_code":{"qr_code_url":"https://sg-acquiring-bucket-sandbox.s3.ap-southeast-1.amazonaws.com/payment/20250829/qrcode_PA1961262701099356160?X-Amz-Algorithm=AWS4-HMAC-SHA256\\u0026X-Amz-Credential=ASIAY******f987429","expires_at":"2023-11-07T05:31:56Z"},"display_bank_details":{"bank_name":"\u003cstring>","account_number":"GB71950018692652646598","routing_number":"012345678"}},"return_url":"https://127.0.0.1:8080/api/v1/callback","create_time":"2024-03-01T00:00:00+08:00","complete_time":"2023-11-07T05:31:56Z","update_time":"2024-03-01T00:00:00+08:00","latest_payment_attempt":{"attempt_id":"24fc62b4-90d1-42e3-96ab-dd54ccc648b3","amount":"9.98","currency":"SGD","authorization_type":"authorization","refunded_amount":"0.00","create_time":"2025-03-21T17:17:32+08:00","update_time":"2025-03-21T17:17:32+08:00","complete_time":"2023-11-07T05:31:56Z","cancellation_reason":"Order cancelled","auth_code":"A12B3C","arn":"74537604221222132710572","rrn":"123456789012","advice_code":"01","authentication_data":{"cvv_result":"M","avs_result":"Y","three_ds":{"three_ds_version":"2.2.0","eci":"05","cavv":"AAABCZIhcQAAAABZlyFxAAAAAAA=","three_ds_authentication_status":"Y","three_ds_cancellation_reason":"01"}},"payment_method":{"type":"card","card":{"card_name":"john doe","card_number":"541333******4047","network":"visa","authorization_type":"authorization","brand":"visa","bin":"541333","last4":"4047","card_type":"credit","expiry_month":"12","expiry_year":"2027","billing":{"first_name":"John","last_name":"Doe","email":"[email protected]","address":{"country_code":"SG","city":"Singapore","street":"444 Orchard Rd, Midpoint Orchard, Singapore ","postcode":"924011","state":""},"phone_number":"12025550123"},"auto_capture":true}},"failure_code":"","attempt_status":"INITIATED"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0b896c3b-909f-48d8-b424-aabe1fc8d157":{"XAuthToken":{"type":"apiKey","in":"header","name":"x-auth-token","description":"The API token for login provided by UQPAY.","scopes":[]}}},"servers":{"d847b3de-ab64-4f74-88d8-0cd213f288af":{"url":"https://api-sandbox.uqpaytech.com/api","description":"Sandbox base URL."},"ddf4e041-e7fd-46dd-87b9-25d8dd2de8af":{"url":"https://api.uqpay.com/api","description":"Production base URL."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-auth-token","description":"The API token for login provided by UQPAY.","scopes":[]},"schema":{"title":"x-auth-token","type":"string","description":"The API token for login provided by UQPAY.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"XAuthToken","name":"x-auth-token"}],"title":"XAuthToken"}]},"originalFileLocation":"global-acquiring/v1.6/payment.yaml"},"subdomain":"uqpay-ecc4f4d8","siteName":"UQPAY Developer Docs","title":"Confirm a PaymentIntent - UQPAY Developer Docs","navMaps":{"firstHrefInVersion":{"v1.6":{"href":"/global-acquiring/v1.6/api-reference/confirm-payment-intent","matchLevel":0}},"firstHrefInLanguage":{"en":{"href":"/global-acquiring/v1.6/api-reference/confirm-payment-intent","matchLevel":0},"zh":{"href":"/zh/global-acquiring/v1.6/api-reference/confirm-payment-intent","matchLevel":1}}},"lastModified":"2026-09-26T14:19:00.568Z","originalFileLocation":"global-acquiring/v1.6/api-reference/confirm-payment-intent.mdx","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=\"system\"}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=\"description\" content=\"Confirms a payment intent for processing\">\u003cmeta data-mint-head name=\"application-name\" content=\"UQPAY Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/uqpay-ecc4f4d8/zJUnKnvS29IywmGk/_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=\"/docs/mintlify-assets/_mintlify/favicons/uqpay-ecc4f4d8/zJUnKnvS29IywmGk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/uqpay-ecc4f4d8/zJUnKnvS29IywmGk/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/uqpay-ecc4f4d8/zJUnKnvS29IywmGk/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/uqpay-ecc4f4d8/zJUnKnvS29IywmGk/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/uqpay-ecc4f4d8/zJUnKnvS29IywmGk/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/uqpay-ecc4f4d8/zJUnKnvS29IywmGk/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/uqpay-ecc4f4d8/zJUnKnvS29IywmGk/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/uqpay-ecc4f4d8/zJUnKnvS29IywmGk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Confirm a PaymentIntent - UQPAY Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Confirms a payment intent for processing\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"UQPAY Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://uqpay-ecc4f4d8.mintlify.app/_mintlify/api/og/v2?division=Payment+Intents\u0026amp;title=Confirm+a+PaymentIntent\u0026amp;description=Confirms+a+payment+intent+for+processing\u0026amp;theme=ee61e842face86fd00189b13\u0026amp;signature=95b8fc6317cb11dde53d9da0857d849fbc8b7564707fdb887f7d24f71de1a77b\">\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=\"Confirm a PaymentIntent - UQPAY Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Confirms a payment intent for processing\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://uqpay-ecc4f4d8.mintlify.app/_mintlify/api/og/v2?division=Payment+Intents\u0026amp;title=Confirm+a+PaymentIntent\u0026amp;description=Confirms+a+payment+intent+for+processing\u0026amp;theme=ee61e842face86fd00189b13\u0026amp;signature=95b8fc6317cb11dde53d9da0857d849fbc8b7564707fdb887f7d24f71de1a77b\">\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=\"/docs/mintlify-assets/_mintlify/favicons/uqpay-ecc4f4d8/zJUnKnvS29IywmGk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"UQPAY Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1A56DB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://developers-sandbox.uqpaytech.com/docs/zh/global-acquiring/v1.6/api-reference/confirm-payment-intent\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers-sandbox.uqpaytech.com/#organization\",\"name\":\"UQPAY Developer Docs\",\"url\":\"https://developers-sandbox.uqpaytech.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/uqpay-ecc4f4d8/-ww49FTUjAmlhKN6/images/logo-light.png?fit=max\u0026auto=format\u0026n=-ww49FTUjAmlhKN6\u0026q=85\u0026s=f7d617f71b284158f3d0d2a8e2872806\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers-sandbox.uqpaytech.com/docs#website\",\"name\":\"UQPAY Developer Docs\",\"url\":\"https://developers-sandbox.uqpaytech.com/docs\",\"publisher\":{\"@id\":\"https://developers-sandbox.uqpaytech.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent#webpage\",\"url\":\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent\",\"name\":\"Confirm a PaymentIntent\",\"description\":\"Confirms a payment intent for processing\",\"dateModified\":\"2026-09-26T14:19:00.568Z\",\"isPartOf\":{\"@id\":\"https://developers-sandbox.uqpaytech.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Payment API\",\"item\":\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/create-payment-intent\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Payment Intents\",\"item\":\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/create-payment-intent\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Confirm a PaymentIntent\",\"item\":\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent#apireference\",\"headline\":\"Confirm a PaymentIntent\",\"name\":\"Confirm a PaymentIntent\",\"description\":\"Confirms a payment intent for processing\",\"url\":\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent\",\"mainEntityOfPage\":{\"@id\":\"https://developers-sandbox.uqpaytech.com/docs/global-acquiring/v1.6/api-reference/confirm-payment-intent#webpage\"},\"dateModified\":\"2026-09-26T14:19:00.568Z\",\"publisher\":{\"@id\":\"https://developers-sandbox.uqpaytech.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers-sandbox.uqpaytech.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"UQPAY Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"UQPAY Developer Docs","nav":{"global":null,"languages":[{"language":"en","default":true,"navbar":{"links":[{"href":"/changelog","label":"Changelog"}]},"products":[{"product":"Account Center","icon":"user","pages":[{"title":"Account Center","href":"/account-center/v1.6/guide/overview"}]},{"product":"Global Acquiring","icon":"cash-register","versions":[{"version":"v1.6","tag":"Latest","tabs":[{"tab":"Guide","icon":"book-open","pages":[{"title":"Guide","href":"/global-acquiring/v1.6/guide/overview"}]},{"tab":"Webhooks","icon":"bell","pages":[{"title":"Webhooks","href":"/global-acquiring/v1.6/webhooks/paymentintent-result"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Payment API","pages":[{"group":"Payment Intents","pages":[{"title":"Create a PaymentIntent","deprecated":null,"version":null,"sidebarTitle":"Create payment intent","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/payment_intents/create","href":"/global-acquiring/v1.6/api-reference/create-payment-intent"},{"title":"Retrieve a PaymentIntent","deprecated":null,"version":null,"sidebarTitle":"Retrieve payment intent","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment_intents/{id}","href":"/global-acquiring/v1.6/api-reference/retrieve-payment-intent"},{"title":"Update a PaymentIntent","description":"Updates properties on a PaymentIntent object without confirming. Depending on which properties you update, you might need to confirm the PaymentIntent again. For example, updating the `payment_method` always requires you to confirm the PaymentIntent again. If you prefer to update and confirm at the same time, we recommend updating properties through the confirm API instead.","deprecated":null,"version":null,"sidebarTitle":"Update payment intent","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/payment_intents/{id}","href":"/global-acquiring/v1.6/api-reference/update-payment-intent"},{"title":"Confirm a PaymentIntent","deprecated":null,"version":null,"sidebarTitle":"Confirm payment intent","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/payment_intents/{id}/confirm","href":"/global-acquiring/v1.6/api-reference/confirm-payment-intent"},{"title":"Capture a PaymentIntent","description":"Capture the funds of an existing uncaptured PaymentIntent when its status is `REQUIRES_CAPTURE`.","deprecated":null,"version":null,"sidebarTitle":"Capture payment intent","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/payment_intents/{id}/capture","href":"/global-acquiring/v1.6/api-reference/capture-payment-intent"},{"title":"Cancel a PaymentIntent","deprecated":null,"version":null,"sidebarTitle":"Cancel payment intent","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/payment_intents/{id}/cancel","href":"/global-acquiring/v1.6/api-reference/cancel-payment-intent"},{"title":"List all PaymentIntents","deprecated":null,"version":null,"sidebarTitle":"List payment intents","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment_intents","href":"/global-acquiring/v1.6/api-reference/list-payment-intents"}]},{"group":"Payment Attempts","pages":[{"title":"Retrieve a PaymentAttempt","deprecated":null,"version":null,"sidebarTitle":"Retrieve payment attempt","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment/payment_attempts/{id}","href":"/global-acquiring/v1.6/api-reference/retrieve-payment-attempt"},{"title":"List all PaymentAttempts","deprecated":null,"version":null,"sidebarTitle":"List payment attempts","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment/payment_attempts","href":"/global-acquiring/v1.6/api-reference/list-payment-attempts"}]},{"group":"Payment Refunds","pages":[{"title":"List all refunds","deprecated":null,"version":null,"sidebarTitle":"List refunds","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment/refunds","href":"/global-acquiring/v1.6/api-reference/list-refunds"},{"title":"Create a refund","deprecated":null,"version":null,"sidebarTitle":"Create refund","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/payment/refunds","href":"/global-acquiring/v1.6/api-reference/create-refund"},{"title":"Retrieve a refund","deprecated":null,"version":null,"sidebarTitle":"Retrieve refund","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment/refunds/{id}","href":"/global-acquiring/v1.6/api-reference/retrieve-refund"}]},{"group":"Payment Reports","pages":[{"title":"Get list of settlements","deprecated":null,"version":null,"sidebarTitle":"Get list of settlements","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment/settlements","href":"/global-acquiring/v1.6/api-reference/get-list-of-settlements"}]},{"group":"Payment Balances","pages":[{"title":"Retrieve Balance","deprecated":null,"version":null,"sidebarTitle":"Retrieve balance","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment/balances/{currency}","href":"/global-acquiring/v1.6/api-reference/retrieve-balance"},{"title":"List Balances","deprecated":null,"version":null,"sidebarTitle":"List balances","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment/balances","href":"/global-acquiring/v1.6/api-reference/list-balances"}]},{"group":"Payment Payouts","pages":[{"title":"Create Payout","deprecated":null,"version":null,"sidebarTitle":"Create payout","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/payment/payout/create","href":"/global-acquiring/v1.6/api-reference/create-payout"},{"title":"Retrieve Payout","deprecated":null,"version":null,"sidebarTitle":"Retrieve payout","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment/payout/{payout_id}","href":"/global-acquiring/v1.6/api-reference/retrieve-payout"},{"title":"List all Payouts","deprecated":null,"version":null,"sidebarTitle":"List payouts","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment/payout","href":"/global-acquiring/v1.6/api-reference/list-payouts"}]},{"group":"Bank Accounts","pages":[{"title":"Create Bank Account","deprecated":null,"version":null,"sidebarTitle":"Create bank account","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/payment/bankaccount/create","href":"/global-acquiring/v1.6/api-reference/create-bank-account"},{"title":"Retrieve Bank Account","deprecated":null,"version":null,"sidebarTitle":"Retrieve bank account","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment/bankaccount/{id}","href":"/global-acquiring/v1.6/api-reference/retrieve-bank-account"},{"title":"Update Bank Account","deprecated":null,"version":null,"sidebarTitle":"Update bank account","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/payment/bankaccount/{id}","href":"/global-acquiring/v1.6/api-reference/update-bank-account"},{"title":"List all Bank Accounts","deprecated":null,"version":null,"sidebarTitle":"List bank accounts","openapi":"/global-acquiring/v1.6/payment.yaml get /v2/payment/bankaccount","href":"/global-acquiring/v1.6/api-reference/list-bank-accounts"}]},{"group":"Terminal Management","pages":[{"title":"Register Terminal","deprecated":null,"version":null,"sidebarTitle":"Register terminal","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/terminal/register","href":"/global-acquiring/v1.6/api-reference/register-terminal"},{"title":"Get PIN Key","deprecated":null,"version":null,"sidebarTitle":"Get pin key","openapi":"/global-acquiring/v1.6/payment.yaml post /v2/terminal/getPinKey","href":"/global-acquiring/v1.6/api-reference/get-pin-key"}]}]}]}]}]},{"product":"Global Account","icon":"building-columns","pages":[{"title":"Global Account","href":"/global-account/v1.6/guide/overview"}]},{"product":"Card Issuance","icon":"credit-card","pages":[{"title":"Card Issuance","href":"/card-issuance/v1.6/guide/overview"}]},{"product":"Stablecoin Account","icon":"arrow-right-arrow-left","pages":[{"title":"Stablecoin Account","href":"/stablecoin-account/v1.6/guide/overview"}]},{"product":"Developer Tools","icon":"code","pages":[{"title":"Developer Tools","href":"/developer-tools/mcp/mcp-integration-guide"}]},{"product":"AI Knowledge Base","icon":"sparkles","pages":[{"title":"AI Knowledge Base","href":"/ai-knowledge-base/card-issuing/corpus_overview"}]}]},{"language":"zh","navbar":{"links":[{"href":"/zh/changelog","label":"更新日志"}]},"pages":[{"title":"zh","href":"/zh/global-acquiring/v1.6/api-reference/confirm-payment-intent"}]}]},"basePath":"","title":"Confirm a PaymentIntent - UQPAY Developer Docs","buildId":"dpl_GWQzn6k13MqphA3qck3hQKoQXDzM","deploymentId":"dpl_GWQzn6k13MqphA3qck3hQKoQXDzM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-vlKR2tYY.js","utils-DBDPZSWe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CxHK4zz2.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-27b98BOz.js","snippetPresets-DNnui32z.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-cDVS2zyo.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BEE-OyDQ.js","shallow-fqEMZOYR.js","getApiPlaygroundDisplay-BPut1_OB.js","CodeSnippet-h9vp8UTG.js","CodeSnippets-DoMjCW5Q.js","Page-BOWGOUSK.js","getPastedJson-C4r-hmQ_.js","icon-CCDahfhO.js","MethodPill-Dpq0JSrS.js","DuplicateIcon-BGPwFt-j.js","createIcon-DBULrQp7.js","DynamicMarkdown-B74atANy.js","SectionHeading-DZCpbSmT.js","axios-vUo_bRtp.js","Markdown-BwkgxkAH.js","clsx-CEIlvfOI.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-f6OgbvLC.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DvlTOml0.js"]}