> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/instant-issuance/instant-issuance-es/integrar-la-api-de-d1/referencia-de-la-api-de-d1/api-entrante-a-d1/api-de-emision-fisica.md).

# API de emisión física

## Card order

> This API is used by the issuer backend to order a single physical card.

````json
{"openapi":"3.0.0","info":{"title":"Inbound Physical Card API","version":"2.0"},"servers":[{"url":"https://api.d1.thalescloud.io/banking/v1","description":"Production server"},{"url":"https://api.d1-stg.thalescloud.io/banking/v1","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"description":"A JWT generated by the [get token API](https://docs.payments.thalescloud.io/central-issuance/integrate-d1-api/d1-api-reference/inbound-api-to-d1/oauth2-api#post-oauth2-token).<br/>\nThe server checks the validity of the provided token to control access to this protected resource. \nPlease refer to [Authorization flow](https://docs.payments.thalescloud.io/central-issuance/integrate-d1-api/d1-api-reference/inbound-api-to-d1/oauth2-api#post-oauth2-token) \nfor more details about the flow and on how to get this JWT.\n","type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"cardRequest":{"oneOf":[{"$ref":"#/components/schemas/cardRequestThales"},{"$ref":"#/components/schemas/cardRequestInstant"},{"$ref":"#/components/schemas/cardRequestCentral"}],"discriminator":{"propertyName":"distributionChannel","mapping":{"THALES":"#/components/schemas/cardRequestThales","INSTANT":"#/components/schemas/cardRequestInstant","CENTRAL":"#/components/schemas/cardRequestCentral"}}},"cardRequestThales":{"title":"distributionChannel = THALES","required":["distributionChannel","services","encryptedData","shipment","paymentApplication"],"type":"object","properties":{"distributionChannel":{"$ref":"#/components/schemas/distributionChannel"},"consumerId":{"type":"string","description":"Unique identifier of the consumer. <br>\nMandatory for implicit registration.\n","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9_-]{1,64}"},"cardProductId":{"type":"string","description":"Unique identifier of the type of card ( defined during the onboarding of D1).<br>\nMandatory for implicit registration.\n","minLength":1,"maxLength":48,"pattern":"[A-Za-z0-9_-]{1,48}"},"issuerRequestId":{"type":"string","description":"Identifier provided by issuer to identify the card production request","pattern":"^[a-zA-Z0-9_-]{1,64}$"},"services":{"$ref":"#/components/schemas/services"},"encryptedData":{"$ref":"#/components/schemas/encryptedData"},"cardDesign":{"$ref":"#/components/schemas/cardDesign"},"paymentApplication":{"$ref":"#/components/schemas/paymentApplication"},"cardCarrierConfig":{"$ref":"#/components/schemas/cardCarrierConfig"},"packagingConfig":{"$ref":"#/components/schemas/packagingConfig"},"shipment":{"$ref":"#/components/schemas/shipment"},"state":{"description":"Deprecated. This field is no longer used and will be removed by end of 2026.\n","type":"string","deprecated":true,"enum":["ACTIVE","SUSPENDED"]},"oldCardId":{"type":"string","description":"Deprecated. This field is no longer used and will be removed by end of 2026.\n","deprecated":true,"minLength":1,"maxLength":48,"pattern":"^[A-Za-z0-9_-]{1,48}$"}}},"distributionChannel":{"type":"string","description":"Channel used to personalize the card.\n|Value|Description|\n|-------|-------|\n| THALES  | Thales personalization center |\n| INSTANT | Instant issuance in branch |\n| CENTRAL | Bank or partner center |\n","enum":["THALES","INSTANT","CENTRAL"]},"services":{"required":["issuance"],"properties":{"issuance":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,64}$","description":"The type of issuance.<br/>Value must be one of the identifiers configured during onboarding.\n<br/>  \n|Attribute|Description|\n|-------|-------|\n|CREATION|Issuance of a brand-new card to a user|\n|RENEWAL|An existing card reaches its expiration date and needs to be replaced with a new one for continued use|\n|REPLACEMENT|An existing card needs to be reissued due to loss, theft, or damage.|\n"},"priority":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,64}$","description":"The level of priority agreed for the card production.<br/>Value must be one of the identifiers configured during onboarding.\n"},"delivery":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,64}$","default":"NO_SHIPMENT","description":"The shipment method.<br/>Value must be one of the identifiers configured during onboarding.\n"},"packaging":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,64}$","default":"NO_PACK","description":"Unique identifier of the packaging.<br/>Value must be one of the identifiers configured during onboarding.\n"},"cardCarrier":{"type":"string","default":"NO_CARRIER","pattern":"^[a-zA-Z0-9_-]{1,64}$","description":"Unique identifier of the card carrier.<br/>Value must be one of the identifiers configured during onboarding.\n"},"pinMailer":{"type":"boolean","default":false,"description":"Enable the option to send the PIN value to the consumer via post mail. \n"},"alphaCard":{"type":"boolean","default":false,"description":"Enable the option to produce a sample card in the production environment.\n"}}},"encryptedData":{"type":"string","description":"The encrypted **[Card Data](https://docs.payments.thalescloud.io/central-issuance/integrate-d1-api/d1-api-reference/inbound-api-to-d1/central-issuance-api#encrypted-carddata)**.<br/>\nThis value is encrypted using the JWE encryption (please refer to the [Sensitive Information Encryption](https://app.gitbook.com/o/fwy1mtbRONGA2YDKDBr0/s/WhgSoXgpjZJxLx4cDHB1/integrate-d1-api/d1-connectivity/encrypt-sensitive-data) for more details)\n"},"cardDesign":{"type":"object","properties":{"images":{"description":"List of additional images that can be printed on the card.\n","type":"array","minItems":0,"maxItems":5,"default":[],"items":{"type":"string","pattern":"^[A-Za-z0-9_.-\\\\\\/%\\^?=]{0,64}$"}},"customLines":{"description":"List of additional texts that can be printed on the card.\n","type":"array","minItems":0,"maxItems":10,"default":[],"items":{"type":"string","pattern":"^[\\p{L}\\p{N}@ ,.'_#;:\\/-?=%\\\\\\^+&]{0,256}$"}},"cardImage":{"type":"string","description":"Unique identifier of the AllAboutMe image to be printed onto the card, previously uploaded by end user.\n","pattern":"^[A-Za-z0-9_\\-\\\\\\/.\\^]{0,48}$"},"artworkId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$","description":"Unique identifier of the physical card artwork.\n"},"memberId":{"type":"string","description":"MemberId printed onto the card.\n","pattern":"^[A-Za-z0-9_\\\\\\/.-]{1,48}$"}}},"paymentApplication":{"type":"object","required":["config"],"properties":{"config":{"type":"string","description":"The reference to a predefined set of EMV parameters.\n","pattern":"^[a-zA-Z0-9_-]{1,64}$"},"odaKeyIndex":{"type":"string","description":"The index of the Master key to be used for the ODA key certification.","pattern":"^[A-F0-9]{2}$"},"derivationKeyIndex":{"type":"string","description":"The index of the Issuer Master Keys to be used for ICC Keys computation.","pattern":"^[A-F0-9]{2}$"},"pvKeyIndex":{"type":"string","description":"The index of the PIN Verification Key to be used for PVV computation.","pattern":"^[A-F0-9]{2}$"},"cvKeyIndex":{"type":"string","description":"The index of the Card Verification Key to be used for CVV computation.","pattern":"^[A-F0-9]{2}$"}}},"cardCarrierConfig":{"type":"object","properties":{"language":{"description":"The language of the card carrier, based on ISO 639-1 alpha-2 format.\n","type":"string","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$"},"images":{"description":"List of additional images that can be printed on the card carrier.\n","type":"array","minItems":0,"maxItems":5,"default":[],"items":{"type":"string","pattern":"^[A-Za-z0-9_.-\\\\\\/%\\^?=]{0,64}$"}},"customLines":{"description":"List of additional texts that can be printed on the card carrier.\n","type":"array","minItems":0,"maxItems":10,"default":[],"items":{"type":"string","pattern":"^[\\p{L}\\p{N}@ ,.'_#;:\\/-?=%\\\\\\^+&]{0,256}$"}},"multiCardId":{"description":"All the cards with the same identifier will be grouped on the same card carrier.\n","type":"string","minLength":1,"maxLength":48,"pattern":"^[A-Za-z0-9_-]{1,48}$"},"multiCardOrder":{"description":"Order of the card on the carrier, compared to other cards.\n","type":"string","minLength":1,"maxLength":2,"pattern":"^[0-9]{1,2}$"}}},"packagingConfig":{"type":"object","properties":{"inserts":{"type":"array","minItems":0,"maxItems":10,"items":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,48}$"},"description":"List of inserts. Each insert must be a unique identifier.\n"}}},"shipment":{"oneOf":[{"$ref":"#/components/schemas/shipmentIndividual"},{"$ref":"#/components/schemas/shipmentBulk"}],"discriminator":{"propertyName":"type","mapping":{"INDIVIDUAL":"#/components/schemas/shipmentIndividual","BULK":"#/components/schemas/shipmentBulk"}}},"shipmentIndividual":{"title":"type = INDIVIDUAL","type":"object","required":["type","deliveryAddress"],"properties":{"type":{"type":"string","description":"Option to send the card to the consumer individually or in bulk to an agency.<br/>\nWhen shipment type is ```BULK``` all the cards with the same delivery address, and shipped the same day will be grouped together automatically.\n","enum":["INDIVIDUAL"]},"deliveryAddress":{"description":"The recipient's address.\n","$ref":"#/components/schemas/address"}}},"address":{"type":"object","required":["lastName","line1","zipCode","city","countryCode"],"properties":{"title":{"type":"string","description":"The title.","minLength":1,"maxLength":40,"pattern":"^[\\p{L}\\p{N}\\p{M} ,.'_#;:\\/-]{1,40}$"},"firstName":{"type":"string","description":"The first name.","minLength":1,"maxLength":40,"pattern":"^[\\p{L}\\p{N}\\p{M} ,.'_#;:\\/-]{1,40}$"},"lastName":{"type":"string","description":"The last name.","minLength":1,"maxLength":40,"pattern":"^[\\p{L}\\p{N}\\p{M} ,.'_#;:\\/-]{1,40}$"},"companyName":{"type":"string","description":"The name of the company.","minLength":1,"maxLength":64,"pattern":"^[\\p{L}\\p{N}\\p{M} '_#;:.,-\\/+&]{1,64}$"},"line1":{"type":"string","description":"The first line of the address.","minLength":1,"maxLength":64,"pattern":"^[\\p{L}\\p{N}\\p{M} ,.'_#;:\\/-]{1,64}$"},"line2":{"type":"string","description":"The second line of the address.","minLength":1,"maxLength":64,"pattern":"^[\\p{L}\\p{N}\\p{M} ,.'_#;:\\/-]{1,64}$"},"line3":{"type":"string","description":"The third line of the address.","minLength":1,"maxLength":64,"pattern":"^[\\p{L}\\p{N}\\p{M} ,.'_#;:\\/-]{1,64}$"},"line4":{"type":"string","description":"Deprecated. This field is no longer used and will be removed by end of 2026.\n","minLength":1,"maxLength":64,"pattern":"^[\\p{L}\\p{N}\\p{M} ,.'_#;:\\/-]{1,64}$","deprecated":true},"city":{"type":"string","description":"The city name.","minLength":1,"maxLength":32,"pattern":"^[\\p{L}\\p{N}\\p{M} ,.'_#;:\\/-]{1,32}$"},"state":{"type":"string","description":"The state.","minLength":1,"maxLength":30,"pattern":"^[\\p{L}\\p{N}\\p{M} ,.'_#;:\\/-]{1,30}$"},"zipCode":{"type":"string","description":"The postal code or ZIP Code.","minLength":1,"maxLength":10,"pattern":"^[0-9A-Z- ]{1,10}$"},"countryCode":{"type":"string","description":"The country code, based on ISO 3166-1 alpha-2 format","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$"},"mobilePhoneNumber":{"type":"object","required":["countryCode","phoneNumber"],"description":"International phone number, used for card shipment contact purpose.","properties":{"countryCode":{"type":"string","description":"The country calling code.","minLength":2,"maxLength":11,"pattern":"^\\+[0-9]{1,10}$"},"phoneNumber":{"type":"string","description":"The local phone number.","minLength":1,"maxLength":14,"pattern":"^[0-9]{1,14}$"}}},"email":{"type":"string","description":"The email, used for card shipment contact purpose.","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9_+&*-]+(?:\\.[a-zA-Z0-9_+&*-]+)*@(?:[a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,15}$"}}},"shipmentBulk":{"title":"type = BULK","type":"object","required":["type","deliveryAddress"],"properties":{"type":{"type":"string","description":"Option to send the card to the consumer individually or in bulk to an agency.<br/>\nWhen shipment type is ```BULK``` all the cards with the same delivery address, and shipped the same day will be grouped together automatically.\n","enum":["BULK"]},"deliveryAddress":{"description":"The recipient's address.\n","$ref":"#/components/schemas/address"},"individualAddress":{"description":"The consumer address.<br>\nRequired only for ```BULK``` + card carrier required.\n","$ref":"#/components/schemas/address"},"groupId":{"type":"string","minLength":1,"maxLength":64,"description":"First level of grouping when shipment type is ```BULK```.<br/>\nOptional, to be used only if grouping per delivery address is not sufficient.<br/>\nAll the cards with the same groupId will be put together in the same box.<br/>\n"},"orderId":{"type":"string","minLength":1,"maxLength":64,"description":"Second level of grouping when shipment type is ```BULK```.<br/>\nOptional, to be used only if grouping per delivery address is not sufficient.<br/>\nAll the cards with the same orderId will be put together.<br/>\n"}}},"cardRequestInstant":{"title":"distributionChannel = INSTANT","required":["distributionChannel","services","encryptedData","paymentApplication","persoStation"],"type":"object","properties":{"distributionChannel":{"$ref":"#/components/schemas/distributionChannel"},"consumerId":{"$ref":"#/components/schemas/consumerId"},"cardProductId":{"$ref":"#/components/schemas/cardProductId"},"persoStation":{"type":"string","description":"Unique identifier of the station used for card personalization."},"services":{"$ref":"#/components/schemas/services"},"encryptedData":{"$ref":"#/components/schemas/encryptedData"},"cardDesign":{"$ref":"#/components/schemas/cardDesign"},"paymentApplication":{"$ref":"#/components/schemas/paymentApplication"},"cardCarrierConfig":{"$ref":"#/components/schemas/cardCarrierConfig"},"state":{"description":"Deprecated. This field is no longer used and will be removed by end of 2026.\n","type":"string","deprecated":true,"enum":["ACTIVE","SUSPENDED"]},"oldCardId":{"type":"string","description":"Deprecated. This field is no longer used and will be removed by end of 2026.\n","deprecated":true,"minLength":1,"maxLength":48,"pattern":"^[A-Za-z0-9_-]{1,48}$"}}},"consumerId":{"type":"string","description":"Unique identifier of the consumer. ","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]{1,64}$"},"cardProductId":{"type":"string","description":"Unique identifier of the type of card ( defined during the onboarding of D1)","minLength":1,"maxLength":48,"pattern":"^[A-Za-z0-9_-]{1,48}$"},"cardRequestCentral":{"title":"distributionChannel = CENTRAL","required":["distributionChannel","services","encryptedData","shipment","paymentApplication"],"type":"object","properties":{"distributionChannel":{"$ref":"#/components/schemas/distributionChannel"},"consumerId":{"$ref":"#/components/schemas/consumerId"},"cardProductId":{"$ref":"#/components/schemas/cardProductId"},"persoCenter":{"type":"string","description":"Unique identifier of the personalization center."},"services":{"$ref":"#/components/schemas/services"},"encryptedData":{"$ref":"#/components/schemas/encryptedData"},"cardDesign":{"$ref":"#/components/schemas/cardDesign"},"paymentApplication":{"$ref":"#/components/schemas/paymentApplication"},"cardCarrierConfig":{"$ref":"#/components/schemas/cardCarrierConfig"},"shipment":{"$ref":"#/components/schemas/shipment"},"state":{"description":"Deprecated. This field is no longer used and will be removed by end of 2026.\n","type":"string","deprecated":true,"enum":["ACTIVE","SUSPENDED"]},"oldCardId":{"type":"string","description":"Deprecated. This field is no longer used and will be removed by end of 2026.\n","deprecated":true,"minLength":1,"maxLength":48,"pattern":"^[A-Za-z0-9_-]{1,48}$"}}},"cardOperationResponse":{"type":"object","description":"Operation information.","properties":{"operationId":{"$ref":"#/components/schemas/operationId"}}},"operationId":{"type":"string","description":"Unique identifier of the operation","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]{1,64}$"},"errorGeneric":{"additionalProperties":false,"type":"object","description":"Generic error returned by the APIs.","properties":{"errorCode":{"type":"string","description":"The type of the error"},"error":{"type":"string","description":"Provide more error details if possible.<br/>For example name of the field with invalid format.<br/>This field is for troubleshooting purposes only, it can change at any time so MUST NOT be parsed, and is not supposed to be human readable so CANNOT be displayed to end users."}}}},"responses":{"BadRequestWithErrorCode":{"description":"Bad request due to invalid URI, headers, parameters, or payload.<br/>\nThe below table defines the possible errors:\n    | errorCode      | error       | Retry Possible | Comments                             |\n    | -------------- | ------------| ----------| -----------------------------------|\n    | -                    | - | no        | General error with no further information provided.   |\n    | FIELD_INVALID_FORMAT | Field in error (first found) | no | A field does not match the expected format specified in the documentation. |\n    | CRYPTO_ERROR         | - | no | Decryption of the provided encrypted data failed. |\n    | FIELD_INVALID_VALUE  | Field in error (first found) | no | A field value is not permitted for the specified field. |\n    | PARSING_ERROR  | Field in error (first found) | no | Encrypted data is not a valid JSON string. |\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"Unauthorized":{"description":"Unauthorized request due to missing or invalid access token.\n| errorCode      | error       | Retry Possible | Comments                             |\n| -------------- | ------------| ----------| -----------------------------------|\n| -                        | - | no        | General error with no further information provided.   |\n| AUTHORIZER_UNAUTHORIZED  | Unauthorized message | no | Access token not valid       |\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"Forbidden":{"description":"Request forbidden by authorization rules or business constraints.\n<br/>\nThe below table defines the possible error:\n  | errorCode      | error       | Retry Possible | Comments                           |\n  | -------------- | ------------| ----------| -----------------------------------|\n  | -              | -           | no        | General error with no further information provided.    |\n  | AUTHORIZER_FORBIDDEN  | not\\_authorized error message | no | The user is not authorized to access the requested resource. |\n  | OPERATION_NOT_ALLOWED | Name of the operation/field that is not allowed in this operation | no | The specified operation or field is not permitted for this card product. |\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"NotFound":{"description":"Requested resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"InternalServerError":{"description":"Internal server error while processing the request.\nThe below table defines the possible error:\n|errorCode       | error       | Retry Possible | Comments                           |\n| -------------- | ------------| ----------| -----------------------------------|\n| -                        | - | no        | General error with no further information provided.   |\n| INTERNAL_ERROR | Error details (if any) | no | The server encountered an issue while processing the request.  |\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"ServiceUnavailableError":{"description":"The service is temporarily unavailable. You may retry your request later."}}},"paths":{"/issuers/{issuerId}/physicalCards/{cardId}/operations:production":{"post":{"description":"This API is used by the issuer backend to order a single physical card.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/cardRequest"}}}},"responses":{"202":{"description":"Successful card order","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cardOperationResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestWithErrorCode"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailableError"}},"summary":"Card order","operationId":"producePhysicalCard"}}}}
````


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payments.thalescloud.io/instant-issuance/instant-issuance-es/integrar-la-api-de-d1/referencia-de-la-api-de-d1/api-entrante-a-d1/api-de-emision-fisica.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.