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 endpoint. If omitted or empty, the request is executed using the master account.
More information at Connected Accounts.
The total credit limit assigned to the card, currency refer to card_currency. This is not a cumulative balance, but a fixed credit limit similar to that of a credit card.
Field behavior by card product:
Business Mastercard and Personal Visa: card_limit is required during card creation and must be greater than or equal to 0.01.
Business Visa: card_limit is optional.
If omitted, the system defaults card_limit to 0.
If provided, the value must be greater than or equal to 0, with up to two decimal places. Negative values are not allowed.
The allowable amount for card transactions without PIN verification, including the currency unit (e.g., 2000USD). This response field should be distinguished from the corresponding request parameter, which specifies the amount without a currency unit.
Card status enum. See the Card lifecycle and statuses guide for more information.
PENDING: The request to create the card has been received and is under review.
ACTIVE: The request to create the card was successful and the card is ready to use.
FROZEN: All incoming authorization requests will be declined. The card can be reactivated to accept new authorizations.
BLOCKED: The card was blocked by UQPAY due to suspicious activity.
PRE_CANCEL: The card is scheduled for cancellation and is in a waiting period during which all incoming authorization requests are declined. It transitions to CANCELLED when the waiting period ends.
CANCELLED: The card cannot be reactivated from this state, all incoming authorization requests will be permanently declined.
LOST: The card has been reported as lost to UQPAY.
STOLEN: The card has been reported as stolen to UQPAY.
FAILED: The request to create a card using Create Card failed.
Reflects the cumulative amount of the card limit that has already been used.
Example:
"51.00"
{"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":"card-issuance/v1.6/api-reference/retrieve-card","slug":"/card-issuance/v1.6/api-reference/retrieve-card","pageMetadata":{"title":"Retrieve Card","description":"Retrieves the details for a card you issued previously. The card's secure information are not returned in the response.","deprecated":null,"version":null,"sidebarTitle":"Retrieve card","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/cards/{id}","href":"/card-issuance/v1.6/api-reference/retrieve-card","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: \"Retrieves the details for a card you issued previously. The card’s secure information are not returned in the response.\"\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":"Retrieve Card","description":"Retrieves the details for a card you issued previously. The card's secure information are not returned in the response.","deprecated":null,"version":null,"sidebarTitle":"Retrieve card","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/cards/{id}","href":"/card-issuance/v1.6/api-reference/retrieve-card","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/uqpay-ecc4f4d8/77dcf16d44608ed8/error-code-table.js"],"openApiReferenceData":{"operation":{"security":["ed42f11a-673b-4fce-b85f-b0da849df766"],"parameters":["c0a04550-b79f-4887-bf57-765453436c03","75c8b2a9-2238-42d2-9eed-0012a9af062d"],"summary":"Retrieve Card","description":"Retrieves the details for a card you issued previously. The card's secure information are not returned in the response.","operationId":"retrieve-card","x-mint":{"href":"/card-issuance/v1.6/api-reference/retrieve-card"},"tags":["Card Lifecycle"],"responses":{"200":"81cd0ee4-8a8c-44e2-b3a3-53d73085c50d"},"method":"get","type":"path","servers":["5a086068-fa68-494d-9eaa-28a3b87c8b36","cf839844-1e97-4acf-a627-62575c0269b5"],"path":"/v1/issuing/cards/{id}","baseUrlOptions":["https://api-sandbox.uqpaytech.com/api","https://api.uqpay.com/api"],"title":"Retrieve Card","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c0a04550-b79f-4887-bf57-765453436c03":{"name":"id","description":"Universally unique identifier (UUID v4) of a resource.","in":"path","required":true,"schema":{"type":"string","format":"uuid","example":"71fdb0fe-9682-457a-9361-e8868694f12f","isRequired":true,"description":"Universally unique identifier (UUID v4) of a resource.","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"75c8b2a9-2238-42d2-9eed-0012a9af062d":{"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) endpoint. 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) endpoint. 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"}},"responses":{"81cd0ee4-8a8c-44e2-b3a3-53d73085c50d":{"description":"OK - Successfully retrieved a card.","headers":{"x-response-id":{"description":"Universally unique identifier (UUID v4) for the response. Helpful for identifying a request when communicating with UQPAY support.","schema":{"type":"string","format":"uuid","example":"2adba88e-9d63-44bc-b975-9b6ae3440dde"}}},"content":{"application/json":{"examples":{"sandbox":{"title":"sandbox","value":{"available_balance":"1759.2","card_bin":"40963608","card_currency":"SGD","card_id":"e3577e62-5526-4284-a5b7-f718d83654ee","card_limit":2099.02,"card_number":"************9892","card_product_id":"467e993f-317a-49fc-9ea0-bf49de7d1f76","card_scheme":"VISA","card_status":"ACTIVE","cardholder":{"cardholder_id":"3a1d3ce4-977b-4f1d-8076-8d2dd59e942c","cardholder_status":"SUCCESS","create_time":"2025-10-11T11:52:27+08:00","email":"[email protected]","first_name":"Marshall","last_name":"Hu"},"consumed_amount":"339.82","form_factor":"VIRTUAL","metadata":{"contract_regression_run":"f9182c18-9377-4b32-ad53-18e8b1763d0b"},"mode_type":"SHARE","network_protection":{"enabled":false,"status":"NOT_ENROLLED"},"no_pin_payment_amount":"SGD","risk_controls":{"allow_3ds_transactions":"Y"},"spending_controls":[{"interval":"PER_TRANSACTION","amount":"25948"}],"update_reason":""}}},"schema":{"type":"object","required":["card_id","card_bin","mode_type","card_scheme","card_number","form_factor","card_limit","available_balance","cardholder","card_status","no_pin_payment_amount"],"properties":{"card_id":{"type":"string","example":"c0cef051-29c5-4796-b86a-cd5b684bfad7","description":"Unique identifier for the card.","isRequired":true,"uniqueKey":"card_id","typeLabel":"string"},"card_bin":{"type":"string","example":"40963608","description":"Card number prefix (BIN).","isRequired":true,"uniqueKey":"card_bin","typeLabel":"string"},"card_scheme":{"type":"string","example":"VISA","description":"Card scheme.","isRequired":true,"uniqueKey":"card_scheme","typeLabel":"string"},"card_number":{"type":"string","example":"************5668","description":"Masked card number","isRequired":true,"uniqueKey":"card_number","typeLabel":"string"},"form_factor":{"type":"string","example":"VIRTUAL","description":"Form of the card - `VIRTUAL` or `PHYSICAL`, currently only support virtual card.","enum":["VIRTUAL","PHYSICAL"],"isRequired":true,"uniqueKey":"form_factor","typeLabel":"enum\u003cstring>"},"mode_type":{"type":"string","example":"SHARE","enum":["SHARE","SINGLE"],"description":"Mode type enum - SINGLE or SHARE. \n\n * `SINGLE` - A single card only has prepaid mode.\n * `SHARE` - A share card can have debit mode, meaning it is associated with debit program and account.\n","isRequired":true,"uniqueKey":"mode_type","typeLabel":"enum\u003cstring>"},"card_limit":{"type":"number","example":2100.02,"minimum":0,"description":"The total credit limit assigned to the card, currency refer to `card_currency`. This is **not a cumulative balance**, but a fixed credit limit similar to that of a credit card. \n\n##### Field behavior by card product:\n- **Business Mastercard** and **Personal Visa**: `card_limit` is **required** during card creation and must be **greater than or equal to 0.01**.\n- **Business Visa**: `card_limit` is **optional**.\n - If omitted, the system defaults `card_limit` to 0.\n - If provided, the value must be **greater than or equal to 0**, with up to two decimal places. **Negative values are not allowed.**\n\nSee [Card products](/card-issuance/v1.6/guide/card-products) for the full capability matrix.\n","isRequired":true,"uniqueKey":"card_limit","typeLabel":"number"},"available_balance":{"type":"string","example":2000.05,"description":"The available balance, currency refer to `card_currency`.","isRequired":true,"uniqueKey":"available_balance","typeLabel":"string"},"cardholder":{"type":"object","properties":{"cardholder_id":{"type":"string","description":"The cardholder's unique identifier.","example":"7c4ff2cd-1bf6-4aaa-bf16-266771425011","format":"uuid","uniqueKey":"cardholder.cardholder_id","typeLabel":"string\u003cuuid>"},"email":{"type":"string","description":"The cardholder's email address.","example":"[email protected]","uniqueKey":"cardholder.email","typeLabel":"string"},"number_of_cards":{"type":"integer","description":"The total number of cards associated with the cardholder, including all statuses.","example":1,"uniqueKey":"cardholder.number_of_cards","typeLabel":"integer"},"first_name":{"description":"The first name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters.","type":"string","example":"Emily","uniqueKey":"cardholder.first_name","typeLabel":"string"},"last_name":{"description":"The last name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters.","type":"string","example":"Toy","uniqueKey":"cardholder.last_name","typeLabel":"string"},"create_time":{"description":"Time at which the object was created.","type":"string","example":"2024-05-09 15:52:23","uniqueKey":"cardholder.create_time","typeLabel":"string"},"cardholder_status":{"description":"The cardholder's status.","type":"string","default":"SUCCESS","enum":["FAILED","PENDING","SUCCESS","INCOMPLETE"],"uniqueKey":"cardholder.cardholder_status","typeLabel":"enum\u003cstring>"},"date_of_birth":{"description":"The cardholder's birth date with `yyyy-mm-dd` format. The cardholder must be at least 18 and under 80 years old.","type":"string","example":"1990-01-01","uniqueKey":"cardholder.date_of_birth","typeLabel":"string"},"country_code":{"type":"string","description":"Two-letter country code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).","maxLength":2,"example":"SG","uniqueKey":"cardholder.country_code","typeLabel":"string"},"phone_number":{"description":"The cardholder's phone number.\n\nSee [Phone number validation rules](/card-issuance/v1.6/guide/phone-number-validation-rules-for-cardholder) for length validation details.\n","type":"string","example":"86683306","uniqueKey":"cardholder.phone_number","typeLabel":"string"},"gender":{"type":"string","description":"The cardholder's gender. An empty string means it was not provided.","enum":["MALE","FEMALE",""],"uniqueKey":"cardholder.gender","typeLabel":"enum\u003cstring>"},"nationality":{"oneOf":[{"type":"string","title":"Provided nationality","description":"The cardholder's nationality. An empty string means it was not provided.","maxLength":2,"minLength":2,"example":"SG","uniqueKey":"cardholder.nationality.oneOf.0","typeLabel":"string"},{"type":"string","title":"Nationality not provided","description":"The cardholder's nationality. An empty string means it was not provided.","enum":[""],"uniqueKey":"cardholder.nationality.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"cardholder.nationality","typeLabel":"string | enum\u003cstring>"},"residential_address":{"type":"object","description":"The cardholder's collected residential address. Fields that have not been collected may be omitted. A successful cardholder status does not imply that all address fields are present. Card issuance requirements depend on the selected product's required_fields.\n","properties":{"country":{"type":"string","description":"Two-letter country code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).","maxLength":2,"example":"SG","uniqueKey":"cardholder.residential_address.country","typeLabel":"string"},"state":{"type":"string","description":"State, county, province, or region.","maxLength":128,"example":"Singapore","uniqueKey":"cardholder.residential_address.state","typeLabel":"string"},"city":{"type":"string","description":"City, district, suburb, town, or village.","maxLength":128,"example":"Singapore","uniqueKey":"cardholder.residential_address.city","typeLabel":"string"},"district":{"type":"string","description":"District or sub-region within the city.","maxLength":128,"example":"Buona Vista","uniqueKey":"cardholder.residential_address.district","typeLabel":"string"},"line1":{"type":"string","description":"Address line 1 (e.g., street, PO Box, or company name).","maxLength":255,"example":"9 N Buona Vista Dr","uniqueKey":"cardholder.residential_address.line1","typeLabel":"string"},"line2":{"oneOf":[{"type":"string","description":"Address line 2 (e.g., apartment, suite, unit, or building).","maxLength":255,"example":"THE METROPOLIS","uniqueKey":"cardholder.residential_address.line2.oneOf.0","typeLabel":"string"},{"type":"null","description":"Address line 2 (e.g., apartment, suite, unit, or building).","maxLength":255,"example":"THE METROPOLIS","uniqueKey":"cardholder.residential_address.line2.oneOf.1","typeLabel":"null"}],"uniqueKey":"cardholder.residential_address.line2","typeLabel":"string | null"},"line_en":{"type":"string","description":"Address in English.","maxLength":255,"example":"9 N Buona Vista Dr, THE METROPOLIS","uniqueKey":"cardholder.residential_address.line_en","typeLabel":"string"},"postal_code":{"type":"string","description":"ZIP or postal code. If you intend to issue an Enhanced card, this field must be 4-10 characters long.","maxLength":16,"example":"138666","uniqueKey":"cardholder.residential_address.postal_code","typeLabel":"string"}},"uniqueKey":"cardholder.residential_address","typeLabel":"object"},"review_status":{"type":"string","description":"The review status of the cardholder.","enum":["SUCCESS","FAILED","PENDING"],"example":"SUCCESS","uniqueKey":"cardholder.review_status","typeLabel":"enum\u003cstring>"},"idv_status":{"type":"string","description":"IDV verification status. Returned when applicable.\n\n * `PENDING` - IDV pending.\n * `PASSED` - IDV passed.\n * `FAILED` - IDV failed.\n","enum":["PENDING","PASSED","FAILED"],"uniqueKey":"cardholder.idv_status","typeLabel":"enum\u003cstring>"},"idv_verification_url":{"type":"string","description":"IDV verification URL. Returned when applicable.","example":"https://idv.sumsub.com/verify/abc123","uniqueKey":"cardholder.idv_verification_url","typeLabel":"string"},"idv_url_expires_at":{"type":"string","description":"IDV verification URL expiration time in RFC 3339 format.","example":"2026-04-10T10:00:00+08:00","uniqueKey":"cardholder.idv_url_expires_at","typeLabel":"string"}},"isRequired":true,"uniqueKey":"cardholder","typeLabel":"object"},"no_pin_payment_amount":{"type":"string","example":"2000USD","description":"The allowable amount for card transactions without PIN verification, including the currency unit (e.g., `2000USD`). This response field should be distinguished from the corresponding request parameter, which specifies the amount without a currency unit.","isRequired":true,"uniqueKey":"no_pin_payment_amount","typeLabel":"string"},"card_status":{"type":"string","description":"Card status enum. See the Card lifecycle and statuses guide for more information.\n\n- `PENDING`: The request to create the card has been received and is under review.\n- `ACTIVE`: The request to create the card was successful and the card is ready to use.\n- `FROZEN`: All incoming authorization requests will be declined. The card can be reactivated to accept new authorizations.\n- `BLOCKED`: The card was blocked by UQPAY due to suspicious activity.\n- `PRE_CANCEL`: The card is scheduled for cancellation and is in a waiting period during which all incoming authorization requests are declined. It transitions to `CANCELLED` when the waiting period ends.\n- `CANCELLED`: The card cannot be reactivated from this state, all incoming authorization requests will be permanently declined.\n- `LOST`: The card has been reported as lost to UQPAY.\n- `STOLEN`: The card has been reported as stolen to UQPAY.\n- `FAILED`: The request to create a card using [Create Card](/card-issuance/v1.6/api-reference/create-card) failed.\n","example":"ACTIVE","enum":["PENDING","ACTIVE","FROZEN","BLOCKED","PRE_CANCEL","CANCELLED","LOST","STOLEN","FAILED"],"isRequired":true,"uniqueKey":"card_status","typeLabel":"enum\u003cstring>"},"card_currency":{"type":"string","example":"USD","description":"The card currency.","enum":["SGD","USD","XUSD"],"uniqueKey":"card_currency","typeLabel":"enum\u003cstring>"},"card_product_id":{"type":"string","description":"The card product's unique identifier.","example":"3bd1656b-e691-4aab-a76a-3ead39e7a6f6","format":"uuid","uniqueKey":"card_product_id","typeLabel":"string\u003cuuid>"},"spending_controls":{"type":"array","description":"Rules that control spending for this card.","items":{"type":"object","required":["amount","interval"],"properties":{"amount":{"type":"string","description":"Maximum amount allowed to spend per interval, as a decimal string. Must be greater than or equal to zero.","example":"100.03","isRequired":true,"uniqueKey":"spending_controls.items.[INDEX].amount","typeLabel":"string"},"interval":{"type":"string","example":"PER_TRANSACTION","enum":["PER_TRANSACTION"],"description":"Interval (or event) to which the amount applies. \nThis field is mandatory and must be one of:\n * `PER_TRANSACTION` - Can not exceed the max authorization amount\n","isRequired":true,"uniqueKey":"spending_controls.items.[INDEX].interval","typeLabel":"enum\u003cstring>"}},"uniqueKey":"spending_controls.items.[INDEX]","typeLabel":"object"},"uniqueKey":"spending_controls","typeLabel":"object[]"},"risk_controls":{"type":"object","description":"User-customized risk control settings.\n\nSupported configurations depend on the card product. See [Card products](/card-issuance/v1.6/guide/card-products) for the capability matrix.\n","properties":{"enable_3ds":{"type":"string","description":"Controls whether [3D Secure](https://en.wikipedia.org/wiki/3-D_Secure) is registered for this card.\n\n- `Y` — Register 3DS. The challenge behavior at transaction time is then governed by `allow_3ds_transactions`.\n- `N` — Do not register 3DS. Online transactions bypass 3DS authentication entirely.\n\nSupported on **Business Visa** and **Personal Visa** only; ignored on Business Mastercard. See [Card products](/card-issuance/v1.6/guide/card-products).\n\nReturned only when explicitly set on the card. When absent, the card follows the account-level 3DS configuration.\n\nModifiable only when the card is in `PENDING` or `ACTIVE` status.\n","enum":["Y","N"],"example":"Y","uniqueKey":"risk_controls.enable_3ds","typeLabel":"enum\u003cstring>"},"allow_3ds_transactions":{"type":"string","description":"Determines whether [3D Secure](https://en.wikipedia.org/wiki/3-D_Secure) challenge flow is allowed when a transaction triggers 3DS.\n\n- **When creating a card:** Defaults to `Y` if not provided.\n- **When updating a card:** No default. If not provided, the existing value remains unchanged.\n\nSupported on **Business Visa** only. See [Card products](/card-issuance/v1.6/guide/card-products).\n\n> **Note:** This field only takes effect when `enable_3ds` is `Y`. If `enable_3ds` is `N`, the card bypasses 3DS entirely and this field has no effect.\n\n> **Important:** When set to `N`, your card uses a frictionless 3DS authentication mechanism — transactions complete without OTP input and are treated as cardholder-authenticated. As a result, disputes based on fraud or unauthorized use cannot be raised for such transactions. For enhanced security, it is recommended to keep this set to `Y`.\n\n- `Y`: OTP verification may be required.\n- `N`: No OTP will be required.\n","enum":["Y","N"],"example":"Y","uniqueKey":"risk_controls.allow_3ds_transactions","typeLabel":"enum\u003cstring>"},"allowed_mcc":{"type":"array","items":{"type":"string","uniqueKey":"risk_controls.allowed_mcc.items.[INDEX]","typeLabel":"string"},"description":"Specifies a whitelist of Merchant Category Codes (MCCs) that are permitted for transactions.\nAll transactions under MCCs not listed here will be declined.\n\n**Note:** Only one of `allowed_mcc` or `blocked_mcc` can be configured per card. If neither is provided, transactions will follow the default risk control logic.\n","example":null,"uniqueKey":"risk_controls.allowed_mcc","typeLabel":"string[]"},"blocked_mcc":{"type":"array","items":{"type":"string","uniqueKey":"risk_controls.blocked_mcc.items.[INDEX]","typeLabel":"string"},"description":"Specifies a blacklist of Merchant Category Codes (MCCs) that are restricted for transactions.\nTransactions under these MCCs will be declined, while all other transactions will proceed through the standard UQPAY risk control evaluation.\n\n**Note:** Only one of `allowed_mcc` or `blocked_mcc` can be configured per card. If neither is provided, transactions will follow the default risk control logic.\n","example":["5999","6011"],"uniqueKey":"risk_controls.blocked_mcc","typeLabel":"string[]"},"allowed_merchants":{"type":"array","items":{"type":"string","uniqueKey":"risk_controls.allowed_merchants.items.[INDEX]","typeLabel":"string"},"description":"Whitelist of merchant codes that are permitted for transactions. Transactions with any other merchant are declined.\n\nResolve merchant codes with [List Merchant Brands](/card-issuance/v1.6/api-reference/list-merchant-brands). An unknown code is rejected.\n\nSupported on **Business Visa** only. See [Card products](/card-issuance/v1.6/guide/card-products).\n\n**Note:** Only one of `allowed_merchants` or `blocked_merchants` can be configured per card, and the list cannot exceed 20 entries. Merchant controls are evaluated independently of `allowed_mcc` / `blocked_mcc`, so a card can carry both an MCC rule and a merchant rule.\n\n**When updating a card:** Omit the field to leave the current value unchanged. Pass an empty array to clear it.\n","example":["10000668","10000418"],"uniqueKey":"risk_controls.allowed_merchants","typeLabel":"string[]"},"blocked_merchants":{"type":"array","items":{"type":"string","uniqueKey":"risk_controls.blocked_merchants.items.[INDEX]","typeLabel":"string"},"description":"Blocklist of merchant codes that are restricted for transactions. Transactions with these merchants are declined, while all others proceed through the standard UQPAY risk control evaluation.\n\nResolve merchant codes with [List Merchant Brands](/card-issuance/v1.6/api-reference/list-merchant-brands). An unknown code is rejected.\n\nSupported on **Business Visa** only. See [Card products](/card-issuance/v1.6/guide/card-products).\n\n**Note:** Only one of `allowed_merchants` or `blocked_merchants` can be configured per card, and the list cannot exceed 20 entries. Merchant controls are evaluated independently of `allowed_mcc` / `blocked_mcc`, so a card can carry both an MCC rule and a merchant rule.\n\n**When updating a card:** Omit the field to leave the current value unchanged. Pass an empty array to clear it.\n","example":["10000668","10000418"],"uniqueKey":"risk_controls.blocked_merchants","typeLabel":"string[]"}},"uniqueKey":"risk_controls","typeLabel":"object"},"network_protection":{"type":"object","description":"ASAF Network Protection state embedded in card response objects. Returned only for Visa cards.","properties":{"enabled":{"type":"boolean","example":true,"description":"Whether Network Protection is currently active on the card.","uniqueKey":"network_protection.enabled","typeLabel":"boolean"},"card_scheme":{"oneOf":[{"type":"string","example":"VISA","uniqueKey":"network_protection.card_scheme.oneOf.0","typeLabel":"string"},{"type":"null","example":"VISA","uniqueKey":"network_protection.card_scheme.oneOf.1","typeLabel":"null"}],"uniqueKey":"network_protection.card_scheme","typeLabel":"string | null"},"action_code":{"type":"string","description":"ASAF action code indicating the reason the card is enrolled in Network Protection.\n\n- `04` — Pickup card\n- `41` — Lost card, pickup\n- `43` — Stolen card, pickup\n- `46` — Closed account\n- `54` — Expired card\n","enum":["04","41","43","46","54"],"example":"41","uniqueKey":"network_protection.action_code","typeLabel":"enum\u003cstring>"},"definition":{"oneOf":[{"type":"string","example":"Lost card, pickup","description":"Human-readable description of `action_code`.","uniqueKey":"network_protection.definition.oneOf.0","typeLabel":"string"},{"type":"null","example":"Lost card, pickup","description":"Human-readable description of `action_code`.","uniqueKey":"network_protection.definition.oneOf.1","typeLabel":"null"}],"uniqueKey":"network_protection.definition","typeLabel":"string | null"},"status":{"type":"string","description":"Lifecycle status of an ASAF Network Protection enrollment.","enum":["NOT_ENROLLED","ENROLL_PENDING","ENROLL_FAILED","ENROLLED","REMOVAL_PENDING"],"example":"ENROLL_PENDING","uniqueKey":"network_protection.status","typeLabel":"enum\u003cstring>"},"submitted_time":{"oneOf":[{"type":"string","format":"date-time","example":"2026-05-14T09:00:00Z","description":"Time at which the latest enrollment or removal request was submitted.","uniqueKey":"network_protection.submitted_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","example":"2026-05-14T09:00:00Z","description":"Time at which the latest enrollment or removal request was submitted.","uniqueKey":"network_protection.submitted_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"network_protection.submitted_time","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"network_protection","typeLabel":"object"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"maxLength":3200,"type":"string","uniqueKey":"metadata.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Metadata attached to the card. Returns `null` when no metadata is set.","uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"maxLength":3200,"type":"string","uniqueKey":"metadata.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Metadata attached to the card. Returns `null` when no metadata is set.","uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | null"},"update_reason":{"type":"string","description":"The reason for updating card status.","maxLength":100,"minLength":0,"uniqueKey":"update_reason","typeLabel":"string"},"consumed_amount":{"type":"string","description":"Reflects the cumulative amount of the card limit that has already been used.","example":"51.00","uniqueKey":"consumed_amount","typeLabel":"string"}},"title":"RetrieveCardResponse","uniqueKey":"","typeLabel":"RetrieveCardResponse · object"},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"ed42f11a-673b-4fce-b85f-b0da849df766":{"XAuthToken":{"type":"apiKey","in":"header","name":"x-auth-token","description":"The API token for login provided by UQPAY.","scopes":[]}}},"servers":{"5a086068-fa68-494d-9eaa-28a3b87c8b36":{"url":"https://api-sandbox.uqpaytech.com/api","description":"Sandbox base URL."},"cf839844-1e97-4acf-a627-62575c0269b5":{"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":"card-issuance/v1.6/issuing.yaml"},"subdomain":"uqpay-ecc4f4d8","siteName":"UQPAY Developer Docs","title":"Retrieve Card - UQPAY Developer Docs","navMaps":{"firstHrefInVersion":{"v1.6":{"href":"/card-issuance/v1.6/api-reference/retrieve-card","matchLevel":0}},"firstHrefInLanguage":{"en":{"href":"/card-issuance/v1.6/api-reference/retrieve-card","matchLevel":0},"zh":{"href":"/zh/card-issuance/v1.6/api-reference/retrieve-card","matchLevel":1}}},"lastModified":"2026-09-26T14:19:01.162Z","originalFileLocation":"card-issuance/v1.6/api-reference/retrieve-card.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=\"Retrieves the details for a card you issued previously. The card\u0026#x27;s secure information are not returned in the response.\">\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=\"Retrieve Card - UQPAY Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves the details for a card you issued previously. The card\u0026#x27;s secure information are not returned in the response.\">\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/card-issuance/v1.6/api-reference/retrieve-card\">\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=Card+Lifecycle\u0026amp;title=Retrieve+Card\u0026amp;description=Retrieves+the+details+for+a+card+you+issued+previously.+The+card%27s+secure+information+are+not+returned+in+the+response.\u0026amp;theme=ee61e842face86fd00189b13\u0026amp;signature=1fc4a8b32758946cbd00a3aff7637a20c63728b09da0d908cc777d47c70bcda9\">\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=\"Retrieve Card - UQPAY Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves the details for a card you issued previously. The card\u0026#x27;s secure information are not returned in the response.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://uqpay-ecc4f4d8.mintlify.app/_mintlify/api/og/v2?division=Card+Lifecycle\u0026amp;title=Retrieve+Card\u0026amp;description=Retrieves+the+details+for+a+card+you+issued+previously.+The+card%27s+secure+information+are+not+returned+in+the+response.\u0026amp;theme=ee61e842face86fd00189b13\u0026amp;signature=1fc4a8b32758946cbd00a3aff7637a20c63728b09da0d908cc777d47c70bcda9\">\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/card-issuance/v1.6/api-reference/retrieve-card\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/card-issuance/v1.6/api-reference/retrieve-card.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://developers-sandbox.uqpaytech.com/docs/card-issuance/v1.6/api-reference/retrieve-card\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/retrieve-card\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://developers-sandbox.uqpaytech.com/docs/card-issuance/v1.6/api-reference/retrieve-card\">\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/card-issuance/v1.6/api-reference/retrieve-card#webpage\",\"url\":\"https://developers-sandbox.uqpaytech.com/docs/card-issuance/v1.6/api-reference/retrieve-card\",\"name\":\"Retrieve Card\",\"description\":\"Retrieves the details for a card you issued previously. The card's secure information are not returned in the response.\",\"dateModified\":\"2026-09-26T14:19:01.162Z\",\"isPartOf\":{\"@id\":\"https://developers-sandbox.uqpaytech.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://developers-sandbox.uqpaytech.com/docs/card-issuance/v1.6/api-reference/retrieve-card#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers-sandbox.uqpaytech.com/docs/card-issuance/v1.6/api-reference/retrieve-card#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Card Issuance API\",\"item\":\"https://developers-sandbox.uqpaytech.com/docs/card-issuance/v1.6/api-reference/list-cards\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Card Lifecycle\",\"item\":\"https://developers-sandbox.uqpaytech.com/docs/card-issuance/v1.6/api-reference/list-cards\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Retrieve Card\",\"item\":\"https://developers-sandbox.uqpaytech.com/docs/card-issuance/v1.6/api-reference/retrieve-card\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers-sandbox.uqpaytech.com/docs/card-issuance/v1.6/api-reference/retrieve-card#apireference\",\"headline\":\"Retrieve Card\",\"name\":\"Retrieve Card\",\"description\":\"Retrieves the details for a card you issued previously. The card's secure information are not returned in the response.\",\"url\":\"https://developers-sandbox.uqpaytech.com/docs/card-issuance/v1.6/api-reference/retrieve-card\",\"mainEntityOfPage\":{\"@id\":\"https://developers-sandbox.uqpaytech.com/docs/card-issuance/v1.6/api-reference/retrieve-card#webpage\"},\"dateModified\":\"2026-09-26T14:19:01.162Z\",\"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","pages":[{"title":"Global Acquiring","href":"/global-acquiring/v1.6/guide/overview"}]},{"product":"Global Account","icon":"building-columns","pages":[{"title":"Global Account","href":"/global-account/v1.6/guide/overview"}]},{"product":"Card Issuance","icon":"credit-card","versions":[{"version":"v1.6","tag":"Latest","tabs":[{"tab":"Guide","icon":"book-open","pages":[{"title":"Guide","href":"/card-issuance/v1.6/guide/overview"}]},{"tab":"Webhooks","icon":"bell","pages":[{"title":"Webhooks","href":"/card-issuance/v1.6/webhooks/card-created"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Card Issuance API","pages":[{"group":"Card Lifecycle","pages":[{"title":"List Cards","deprecated":null,"version":null,"sidebarTitle":"List cards","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/cards","href":"/card-issuance/v1.6/api-reference/list-cards"},{"title":"Create Card","description":"Creates a card and issues it to a cardholder.\n\nTwo calling modes are supported:\n\n- **Traditional mode** — pass `cardholder_id` to issue a card to an existing cardholder. Optionally pass `cardholder_required_fields` to supplement missing cardholder data required by the card product.\n- **One-step mode** — omit `cardholder_id` and pass a complete `cardholder_required_fields` block. The system creates the cardholder and the card in a single request. See [One-Step Card Issuance](/card-issuance/v1.6/guide/one-step-card-issuance) for the full integration flow.\n","deprecated":null,"version":null,"sidebarTitle":"Create card","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards","href":"/card-issuance/v1.6/api-reference/create-card"},{"title":"Retrieve Card","deprecated":null,"version":null,"sidebarTitle":"Retrieve card","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/cards/{id}","href":"/card-issuance/v1.6/api-reference/retrieve-card"},{"title":"Update Card","description":"Updates the specified issuing card object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.","deprecated":null,"version":null,"sidebarTitle":"Update card","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/{id}","href":"/card-issuance/v1.6/api-reference/update-card"},{"title":"Update Card Status","deprecated":null,"version":null,"sidebarTitle":"Update card status","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/{id}/status","href":"/card-issuance/v1.6/api-reference/update-card-status"},{"title":"Retrieve Card Order","deprecated":null,"version":null,"sidebarTitle":"Retrieve card order","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/cards/{id}/order","href":"/card-issuance/v1.6/api-reference/retrieve-card-order"},{"title":"Activate Card","deprecated":null,"version":null,"sidebarTitle":"Activate card","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/activate","href":"/card-issuance/v1.6/api-reference/activate-card"},{"title":"Assign Card","deprecated":null,"version":null,"sidebarTitle":"Assign card","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/assign","href":"/card-issuance/v1.6/api-reference/assign-card"},{"title":"List Merchant Brands","deprecated":null,"version":null,"sidebarTitle":"List merchant brands","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/merchant_brands","href":"/card-issuance/v1.6/api-reference/list-merchant-brands"}]},{"group":"Card Secure Data","pages":[{"title":"Retrieve Sensitive Card Details","deprecated":null,"version":null,"sidebarTitle":"Retrieve card secure","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/cards/{id}/secure","href":"/card-issuance/v1.6/api-reference/retrieve-card-secure"},{"title":"Create PAN Token","deprecated":null,"version":null,"sidebarTitle":"Create pan token","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/{id}/token","href":"/card-issuance/v1.6/api-reference/create-pan-token"}]},{"group":"Card Funding","pages":[{"title":"Card Recharge","deprecated":null,"version":null,"sidebarTitle":"Card recharge","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/{id}/recharge","href":"/card-issuance/v1.6/api-reference/card-recharge"},{"title":"Card Withdraw","deprecated":null,"version":null,"sidebarTitle":"Card withdraw","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/{id}/withdraw","href":"/card-issuance/v1.6/api-reference/card-withdraw"}]},{"group":"Card Add-ons","pages":[{"title":"Elevate Per-Transaction Limit","deprecated":null,"version":null,"sidebarTitle":"Elevate card limit","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/{id}/elevate_limit","href":"/card-issuance/v1.6/api-reference/elevate-card-limit"},{"title":"Enroll Card in Network Protection","deprecated":null,"version":null,"sidebarTitle":"Enroll card network protection","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/{id}/risk","href":"/card-issuance/v1.6/api-reference/enroll-card-network-protection"},{"title":"Remove Card from Network Protection","deprecated":null,"version":null,"sidebarTitle":"Remove card network protection","openapi":"/card-issuance/v1.6/issuing.yaml delete /v1/issuing/cards/{id}/risk","href":"/card-issuance/v1.6/api-reference/remove-card-network-protection"}]},{"group":"Card PIN","pages":[{"title":"Manage Card PIN","deprecated":null,"version":null,"sidebarTitle":"Reset pin","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/pin","href":"/card-issuance/v1.6/api-reference/reset-pin"},{"title":"Set or Reset Virtual Card PIN","deprecated":null,"version":null,"sidebarTitle":"Manage card pin","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/manage/pin","href":"/card-issuance/v1.6/api-reference/manage-card-pin"}]},{"group":"Card Arts","pages":[{"title":"List Card Arts","deprecated":null,"version":null,"sidebarTitle":"List card arts","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/cards/arts","href":"/card-issuance/v1.6/api-reference/list-card-arts"},{"title":"Set Default Card Art","deprecated":null,"version":null,"sidebarTitle":"Set default card art","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cards/arts/default","href":"/card-issuance/v1.6/api-reference/set-default-card-art"}]},{"group":"Cardholders","pages":[{"title":"List Cardholders","deprecated":null,"version":null,"sidebarTitle":"List cardholders","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/cardholders","href":"/card-issuance/v1.6/api-reference/list-cardholders"},{"title":"Create Cardholder","deprecated":null,"version":null,"sidebarTitle":"Create cardholder","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cardholders","href":"/card-issuance/v1.6/api-reference/create-cardholder"},{"title":"Retrieve Cardholder","deprecated":null,"version":null,"sidebarTitle":"Retrieve cardholder","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/cardholders/{id}","href":"/card-issuance/v1.6/api-reference/retrieve-cardholder"},{"title":"Update Cardholder","deprecated":null,"version":null,"sidebarTitle":"Update cardholder","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/cardholders/{id}","href":"/card-issuance/v1.6/api-reference/update-cardholder"}]},{"group":"Transactions","pages":[{"title":"List Cards Transactions","deprecated":null,"version":null,"sidebarTitle":"List cards transactions","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/transactions","href":"/card-issuance/v1.6/api-reference/list-cards-transactions"},{"title":"Retrieve Cards Transaction","deprecated":null,"version":null,"sidebarTitle":"Retrieve cards transaction","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/transactions/{id}","href":"/card-issuance/v1.6/api-reference/retrieve-cards-transaction"},{"title":"Claim Unsolicited Refund","deprecated":null,"version":null,"sidebarTitle":"Claim unsolicited refund","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/transactions/unsolicited_refund/release","href":"/card-issuance/v1.6/api-reference/claim-unsolicited-refund"}]},{"group":"Products","pages":[{"title":"List Card Products","deprecated":null,"version":null,"sidebarTitle":"List card products","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/products","href":"/card-issuance/v1.6/api-reference/list-card-products"}]},{"group":"Transfers","pages":[{"title":"Create Issuing Transfer","deprecated":null,"version":null,"sidebarTitle":"Create issuing transfer","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/transfers","href":"/card-issuance/v1.6/api-reference/create-issuing-transfer"},{"title":"Retrieve Issuing Transfer","deprecated":null,"version":null,"sidebarTitle":"Retrieve issuing transfer","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/transfers/{id}","href":"/card-issuance/v1.6/api-reference/retrieve-issuing-transfer"}]},{"group":"Balances","pages":[{"title":"List Issuing Balances","deprecated":null,"version":null,"sidebarTitle":"List issuing balances","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/balances","href":"/card-issuance/v1.6/api-reference/list-issuing-balances"},{"title":"Retrieve Issuing Balance","deprecated":null,"version":null,"sidebarTitle":"Retrieve issuing balance","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/balances","href":"/card-issuance/v1.6/api-reference/retrieve-issuing-balance"},{"title":"List Issuing Balances Transactions","deprecated":null,"version":null,"sidebarTitle":"List issuing balances transactions","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/balances/transactions","href":"/card-issuance/v1.6/api-reference/list-issuing-balances-transactions"}]},{"group":"Reports","pages":[{"title":"Download Report","deprecated":null,"version":null,"sidebarTitle":"Download report file","openapi":"/card-issuance/v1.6/issuing.yaml get /v1/issuing/reports/{id}","href":"/card-issuance/v1.6/api-reference/download-report-file"},{"title":"Create Report","deprecated":null,"version":null,"sidebarTitle":"Create report","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/issuing/reports","href":"/card-issuance/v1.6/api-reference/create-report"}]},{"group":"Simulator","pages":[{"title":"Simulate Authorization","deprecated":null,"version":null,"sidebarTitle":"Simulate authorization","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/simulation/issuing/authorization","href":"/card-issuance/v1.6/api-reference/simulate-authorization"},{"title":"Simulate Reversal","deprecated":null,"version":null,"sidebarTitle":"Simulate reversal","openapi":"/card-issuance/v1.6/issuing.yaml post /v1/simulation/issuing/reversal","href":"/card-issuance/v1.6/api-reference/simulate-reversal"}]}]}]}]}]},{"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/card-issuance/v1.6/api-reference/retrieve-card"}]}]},"basePath":"","title":"Retrieve Card - 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"]}