This can be either a physical, which is a traditional tangible card made of plastic, or a virtual card, which is a digital version of a physical card that can be used for online transactions or transactions made through a mobile device.
When issuing a card, the productId must be specified and determines the card product to issue. The card product determines the card type, card face, card features, benefits, interest rates, capabilties, etc. The list of available productIds is static will be provided by your solution manager based on your pre-determined card product offering(s).
The card will be chosen from the available inventory and given out in numerical order according to its card number.
If you wish to issue a specific card, you may specify the card number suffix (up to the full card numberA) using the cardSuffix field. If the card number is not part of the productId or already issued, the request will fail.
Multiple cards can be issued under the a single card account.
Once the request has been processed:
The card will be created in the system under the respective card account.
The card can then be activated and used for making purchases.
The type field determines the type of card to issue. It can be either a physical card or a virtual card.
A physical card is a traditional, tangible card that is made of plastic or other materials and can be used for both online and in-person transactions at retail card terminals.
A virtual card is a digital / online only version of a payment card, which can be used for online transactions or for transactions made through a mobile device when binding to wallets or payment apps.
The cardAccountId field specifies the card account under which the card will be issued. This field is used to issue and link the newly issued card to a particular card account, which must have already been created prior to issuing the card.
The card account is an account that holds the funds, balances, and transactions that are used to make purchases with the card. Multiple cards issued under the same card account share the same balance and limit.
The embossedName field specifies the name that is embossed or printed on a physical card. This is the name that appears on the front of the card.
Allowed characters: basic latin letters (A-Z, a-z), hyphens("-"), whitespace(" "), periods("."), and commas(","). Accented letters, apostrophes, and numeric characters are not permitted.
Specify a card suffix to issue a specific card. This field can be used to have fine control over card selection during issuing process. The specified card must be available in the inventory and not already issued.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"UTGL Developer Portal","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/utgl/0RP3r5GPH0T45wL4/images/utgl-logo-light.png?fit=max\u0026auto=format\u0026n=0RP3r5GPH0T45wL4\u0026q=85\u0026s=981263f94aa1e78e30f255123606b9b6","dark":"https://mintcdn.com/utgl/0RP3r5GPH0T45wL4/images/utgl-logo-dark.png?fit=max\u0026auto=format\u0026n=0RP3r5GPH0T45wL4\u0026q=85\u0026s=5c33c35c35ba88c8248c872b85bdd625"},"favicon":"https://mintcdn.com/utgl/0RP3r5GPH0T45wL4/images/small-utgl-icon.png?fit=max\u0026auto=format\u0026n=0RP3r5GPH0T45wL4\u0026q=85\u0026s=8a37a8a6d23dfa07a75ce1a3f84b37f0","api":{"openapi":["issuing/api-reference/openapi.yaml","merchant/partner-connect/partner-connect.yaml"],"playground":{"display":"interactive"},"mdx":{"auth":{"method":"bearer"},"server":"https://access.utgl.io"}},"background":{"color":{"light":"#FAFAFA","dark":"#0A0E1A"}},"footer":{"socials":{"twitter":"https://twitter.com/utgl_official","linkedin":"https://www.linkedin.com/company/utgl"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"utgl","hasAudioNarration":false,"actualSubdomain":"utgl","customDomains":["developer.utgl.io"],"gitSource":{"type":"github","owner":"theunigroup","repo":"utx-access-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad01c1e2bd8c50d68e907ff","collectionId":"e198b51d-fc6a-4b4c-b288-d0dd9cde7575","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad01c1e2bd8c50d68e907ff"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ad01c1e2bd8c50d68e907ff","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Issuing API","count":102},{"language":"default","tag":"API Reference","count":80},{"language":"default","tag":"Cards","count":16},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Card Accounts","count":12},{"language":"default","tag":"Getting Started","count":11},{"language":"default","tag":"Webhooks","count":10},{"language":"default","tag":"Merchant API","count":8},{"language":"default","tag":"Card Issuing","count":7},{"language":"default","tag":"Recipes","count":7}]},"assistantConfig":{},"basePath":"","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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/cards/issue-card","slug":"/api-reference/cards/issue-card","pageMetadata":{"title":"Issue Card","description":"Issue a card under the respective card account.\n\nThis can be either a physical, which is a traditional tangible card made of plastic, or a virtual card, which is a digital version of a physical card that can be used for online transactions or transactions made through a mobile device.\n\nWhen issuing a card, the productId must be specified and determines the card product to issue. The card product determines the card type, card face, card features, benefits, interest rates, capabilties, etc. The list of available productIds is static will be provided by your solution manager based on your pre-determined card product offering(s).\nThe card will be chosen from the available inventory and given out in numerical order according to its card number.\n\nIf you wish to issue a specific card, you may specify the card number suffix (up to the full card numberA) using the `cardSuffix` field. If the card number is not part of the `productId` or already issued, the request will fail.\n\nMultiple cards can be issued under the a single card account.\n\nOnce the request has been processed:\n- The card will be created in the system under the respective card account.\n- The card can then be activated and used for making purchases.","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards","href":"/api-reference/cards/issue-card","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Issue a card under the respective card account.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"This can be either a physical, which is a traditional tangible card made of plastic, or a virtual card, which is a digital version of a physical card that can be used for online transactions or transactions made through a mobile device.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"When issuing a card, the productId must be specified and determines the card product to issue. The card product determines the card type, card face, card features, benefits, interest rates, capabilties, etc. The list of available productIds is static will be provided by your solution manager based on your pre-determined card product offering(s).\\nThe card will be chosen from the available inventory and given out in numerical order according to its card number.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"If you wish to issue a specific card, you may specify the card number suffix (up to the full card numberA) using the \", _jsx(_components.code, {\n children: \"cardSuffix\"\n }), \" field. If the card number is not part of the \", _jsx(_components.code, {\n children: \"productId\"\n }), \" or already issued, the request will fail.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Multiple cards can be issued under the a single card account.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Once the request has been processed:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"The card will be created in the system under the respective card account.\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"The card can then be activated and used for making purchases.\"\n }), \"\\n\"]\n })]\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":"Issue Card","description":"Issue a card under the respective card account.\n\nThis can be either a physical, which is a traditional tangible card made of plastic, or a virtual card, which is a digital version of a physical card that can be used for online transactions or transactions made through a mobile device.\n\nWhen issuing a card, the productId must be specified and determines the card product to issue. The card product determines the card type, card face, card features, benefits, interest rates, capabilties, etc. The list of available productIds is static will be provided by your solution manager based on your pre-determined card product offering(s).\nThe card will be chosen from the available inventory and given out in numerical order according to its card number.\n\nIf you wish to issue a specific card, you may specify the card number suffix (up to the full card numberA) using the `cardSuffix` field. If the card number is not part of the `productId` or already issued, the request will fail.\n\nMultiple cards can be issued under the a single card account.\n\nOnce the request has been processed:\n- The card will be created in the system under the respective card account.\n- The card can then be activated and used for making purchases.","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards","href":"/api-reference/cards/issue-card","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"issueCard","summary":"Issue Card","tags":["Cards"],"description":"Issue a card under the respective card account.\n\nThis can be either a physical, which is a traditional tangible card made of plastic, or a virtual card, which is a digital version of a physical card that can be used for online transactions or transactions made through a mobile device.\n\nWhen issuing a card, the productId must be specified and determines the card product to issue. The card product determines the card type, card face, card features, benefits, interest rates, capabilties, etc. The list of available productIds is static will be provided by your solution manager based on your pre-determined card product offering(s).\nThe card will be chosen from the available inventory and given out in numerical order according to its card number.\n\nIf you wish to issue a specific card, you may specify the card number suffix (up to the full card numberA) using the `cardSuffix` field. If the card number is not part of the `productId` or already issued, the request will fail.\n\nMultiple cards can be issued under the a single card account.\n\nOnce the request has been processed:\n- The card will be created in the system under the respective card account.\n- The card can then be activated and used for making purchases.","requestBody":"fa97716e-0094-420d-ac20-09ca0a506067","responses":{"200":"a520902f-7dc7-4e45-a04c-d3fe4c3f1044"},"method":"post","type":"path","servers":["f66b622f-95f4-41ab-8ca7-ffcfd06b01ee","30b5b6b9-30cd-4bba-bca7-580a4d6e748a"],"security":["1cbb6398-fa06-476b-81b4-0ffc2560bccf","6ddf0c6f-ae63-444d-8e5c-eca0189b5c1d"],"path":"/cards","baseUrlOptions":["https://access.utgl.io/v1","https://sandbox.access.utgl.io/v1"],"title":"Issue Card","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["cardAccountId","type","productId","embossedName"],"properties":{"type":{"type":"string","enum":["physical","virtual"],"description":"The `type` field determines the type of card to issue. It can be either a physical card or a virtual card.\n\nA physical card is a traditional, tangible card that is made of plastic or other materials and can be used for both online and in-person transactions at retail card terminals.\n\nA virtual card is a digital / online only version of a payment card, which can be used for online transactions or for transactions made through a mobile device when binding to wallets or payment apps.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"cardAccountId":{"type":"string","example":"c8e2752d-6bd7-4244-a9f6-580f5640eaeb","description":"The `cardAccountId` field specifies the card account under which the card will be issued. This field is used to issue and link the newly issued card to a particular card account, which must have already been created prior to issuing the card.\n\nThe card account is an account that holds the funds, balances, and transactions that are used to make purchases with the card. Multiple cards issued under the same card account share the same balance and limit.","isRequired":true,"uniqueKey":"cardAccountId","typeLabel":"string"},"productId":{"type":"string","format":"uuid","description":"Product ID of the card product to be issued","isRequired":true,"uniqueKey":"productId","typeLabel":"string\u003cuuid>"},"embossedName":{"type":"string","maxLength":22,"example":"CHAN TAI MAN","description":"The embossedName field specifies the name that is embossed or printed on a physical card. This is the name that appears on the front of the card.\n\nAllowed characters: basic latin letters (A-Z, a-z), hyphens(\"-\"), whitespace(\" \"), periods(\".\"), and commas(\",\"). Accented letters, apostrophes, and numeric characters are not permitted.\n\nExamples of valid names:\n- \"CHAN TAI MAN\"\n- \"John Smith\"\n- \"Mary-Jane\"\n- \"John, Jr.\"\n- \"Mary A.\"\n\nExamples of invalid names:\n- \"11\" (contains numeric characters)\n- \"John123\" (contains numeric characters)\n- \"José María\" (contains accented letters)\n- \"O'Connor-Smith\" (contains apostrophe)\n- \"a\" (too short after processing)\n- \"John@Doe\" (contains invalid characters)","isRequired":true,"uniqueKey":"embossedName","typeLabel":"string"},"cardSuffix":{"type":"string","example":"8888","description":"Specify a card suffix to issue a specific card. This field can be used to have fine control over card selection during issuing process. The specified card must be available in the inventory and not already issued.","uniqueKey":"cardSuffix","typeLabel":"string"},"cardholderInfo":{"type":"object","description":"Individual card holder identity information. This is required when account type is individual.\n","required":["firstName","lastName","email","dateOfBirth","annualIncome","document","address","occupation","position"],"properties":{"dateOfBirth":{"type":"string","pattern":"\\d{4}-\\d{2}-\\d{2}","example":"1985-07-20","description":"Date of birth (YYYY-MM-DD)","isRequired":true,"uniqueKey":"cardholderInfo.dateOfBirth","typeLabel":"string"},"firstName":{"type":"string","example":"John Anthony","description":"First name of cardholder","isRequired":true,"uniqueKey":"cardholderInfo.firstName","typeLabel":"string"},"lastName":{"type":"string","example":"CHAN","description":"Last name / Surname of cardholder","isRequired":true,"uniqueKey":"cardholderInfo.lastName","typeLabel":"string"},"email":{"type":"string","example":"john.doe@example.com","description":"Email address of cardholder","isRequired":true,"uniqueKey":"cardholderInfo.email","typeLabel":"string"},"annualIncome":{"type":"string","example":"100000","description":"Annual income of card holder in USD","isRequired":true,"uniqueKey":"cardholderInfo.annualIncome","typeLabel":"string"},"occupation":{"type":"string","example":"accountant","description":"Occupation of card holder. Retrieve a list of valid occupations from /v1/occupations endpoint. Required and validated against the list of valid occupations.","isRequired":true,"uniqueKey":"cardholderInfo.occupation","typeLabel":"string"},"position":{"type":"string","example":"senior management","description":"Position of card holder. Retrieve a list of valid positions from /v1/positions endpoint. Required and validated against the list of valid positions.","isRequired":true,"uniqueKey":"cardholderInfo.position","typeLabel":"string"},"document":{"type":"object","description":"Government Issued Identification Document Information\n","required":["type","front","number","country"],"properties":{"type":{"type":"string","description":"The following types are accepted for ID documents.\n- Permanent HKID\n- Valid Passport\n- China National ID\n- Exit-Entry Permit for Travelling to and from Hong Kong and Macao (EEP)\n- Japanese National ID\n- Japanese Driving License\n- Malaysian National ID\n","enum":["passport","drivers-license","national-id"],"isRequired":true,"uniqueKey":"cardholderInfo.document.type","typeLabel":"enum\u003cstring>"},"front":{"description":"The front of a document file encoded in data URI base64 encoded format\n\nThe following mime types are accepted for ID documents\n- PDF documents: application/pdf\n- JPEG image files: image/jpeg\n- PNG image files: image/png\n- GIF image files: image/gif\n","type":"string","example":"data:application/pdf;base64,JVBERi0xLjQKJcOkw7zDQo8P3hwYW5lbCBiYXNlPSIwIiBuYW1lPSJMYXllciAxIiBjb2xvcj0iIzAwMDAwMCI+CjwvYnVmZmVyPgo8L3BhcmVudD4KPC9","isRequired":true,"uniqueKey":"cardholderInfo.document.front","typeLabel":"string"},"number":{"type":"string","description":"Identification document number.","example":"A12345678","isRequired":true,"uniqueKey":"cardholderInfo.document.number","typeLabel":"string"},"country":{"type":"string","format":"ISO3166-1 alpha-2","example":"HK","description":"Issuing country of identification document in ISO3166-1 alpha-2 format\n\nThe following countries/regions are not accepted\n- Afghanistan\n- Albania\n- Belarus\n- Bosnia and Herzegovina\n- Central African Republic\n- Crimea\n- Democratic Republic of the Congo (also Zaire)\n- Ethiopia\n- Guinea Bissau\n- Haiti\n- Iran\n- Iraq\n- Kosovo\n- Libya\n- Mali\n- Montenegro\n- Myanmar\n- Nicaragua\n- North Korea (DPRK)\n- North Macedonia\n- Somalia\n- South Sudan\n- Sudan and Darfur\n- Syria\n- Venezuela\n- Yemen\n","isRequired":true,"uniqueKey":"cardholderInfo.document.country","typeLabel":"string\u003cISO3166-1 alpha-2>"},"back":{"description":"The back of a document file encoded in data URI base64 encoded format\n\nThe following mime types are accepted for ID documents\n\n- PDF documents: application/pdf\n- JPEG image files: image/jpeg\n- PNG image files: image/png\n- GIF image files: image/gif\n","example":"data:application/pdf;base64,JVBERi0xLjQKJcOkw7zDQo8P3hwYW5lbCBiYXNlPSIwIiBuYW1lPSJMYXllciAxIiBjb2xvcj0iIzAwMDAwMCI+CjwvYnVmZmVyPgo8L3BhcmVudD4KPC9","type":"string","uniqueKey":"cardholderInfo.document.back","typeLabel":"string"},"expiryDate":{"type":"string","pattern":"\\d{4}-\\d{2}-\\d{2}","example":"2025-12-31","description":"Expiry date of identification document (YYYY-MM-DD)","uniqueKey":"cardholderInfo.document.expiryDate","typeLabel":"string"}},"isRequired":true,"uniqueKey":"cardholderInfo.document","typeLabel":"object"},"address":{"type":"string","minLength":1,"maxLength":500,"example":"123 Main Street, Anytown, USA","description":"Address of the card holder.","isRequired":true,"uniqueKey":"cardholderInfo.address","typeLabel":"string"},"firstNameLocal":{"type":"string","example":"John Anthony","description":"First name of cardholder on ID","uniqueKey":"cardholderInfo.firstNameLocal","typeLabel":"string"},"lastNameLocal":{"type":"string","example":"CHAN","description":"Last name / Surname of cardholder on ID","uniqueKey":"cardholderInfo.lastNameLocal","typeLabel":"string"},"mobile":{"type":"string","example":"+85255551234","description":"Phone number of card holder\nThis phone number should be pre verified by the partner.","uniqueKey":"cardholderInfo.mobile","typeLabel":"string"},"gender":{"type":"string","enum":["MALE","FEMALE"],"example":"MALE","description":"Gender of cardholder. Required from February 1, 2026.\nOptional until then.\n","uniqueKey":"cardholderInfo.gender","typeLabel":"enum\u003cstring>"},"nationality":{"type":"string","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$","example":"HK","description":"Nationality of cardholder in ISO 3166-1 alpha-2 format (e.g., HK, US, CN).\nRequired from February 1, 2026.\nOptional until then.\nIf nationality is not HK, at least one supporting document is required.\n","uniqueKey":"cardholderInfo.nationality","typeLabel":"string"},"supportingDocuments":{"type":"array","description":"Supporting documents required for non-Hong Kong citizens.\nRequired if nationality is provided and is not HK.\nEach document must be one of the accepted document types.\n","items":{"type":"object","description":"Supporting document for non-Hong Kong citizens.\nRequired if nationality is not HK.\n","required":["documentType","file"],"properties":{"documentType":{"type":"string","enum":["IMMIGRATION_ENDORSEMENT","WORK_VISA","EMPLOYMENT_CONTRACT","SALARY_PAYSLIP","TENANCY_AGREEMENT","ADDRESS_PROOF","BANK_STATEMENT","TRAVEL_PERMIT_FRONT","TRAVEL_PERMIT_BACK","PROOF_OF_VISIT"],"description":"Type of supporting document. Accepted document types:\n- IMMIGRATION_ENDORSEMENT: Hong Kong Immigration Endorsement / Landing Slip\n- WORK_VISA: Valid Hong Kong Work Visa\n- EMPLOYMENT_CONTRACT: Employment Contract from a Hong Kong company\n- SALARY_PAYSLIP: Salary Payslip from a Hong Kong company issued within the last 3 months\n- TENANCY_AGREEMENT: Hong Kong Tenancy / Rental Agreement\n- ADDRESS_PROOF: Hong Kong Address Proof issued within the last 3 months (e.g., an utility or telecommunication bill)\n- BANK_STATEMENT: Hong Kong Bank Statement issued within the last 3 months\n- TRAVEL_PERMIT_FRONT: Front side of the Exit-Entry Permit for Travelling to and from Hong Kong and Macao (EEP / 回鄉證). Must be submitted together with TRAVEL_PERMIT_BACK.\n- TRAVEL_PERMIT_BACK: Back side of the Exit-Entry Permit for Travelling to and from Hong Kong and Macao (EEP / 回鄉證). Must be submitted together with TRAVEL_PERMIT_FRONT.\n- PROOF_OF_VISIT: Proof of a recent visit or current stay in Hong Kong (e.g., a hotel booking or flight ticket dated within the last 7 days)\n","example":"WORK_VISA","isRequired":true,"uniqueKey":"cardholderInfo.supportingDocuments.items.[INDEX].documentType","typeLabel":"enum\u003cstring>"},"file":{"type":"string","description":"Supporting document file encoded in data URI base64 encoded format.\nThe following mime types are accepted:\n- PDF documents: application/pdf\n- JPEG image files: image/jpeg\n- PNG image files: image/png\n- GIF image files: image/gif\n","example":"data:application/pdf;base64,JVBERi0xLjQKJcOkw7zDQo8P3hwYW5lbCBiYXNlPSIwIiBuYW1lPSJMYXllciAxIiBjb2xvcj0iIzAwMDAwMCI+CjwvYnVmZmVyPgo8L3BhcmVudD4KPC9","isRequired":true,"uniqueKey":"cardholderInfo.supportingDocuments.items.[INDEX].file","typeLabel":"string"}},"uniqueKey":"cardholderInfo.supportingDocuments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"cardholderInfo.supportingDocuments","typeLabel":"object[]"}},"uniqueKey":"cardholderInfo","typeLabel":"object"},"xid":{"type":"string","description":"External identifier, unique across all resources created under this account.","uniqueKey":"xid","typeLabel":"string"},"xmetadata":{"type":"any","uniqueKey":"xmetadata","typeLabel":"any"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"cardAccountId":"c8e2752d-6bd7-4244-a9f6-580f5640eaeb","productId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","embossedName":"CHAN TAI MAN","cardSuffix":"8888","xid":"\u003cstring>","xmetadata":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"a520902f-7dc7-4e45-a04c-d3fe4c3f1044":{"description":"Card Issue Successful","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Card ID of issued card. All card related endpoints require this ID for operation.","uniqueKey":"id","typeLabel":"string\u003cuuid>"},"cardAccountId":{"type":"string","format":"uuid","description":"Card account ID of the card","uniqueKey":"cardAccountId","typeLabel":"string\u003cuuid>"},"xid":{"type":"string","description":"External identifier, unique across all resources created under this account.","uniqueKey":"xid","typeLabel":"string"},"xmetadata":{"type":"any","uniqueKey":"xmetadata","typeLabel":"any"},"status":{"type":"string","enum":["active","pending-issue","pending-activation","locked","suspended","cancelled"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"embossedName":{"type":"string","description":"Embossed name on the card","uniqueKey":"embossedName","typeLabel":"string"},"network":{"type":"string","description":"Card network","enum":["mastercard"],"uniqueKey":"network","typeLabel":"enum\u003cstring>"},"product":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Card product ID","uniqueKey":"product.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"Product name","uniqueKey":"product.name","typeLabel":"string"},"imageUrl":{"type":"string","description":"Card product image URL, an image of card face without any embossing","uniqueKey":"product.imageUrl","typeLabel":"string"},"cardType":{"type":"string","description":"Card Type","uniqueKey":"product.cardType","typeLabel":"string"},"cardImageDetails":{"type":"object","properties":{"cardOrientation":{"type":"string","enum":["LANDSCAPE","PORTRAIT"],"uniqueKey":"product.cardImageDetails.cardOrientation","typeLabel":"enum\u003cstring>"},"cardWidth":{"type":"string","description":"Card image width","uniqueKey":"product.cardImageDetails.cardWidth","typeLabel":"string"},"cardHeight":{"type":"string","description":"Card image height","uniqueKey":"product.cardImageDetails.cardHeight","typeLabel":"string"},"cardNameFontSize":{"type":"string","description":"Card Name Font Size","uniqueKey":"product.cardImageDetails.cardNameFontSize","typeLabel":"string"},"cardNameFontWeight":{"type":"string","description":"Card Name Font Weight","uniqueKey":"product.cardImageDetails.cardNameFontWeight","typeLabel":"string"},"cardNameLineHeight":{"type":"string","description":"Card Name Line Height","uniqueKey":"product.cardImageDetails.cardNameLineHeight","typeLabel":"string"},"cardNameLetterSpacing":{"type":"string","description":"Card Name Letter Spacing","uniqueKey":"product.cardImageDetails.cardNameLetterSpacing","typeLabel":"string"},"cardNamePosition":{"type":"string","description":"Card position","uniqueKey":"product.cardImageDetails.cardNamePosition","typeLabel":"string"},"cardNameCoordinates":{"type":"array","items":{"type":"number","uniqueKey":"product.cardImageDetails.cardNameCoordinates.items.[INDEX]","typeLabel":"number"},"description":"Coordinates of embossed name on the card image","uniqueKey":"product.cardImageDetails.cardNameCoordinates","typeLabel":"number[]"},"cardNameColor":{"type":"string","description":"Card Name Color","uniqueKey":"product.cardImageDetails.cardNameColor","typeLabel":"string"}},"uniqueKey":"product.cardImageDetails","typeLabel":"object"}},"description":"Card product","uniqueKey":"product","typeLabel":"object"},"expiryMonth":{"type":"string","description":"Card expiry month","example":9,"uniqueKey":"expiryMonth","typeLabel":"string"},"expiryYear":{"type":"string","description":"Card expiry month","example":2030,"uniqueKey":"expiryYear","typeLabel":"string"},"last4":{"type":"string","description":"Last 4 digits of the card number","uniqueKey":"last4","typeLabel":"string"},"replacedBy":{"type":"string","description":"Card id of the card that replaced this card","uniqueKey":"replacedBy","typeLabel":"string"},"cardLimit":{"type":"number","description":"Card limit","uniqueKey":"cardLimit","typeLabel":"number"},"dailyAtmLimit":{"type":"number","description":"Daily ATM limit","uniqueKey":"dailyAtmLimit","typeLabel":"number"},"dailyPurchaseLimit":{"type":"number","description":"Daily Purchase limit","uniqueKey":"dailyPurchaseLimit","typeLabel":"number"},"dailyLimit":{"type":"number","description":"Daily limit","uniqueKey":"dailyLimit","typeLabel":"number"},"singleTransactionLimit":{"type":"number","description":"Single transaction limit","uniqueKey":"singleTransactionLimit","typeLabel":"number"},"availableLimit":{"type":"number","description":"Available limit chargeable on the card, taking into account all limits.","uniqueKey":"availableLimit","typeLabel":"number"},"cardPresentLimit":{"type":"number","description":"Card present limit.","uniqueKey":"cardPresentLimit","typeLabel":"number"},"cardNotPresentLimit":{"type":"number","description":"Card not present limit.","uniqueKey":"cardNotPresentLimit","typeLabel":"number"},"mobile":{"type":"string","description":"Card cell phone number","uniqueKey":"mobile","typeLabel":"string"},"cardEmail":{"type":"string","format":"email","description":"Email address associated with the card","example":"john.doe@example.com","uniqueKey":"cardEmail","typeLabel":"string\u003cemail>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","cardAccountId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","xid":"\u003cstring>","xmetadata":"\u003cunknown>","status":"active","embossedName":"\u003cstring>","network":"mastercard","product":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","imageUrl":"\u003cstring>","cardType":"\u003cstring>","cardImageDetails":{"cardOrientation":"LANDSCAPE","cardWidth":"\u003cstring>","cardHeight":"\u003cstring>","cardNameFontSize":"\u003cstring>","cardNameFontWeight":"\u003cstring>","cardNameLineHeight":"\u003cstring>","cardNameLetterSpacing":"\u003cstring>","cardNamePosition":"\u003cstring>","cardNameCoordinates":[123],"cardNameColor":"\u003cstring>"}},"expiryMonth":9,"expiryYear":2030,"last4":"\u003cstring>","replacedBy":"\u003cstring>","cardLimit":123,"dailyAtmLimit":123,"dailyPurchaseLimit":123,"dailyLimit":123,"singleTransactionLimit":123,"availableLimit":123,"cardPresentLimit":123,"cardNotPresentLimit":123,"mobile":"\u003cstring>","cardEmail":"john.doe@example.com"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"1cbb6398-fa06-476b-81b4-0ffc2560bccf":{"Basic":{"type":"http","scheme":"basic","scopes":[],"schemeName":"Basic"}},"6ddf0c6f-ae63-444d-8e5c-eca0189b5c1d":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"Bearer"}}},"servers":{"f66b622f-95f4-41ab-8ca7-ffcfd06b01ee":{"url":"https://access.utgl.io/v1"},"30b5b6b9-30cd-4bba-bca7-580a4d6e748a":{"url":"https://sandbox.access.utgl.io/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","scopes":[],"schemeName":"Basic"},"schema":{"title":"Basic Auth","type":"object","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"Basic","name":"Authorization"}],"title":"Basic"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"Bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Bearer","name":"Authorization"}],"title":"Bearer"}]},"originalFileLocation":"issuing/api-reference/openapi.yaml"},"subdomain":"utgl","siteName":"UTGL Developer Portal","title":"Issue Card - UTGL Developer Portal","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-15T00:19:55.794Z","originalFileLocation":"api-reference/cards/issue-card.mdx"},"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=\"Issue a card under the respective card account. This can be either a physical, which is a traditional tangible card made of plastic, or a virtual card, which is a digital version of a physical card that can be used for online transactions or transactions made through a mobile device. When issuing a card, the productId must be specified and determines the card product to issue. The card product determines the card type, card face, card features, benefits, interest rates, capabilties, etc. The list of available productIds is static will be provided by your solution manager based on your pre-determined card product offering(s). The card will be chosen from the available inventory and given out in numerical order according to its card number. If you wish to issue a specific card, you may specify the card number suffix (up to the full card numberA) using the cardSuffix field. If the card number is not part of the productId or already issued, the request will fail. Multiple cards can be issued under the a single card account. Once the request has been processed: - The card will be created in the system under the respective card account. - The card can then be activated and used for making purchases.\">\u003cmeta data-mint-head name=\"application-name\" content=\"UTGL Developer Portal\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/utgl/mj5RIT4qqLiPaKIk/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/utgl/mj5RIT4qqLiPaKIk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/utgl/mj5RIT4qqLiPaKIk/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/utgl/mj5RIT4qqLiPaKIk/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/utgl/mj5RIT4qqLiPaKIk/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/utgl/mj5RIT4qqLiPaKIk/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/utgl/mj5RIT4qqLiPaKIk/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/utgl/mj5RIT4qqLiPaKIk/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/utgl/mj5RIT4qqLiPaKIk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Issue Card - UTGL Developer Portal\">\u003cmeta data-mint-head property=\"og:description\" content=\"Issue a card under the respective card account. This can be either a physical, which is a traditional tangible card made of plastic, or a virtual card, which is a digital version of a physical card that can be used for online transactions or transactions made through a mobile device. When issuing a card, the productId must be specified and determines the card product to issue. The card product determines the card type, card face, card features, benefits, interest rates, capabilties, etc. The list of available productIds is static will be provided by your solution manager based on your pre-determined card product offering(s). The card will be chosen from the available inventory and given out in numerical order according to its card number. If you wish to issue a specific card, you may specify the card number suffix (up to the full card numberA) using the cardSuffix field. If the card number is not part of the productId or already issued, the request will fail. Multiple cards can be issued under the a single card account. Once the request has been processed: - The card will be created in the system under the respective card account. - The card can then be activated and used for making purchases.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"UTGL Developer Portal\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.utgl.io/api-reference/cards/issue-card\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://utgl.mintlify.app/_mintlify/api/og/v2?division=Cards\u0026amp;title=Issue+Card\u0026amp;description=Issue+a+card+under+the+respective+card+account.%0A%0AThis+can+be+either+a+physical%2C+which+is+a+traditional+tangible+card+made+of+plastic%2C+or+a+virtual+card%2C+which+i\u0026amp;theme=f13e083955cb216bdc057ca0\u0026amp;signature=c71a150a40abe3eebd096b8b8cd10dbe584035667283e6bcd7c7eb8eb2d40f9a\">\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=\"Issue Card - UTGL Developer Portal\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Issue a card under the respective card account. This can be either a physical, which is a traditional tangible card made of plastic, or a virtual card, which is a digital version of a physical card that can be used for online transactions or transactions made through a mobile device. When issuing a card, the productId must be specified and determines the card product to issue. The card product determines the card type, card face, card features, benefits, interest rates, capabilties, etc. The list of available productIds is static will be provided by your solution manager based on your pre-determined card product offering(s). The card will be chosen from the available inventory and given out in numerical order according to its card number. If you wish to issue a specific card, you may specify the card number suffix (up to the full card numberA) using the cardSuffix field. If the card number is not part of the productId or already issued, the request will fail. Multiple cards can be issued under the a single card account. Once the request has been processed: - The card will be created in the system under the respective card account. - The card can then be activated and used for making purchases.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://utgl.mintlify.app/_mintlify/api/og/v2?division=Cards\u0026amp;title=Issue+Card\u0026amp;description=Issue+a+card+under+the+respective+card+account.%0A%0AThis+can+be+either+a+physical%2C+which+is+a+traditional+tangible+card+made+of+plastic%2C+or+a+virtual+card%2C+which+i\u0026amp;theme=f13e083955cb216bdc057ca0\u0026amp;signature=c71a150a40abe3eebd096b8b8cd10dbe584035667283e6bcd7c7eb8eb2d40f9a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/utgl/mj5RIT4qqLiPaKIk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"UTGL Developer Portal\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.utgl.io/api-reference/cards/issue-card\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/cards/issue-card.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.utgl.io/#organization\",\"name\":\"UTGL Developer Portal\",\"url\":\"https://developer.utgl.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/utgl/0RP3r5GPH0T45wL4/images/utgl-logo-light.png?fit=max\u0026auto=format\u0026n=0RP3r5GPH0T45wL4\u0026q=85\u0026s=981263f94aa1e78e30f255123606b9b6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.utgl.io#website\",\"name\":\"UTGL Developer Portal\",\"url\":\"https://developer.utgl.io\",\"publisher\":{\"@id\":\"https://developer.utgl.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.utgl.io/api-reference/cards/issue-card#webpage\",\"url\":\"https://developer.utgl.io/api-reference/cards/issue-card\",\"name\":\"Issue Card\",\"description\":\"Issue a card under the respective card account. This can be either a physical, which is a traditional tangible card made of plastic, or a virtual card, which is a digital version of a physical card that can be used for online transactions or transactions made through a mobile device. When issuing a card, the productId must be specified and determines the card product to issue. The card product determines the card type, card face, card features, benefits, interest rates, capabilties, etc. The list of available productIds is static will be provided by your solution manager based on your pre-determined card product offering(s). The card will be chosen from the available inventory and given out in numerical order according to its card number. If you wish to issue a specific card, you may specify the card number suffix (up to the full card numberA) using the cardSuffix field. If the card number is not part of the productId or already issued, the request will fail. Multiple cards can be issued under the a single card account. Once the request has been processed: - The card will be created in the system under the respective card account. - The card can then be activated and used for making purchases.\",\"dateModified\":\"2026-10-15T00:19:55.794Z\",\"isPartOf\":{\"@id\":\"https://developer.utgl.io#website\"},\"breadcrumb\":{\"@id\":\"https://developer.utgl.io/api-reference/cards/issue-card#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.utgl.io/api-reference/cards/issue-card#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cards\",\"item\":\"https://developer.utgl.io/api-reference/cards/get-cards\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Issue Card\",\"item\":\"https://developer.utgl.io/api-reference/cards/issue-card\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.utgl.io/api-reference/cards/issue-card#apireference\",\"headline\":\"Issue Card\",\"name\":\"Issue Card\",\"description\":\"Issue a card under the respective card account. This can be either a physical, which is a traditional tangible card made of plastic, or a virtual card, which is a digital version of a physical card that can be used for online transactions or transactions made through a mobile device. When issuing a card, the productId must be specified and determines the card product to issue. The card product determines the card type, card face, card features, benefits, interest rates, capabilties, etc. The list of available productIds is static will be provided by your solution manager based on your pre-determined card product offering(s). The card will be chosen from the available inventory and given out in numerical order according to its card number. If you wish to issue a specific card, you may specify the card number suffix (up to the full card numberA) using the cardSuffix field. If the card number is not part of the productId or already issued, the request will fail. Multiple cards can be issued under the a single card account. Once the request has been processed: - The card will be created in the system under the respective card account. - The card can then be activated and used for making purchases.\",\"url\":\"https://developer.utgl.io/api-reference/cards/issue-card\",\"mainEntityOfPage\":{\"@id\":\"https://developer.utgl.io/api-reference/cards/issue-card#webpage\"},\"dateModified\":\"2026-10-15T00:19:55.794Z\",\"publisher\":{\"@id\":\"https://developer.utgl.io/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.utgl.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"UTGL Developer Portal\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"UTGL Developer Portal","nav":{"global":null,"products":[{"product":"Issuing API","icon":"credit-card","description":"For financial institutions issuing cards","tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/issuing/getting-started/overview"}]},{"tab":"Guides","icon":"book","pages":[{"title":"Guides","href":"/issuing/guides/card-account-modes"}]},{"tab":"Recipes","icon":"code","pages":[{"title":"Recipes","href":"/issuing/recipes/authentication-java"}]},{"tab":"API Reference","groups":[{"group":"Health","pages":[{"title":"Test connectivity","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /ping","href":"/api-reference/health/test-connectivity"},{"title":"Test connectivity","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /ping","href":"/api-reference/health/test-connectivity-1"}]},{"group":"Card Accounts","pages":[{"title":"Aggregated card accounts balance","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /cardaccounts/aggregate-balance","href":"/api-reference/card-accounts/aggregated-card-accounts-balance"},{"title":"Get Card Accounts","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /cardaccounts","href":"/api-reference/card-accounts/get-card-accounts"},{"title":"Create Card Account","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cardaccounts","href":"/api-reference/card-accounts/create-card-account"},{"title":"Get Card Account Transactions","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /cardaccounts/transactions","href":"/api-reference/card-accounts/get-card-account-transactions"},{"title":"Balance Transfer","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cardaccounts/transfer","href":"/api-reference/card-accounts/balance-transfer"},{"title":"Top up account","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cardaccounts/topup","href":"/api-reference/card-accounts/top-up-account"},{"title":"Withdraw card account balance","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cardaccounts/withdraw","href":"/api-reference/card-accounts/withdraw-card-account-balance"},{"title":"simulate repay card account","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cardaccounts/simulate-repay","href":"/api-reference/card-accounts/simulate-repay-card-account"},{"title":"Simulate client identity approval or rejection","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cardaccounts/simulate-client-identity-status","href":"/api-reference/card-accounts/simulate-client-identity-approval-or-rejection"},{"title":"Update fixed limit for card accounts","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cardaccounts/fixed-limit","href":"/api-reference/card-accounts/update-fixed-limit-for-card-accounts"},{"title":"Get client identity information for a card account","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /cardaccounts/client-identity","href":"/api-reference/card-accounts/get-client-identity-information-for-a-card-account"},{"title":"Update client identity information for a card account","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cardaccounts/client-identity","href":"/api-reference/card-accounts/update-client-identity-information-for-a-card-account"}]},{"group":"Countries","pages":[{"title":"Get Countries","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /countries","href":"/api-reference/countries/get-countries"}]},{"group":"Positions","pages":[{"title":"Get Positions","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /positions","href":"/api-reference/positions/get-positions"}]},{"group":"Occupations","pages":[{"title":"Get Occupations","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /occupations","href":"/api-reference/occupations/get-occupations"}]},{"group":"Webhooks","pages":[{"title":"Get Webhook Stats","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /webhooks/stats","href":"/api-reference/webhooks/get-webhook-stats"},{"title":"Resume Suspended Webhook","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /webhooks/resume","href":"/api-reference/webhooks/resume-suspended-webhook"},{"title":"Remove Webhook","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /webhooks/remove","href":"/api-reference/webhooks/remove-webhook"},{"title":"List Webhooks","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create Webhook","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /webhooks","href":"/api-reference/webhooks/create-webhook"}]},{"group":"Accounts","pages":[{"title":"Get Accounts","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /accounts","href":"/api-reference/accounts/get-accounts"},{"title":"Create Account","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /accounts","href":"/api-reference/accounts/create-account"},{"title":"Add Assets to Account","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /accounts/add-assets","href":"/api-reference/accounts/add-assets-to-account"},{"title":"Remove Assets from Account","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /accounts/remove-assets","href":"/api-reference/accounts/remove-assets-from-account"},{"title":"Get Balances","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /accounts/balances","href":"/api-reference/accounts/get-balances"},{"title":"Get account credit summary","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /accounts/credit-summary","href":"/api-reference/accounts/get-account-credit-summary"}]},{"group":"Transfers","pages":[{"title":"Get Account Transfers","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /accounts/transfers","href":"/api-reference/transfers/get-account-transfers"},{"title":"Create a Transfer","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /accounts/transfers","href":"/api-reference/transfers/create-a-transfer"}]},{"group":"Transactions","pages":[{"title":"Get Account Transactions","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /accounts/transactions","href":"/api-reference/transactions/get-account-transactions"}]},{"group":"Card Products","pages":[{"title":"Get Whitelisted Card Products","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /card-products","href":"/api-reference/card-products/get-whitelisted-card-products"},{"title":"Get card products inventory","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /card-products/inventory","href":"/api-reference/card-products/get-card-products-inventory"}]},{"group":"Cards","pages":[{"title":"Get Cards","description":"Get Cards","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /cards","href":"/api-reference/cards/get-cards"},{"title":"Issue Card","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards","href":"/api-reference/cards/issue-card"},{"title":"Activate Card","description":"Activate a card","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/activate","href":"/api-reference/cards/activate-card"},{"title":"Suspend Card","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/suspend","href":"/api-reference/cards/suspend-card"},{"title":"Unsuspend Card","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/unsuspend","href":"/api-reference/cards/unsuspend-card"},{"title":"Lock Card","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/lock","href":"/api-reference/cards/lock-card"},{"title":"Unlock Card","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/unlock","href":"/api-reference/cards/unlock-card"},{"title":"Cancel a card","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/cancel","href":"/api-reference/cards/cancel-a-card"},{"title":"Get Card Sensitive Info","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /cards/card-sensitive-info","href":"/api-reference/cards/get-card-sensitive-info"},{"title":"Change Card PIN","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/change-pin","href":"/api-reference/cards/change-card-pin"},{"title":"Control Spending","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/spending-controls","href":"/api-reference/cards/control-spending"},{"title":"Update Card Phone Number","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/update-phone","href":"/api-reference/cards/update-card-phone-number"},{"title":"Validate a card with card info.","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/validate-card-info","href":"/api-reference/cards/validate-a-card-with-card-info"},{"title":"Get Card Notification Settings","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /cards/notification-settings","href":"/api-reference/cards/get-card-notification-settings"},{"title":"Update Card Notification Settings","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/notification-settings","href":"/api-reference/cards/update-card-notification-settings"},{"title":"Update card email address","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/update-email","href":"/api-reference/cards/update-card-email-address"}]},{"group":"Card Transaction Simulator","pages":[{"title":"Simulate Authorization","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/simulate-authorization","href":"/api-reference/card-transaction-simulator/simulate-authorization"},{"title":"Simulate a clearing of an authorized transaction","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/simulate-capture","href":"/api-reference/card-transaction-simulator/simulate-a-clearing-of-an-authorized-transaction"},{"title":"Simulate a refund transaction","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/simulate-refund","href":"/api-reference/card-transaction-simulator/simulate-a-refund-transaction"},{"title":"Simulate a decline transaction","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/simulate-decline","href":"/api-reference/card-transaction-simulator/simulate-a-decline-transaction"},{"title":"Simulate a full reversal of an authorized transaction","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/simulate-full-reversal","href":"/api-reference/card-transaction-simulator/simulate-a-full-reversal-of-an-authorized-transaction"},{"title":"Simulate a partial reversal of an authorized transaction","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /cards/simulate-partial-reversal","href":"/api-reference/card-transaction-simulator/simulate-a-partial-reversal-of-an-authorized-transaction"}]},{"group":"Digital Custody","pages":[{"title":"Get Supported Digital Assets","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /digital-custody/assets","href":"/api-reference/digital-custody/get-supported-digital-assets"},{"title":"Get Supported Blockchains","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /digital-custody/chains","href":"/api-reference/digital-custody/get-supported-blockchains"},{"title":"Get Deposit Addresses","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /digital-custody/deposit-addresses","href":"/api-reference/digital-custody/get-deposit-addresses"},{"title":"Generate Deposit Address","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /digital-custody/deposit-addresses","href":"/api-reference/digital-custody/generate-deposit-address"}]},{"group":"Payouts","pages":[{"title":"Get Payouts","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /payouts","href":"/api-reference/payouts/get-payouts"},{"title":"Create Payout","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /payouts","href":"/api-reference/payouts/create-payout"},{"title":"Validate Payout Parameters","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /payouts/validate","href":"/api-reference/payouts/validate-payout-parameters"},{"title":"Get Payout Quotation","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /payouts/quote","href":"/api-reference/payouts/get-payout-quotation"},{"title":"Get Payout Banks by Country","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /payouts/{countryCode}/banks","href":"/api-reference/payouts/get-payout-banks-by-country"}]},{"group":"Conversions","pages":[{"title":"Get a Quote","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /conversions/quote","href":"/api-reference/conversions/get-a-quote"},{"title":"Execute a trade","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /conversions/execute","href":"/api-reference/conversions/execute-a-trade"}]},{"group":"Fees","pages":[{"title":"Get Fees","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /fees","href":"/api-reference/fees/get-fees"},{"title":"Charge Fee","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /fees/charge","href":"/api-reference/fees/charge-fee"},{"title":"Waive a Fee","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /fees/waive","href":"/api-reference/fees/waive-a-fee"}]},{"group":"API Reference","pages":[{"title":"Get exchange rates for a given base currency","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /rates","href":"/api-reference/get-exchange-rates-for-a-given-base-currency"}]},{"group":"Bank Info","pages":[{"title":"Get bank data by Swift code","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml get /banks","href":"/api-reference/bank-info/get-bank-data-by-swift-code"}]},{"group":"Xmetadata","pages":[{"title":"Set xmetadata","deprecated":null,"version":null,"openapi":"/issuing/api-reference/openapi.yaml post /xmetadata/set","href":"/api-reference/xmetadata/set-xmetadata"}]}]},{"tab":"Changelog","icon":"newspaper","pages":[{"title":"Changelog","href":"/changelog"}]}]},{"product":"Merchant API","icon":"store","description":"For merchants accepting UTGL card payments","pages":[{"title":"Merchant API","href":"/merchant/partner-connect"}]}]},"basePath":"","title":"Issue Card - UTGL Developer Portal","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}