Production
A card's production status.
Operations
Every route this entity exposes. Each route links to its own reference on this page.
| Method | Route | SDK operation | Returns |
|---|---|---|---|
GET |
/spend/profiles/{profileId}/cards/{cardToken}/production |
load |
OK - Successfully retrieved card production status |
PUT |
/spend/profiles/{profileId}/cards/{cardToken}/production |
update |
OK - The card information has been successfully sent to the kiosk machine |
Examples
One example per SDK, generated from the API model. The argument names are the parameters and fields of this entity, and the values are placeholders. The examples are not compiled or executed.
Golang
Construct client as shown in the Golang setup, then call the operations:
production, err := client.Production(nil).Load(map[string]any{"card_token": "example", "profile_id": 1}, nil)
if err != nil {
panic(err)
}
fmt.Println(production)
updated, err := client.Production(nil).Update(map[string]any{"card_token": "example", "profile_id": 1}, nil)
if err != nil {
panic(err)
}
fmt.Println(updated)
Lua
Construct client as shown in the Lua setup, then call the operations:
local production, err = client:Production():load({ card_token = "example", profile_id = 1 })
local updated, err = client:Production():update({ card_token = "example", profile_id = 1 })
PHP
Construct client as shown in the PHP setup, then call the operations:
$production = $client->Production()->load(["card_token" => "example", "profile_id" => 1]);
$updated = $client->Production()->update(["card_token" => "example", "profile_id" => 1]);
Python
Construct client as shown in the Python setup, then call the operations:
production = client.Production().load({"card_token": "example", "profile_id": 1})
updated = client.Production().update({"card_token": "example", "profile_id": 1})
Ruby
Construct client as shown in the Ruby setup, then call the operations:
production = client.Production.load({ "card_token" => "example", "profile_id" => 1 })
updated = client.Production.update({ "card_token" => "example", "profile_id" => 1 })
TypeScript
Construct client as shown in the TypeScript setup, then call the operations:
const production = await client.Production().load({ card_token: "example", profile_id: 1 })
const updated = await client.Production().update({ card_token: "example", profile_id: 1 })
Fields
| Field | Type | Required | Description |
|---|---|---|---|
description |
one,string,null |
No | Detailed description of the error code. |
errorCode |
one,string,null |
No | Code returned when card production is not successful. |
kioskId |
one,string,null |
No | Identifier that specifies which kiosk machine is producing the card. |
occurredAt |
string |
No | Time when the card production request has been sent to the kiosk machine (ISO 8601 format). |
status |
string |
No | Current production status: - READY - Card is ready for production - IN_PROGRESS - Card is in production at the kiosk machine - PRODUCED - Card is produced and collected. |
load
GET /spend/profiles/{profileId}/cards/{cardToken}/production
Operation ID: cardKioskCollectionProductionGet.
Authentication: bearer token (UserToken).
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
profileId |
path |
integer (int64) |
Yes | The profile ID (personal or business) that owns the card. |
cardToken |
path |
string |
Yes | The unique token identifying the card. |
X-External-Correlation-Id |
header |
string (uuid) |
No | Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more. |
Responses
200: OK - Successfully retrieved card production status
application/json
| Property | Type | Required | Description |
|---|---|---|---|
description |
string,null |
No | Detailed description of the error code. |
errorCode |
string,null |
No | Code returned when card production is not successful. Nullable. Request errors - Returned when status is REQUEST_ERROR: - UNKNOWN_ERROR - An error occurred on the server - REQUEST_ALREADY_EXISTS - The request has already been submitted - KIOSK_ID_NOT_FOUND - The kiosk ID does not exist - CARD_TYPE_NOT_FOUND - The card type does not exist - INVALID_FIELD_VALUE - Some field values are unexpected - INVALID_PIN_FORMAT - The PIN does not follow ISO0 or ISO2 standard - EMPTY_OR_NULL_FIELD_VALUE - Some required fields are empty or null - EMPTY_OR_NULL_OR_WRONG_SIZE_FIELD_VALUE - Some required fields are empty, null, or have incorrect lengths - CHARSET_NOT_SUPPORTED - The character set for some fields is not supported - INVALID_FIELD_FORMAT - Some field formats are invalid - INVALID_FIELD_ENCODING - The encoding for some fields is not expected - CDATA_ENCODING_OR_FORMATING_ERROR - The encoding or formatting for XML text field values is incorrect - PIN_LENGTH_ERROR - The PIN length is incorrect - PIN_VERIFICATION_FAILED - The PIN cannot be verified because the server is unreachable - DATA_PREPARATION_FAILED - The server failed to parse the request - PARTIAL_DATA_RECEIVED - Only part of the expected data has been received - NO_BRANCH_LINKED_TO_KIOSK - The kiosk has not been linked to any branch - IMAGE_SERVER_ERROR - The image server is unreachable or failed to process the data - PAN_ALREADY_EXISTS - The PAN already exists - PRINTER_OR_SATELLITE_NOT_READY - The printer or satellite is not ready to start the production - REQUEST_CREATED_BUT_NOT_STARTED - The request has been created, but production is pending until the printer or satellite is ready - UNABLE_TO_ACCEPT_REQUEST - The system is currently busy and cannot accept new requests at this time Production errors - Returned when status is PRODUCTION_ERROR: - CB_NOT_AVAILABLE - Main server error: central base not available - CB_DB_NOT_AVAILABLE - Main server error: database not available - CB_NETWORK_NOT_AVAILABLE - Main server error: network not available - CB_AUTHENTICATION_FAILED - Main server error: user authentication verification failed - CB_SERVICE_NOT_ALLOWED - Main server error: the accessed service requires a higher security level - CB_TIME - Main server error: timeout occurred on the Central Base side - DP_NOT_AVAILABLE - Data processing error: the Data preparation module is not available - DP_IO_ERROR - Data processing error: Input/Output error when communicating with the DP - DP_TIMEOUT - Data processing error: timeout error - SAT_SERVER_NOT_REACHABLE - Satellite agent error: the server is not reachable - SAT_AUTHENTICATION_FAILED - Satellite agent error: user authentication failed on satellite - SAT_NETWORK_NOT_AVAILABLE - Satellite agent error: the network is not available - PRT_NOT_REACHABLE - Printer error: printer is not reachable - PRT_SETUP_ERROR - Printer error: printer setup is incorrect - PRT_TIMEOUT - Printer error: printer timeout - PRT_RIBBON - Printer error: ribbon error - PRT_LOCK_ERROR - Printer error: printer physically unlocked - PRT_RIBBON_MISSING - Printer error: ribbon is missing - PRT_RIBBON_ENDED - Printer error: ribbon has ended - PRT_COVER_OPEN - Printer error: printer cover is open - PRT_PAUSED - Printer error: printer paused - PRD_UNEXPECTED_DATA - Production error: production data is incorrect - PRD_FEEDER_EMPTY - Production error: feeder is empty - PRD_FEEDER_JAM - Production error: feeder card jam - PRD_HOPPER_FULL - Production error: hopper is full - PRD_HOPPER_DOOR - Production error: hopper door is open - PRD_HOPPER_JAM - Production error: hopper card jam - PRD_MAGSTRIPE - Production error: error occurred during magstripe encoding - PRD_SMARTCARD - Production error: error occurred during chip personalization - PRD_EMBOSSER - Production error: error occurred during embossing - PRD_TIMEOUT - Production error: production timeout has been reached - PRD_REJECT_FULL - Production error: reject box is full - PRD_SMARTCARD_CARD_NOT_IN_READER - Production error: card is not in reader - PRD_FINAL_VALIDATION_NOK - Production error: user has rejected card production - INV_NOT_INITIALIZED - Production error: inventory not initialized - UNKNOWN_ERROR - Unknown error |
kioskId |
string,null |
No | Identifier that specifies which kiosk machine is producing the card. When the status is READY, this value is null. |
occurredAt |
string (date-time) |
No | Time when the card production request has been sent to the kiosk machine (ISO 8601 format). |
status |
enum: READY, IN_PROGRESS, PRODUCED, PRODUCTION_ERROR, REQUEST_ERROR |
No | Current production status: - READY - Card is ready for production - IN_PROGRESS - Card is in production at the kiosk machine - PRODUCED - Card is produced and collected. This is a final state - PRODUCTION_ERROR - Card production failed - REQUEST_ERROR - Card production request failed |
Example response:
{
"description": "Card ready for production",
"errorCode": null,
"kioskId": null,
"occurredAt": "2024-01-01T12:24:56.124Z",
"status": "READY"
}
429: Rate limit exceeded. Retry after the number of seconds specified in the Retry-After header
application/json
The response is object.
update
PUT /spend/profiles/{profileId}/cards/{cardToken}/production
Operation ID: cardKioskCollectionProduce.
Authentication: bearer token (UserToken).
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
profileId |
path |
integer (int64) |
Yes | The profile ID (personal or business) that owns the card. |
cardToken |
path |
string |
Yes | The unique token identifying the card. |
X-External-Correlation-Id |
header |
string (uuid) |
No | Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more. |
Request body
application/json
| Property | Type | Required | Description |
|---|---|---|---|
kioskId |
string |
Yes | Identifier that specifies on which kiosk the card should be produced. |
Responses
200: OK - The card information has been successfully sent to the kiosk machine
application/json
| Property | Type | Required | Description |
|---|---|---|---|
description |
string,null |
No | Detailed description of the error code. |
errorCode |
string,null |
No | Code returned when card production is not successful. Nullable. Request errors - Returned when status is REQUEST_ERROR: - UNKNOWN_ERROR - An error occurred on the server - REQUEST_ALREADY_EXISTS - The request has already been submitted - KIOSK_ID_NOT_FOUND - The kiosk ID does not exist - CARD_TYPE_NOT_FOUND - The card type does not exist - INVALID_FIELD_VALUE - Some field values are unexpected - INVALID_PIN_FORMAT - The PIN does not follow ISO0 or ISO2 standard - EMPTY_OR_NULL_FIELD_VALUE - Some required fields are empty or null - EMPTY_OR_NULL_OR_WRONG_SIZE_FIELD_VALUE - Some required fields are empty, null, or have incorrect lengths - CHARSET_NOT_SUPPORTED - The character set for some fields is not supported - INVALID_FIELD_FORMAT - Some field formats are invalid - INVALID_FIELD_ENCODING - The encoding for some fields is not expected - CDATA_ENCODING_OR_FORMATING_ERROR - The encoding or formatting for XML text field values is incorrect - PIN_LENGTH_ERROR - The PIN length is incorrect - PIN_VERIFICATION_FAILED - The PIN cannot be verified because the server is unreachable - DATA_PREPARATION_FAILED - The server failed to parse the request - PARTIAL_DATA_RECEIVED - Only part of the expected data has been received - NO_BRANCH_LINKED_TO_KIOSK - The kiosk has not been linked to any branch - IMAGE_SERVER_ERROR - The image server is unreachable or failed to process the data - PAN_ALREADY_EXISTS - The PAN already exists - PRINTER_OR_SATELLITE_NOT_READY - The printer or satellite is not ready to start the production - REQUEST_CREATED_BUT_NOT_STARTED - The request has been created, but production is pending until the printer or satellite is ready - UNABLE_TO_ACCEPT_REQUEST - The system is currently busy and cannot accept new requests at this time Production errors - Returned when status is PRODUCTION_ERROR: - CB_NOT_AVAILABLE - Main server error: central base not available - CB_DB_NOT_AVAILABLE - Main server error: database not available - CB_NETWORK_NOT_AVAILABLE - Main server error: network not available - CB_AUTHENTICATION_FAILED - Main server error: user authentication verification failed - CB_SERVICE_NOT_ALLOWED - Main server error: the accessed service requires a higher security level - CB_TIME - Main server error: timeout occurred on the Central Base side - DP_NOT_AVAILABLE - Data processing error: the Data preparation module is not available - DP_IO_ERROR - Data processing error: Input/Output error when communicating with the DP - DP_TIMEOUT - Data processing error: timeout error - SAT_SERVER_NOT_REACHABLE - Satellite agent error: the server is not reachable - SAT_AUTHENTICATION_FAILED - Satellite agent error: user authentication failed on satellite - SAT_NETWORK_NOT_AVAILABLE - Satellite agent error: the network is not available - PRT_NOT_REACHABLE - Printer error: printer is not reachable - PRT_SETUP_ERROR - Printer error: printer setup is incorrect - PRT_TIMEOUT - Printer error: printer timeout - PRT_RIBBON - Printer error: ribbon error - PRT_LOCK_ERROR - Printer error: printer physically unlocked - PRT_RIBBON_MISSING - Printer error: ribbon is missing - PRT_RIBBON_ENDED - Printer error: ribbon has ended - PRT_COVER_OPEN - Printer error: printer cover is open - PRT_PAUSED - Printer error: printer paused - PRD_UNEXPECTED_DATA - Production error: production data is incorrect - PRD_FEEDER_EMPTY - Production error: feeder is empty - PRD_FEEDER_JAM - Production error: feeder card jam - PRD_HOPPER_FULL - Production error: hopper is full - PRD_HOPPER_DOOR - Production error: hopper door is open - PRD_HOPPER_JAM - Production error: hopper card jam - PRD_MAGSTRIPE - Production error: error occurred during magstripe encoding - PRD_SMARTCARD - Production error: error occurred during chip personalization - PRD_EMBOSSER - Production error: error occurred during embossing - PRD_TIMEOUT - Production error: production timeout has been reached - PRD_REJECT_FULL - Production error: reject box is full - PRD_SMARTCARD_CARD_NOT_IN_READER - Production error: card is not in reader - PRD_FINAL_VALIDATION_NOK - Production error: user has rejected card production - INV_NOT_INITIALIZED - Production error: inventory not initialized - UNKNOWN_ERROR - Unknown error |
kioskId |
string,null |
No | Identifier that specifies which kiosk machine is producing the card. When the status is READY, this value is null. |
occurredAt |
string (date-time) |
No | Time when the card production request has been sent to the kiosk machine (ISO 8601 format). |
status |
enum: READY, IN_PROGRESS, PRODUCED, PRODUCTION_ERROR, REQUEST_ERROR |
No | Current production status: - READY - Card is ready for production - IN_PROGRESS - Card is in production at the kiosk machine - PRODUCED - Card is produced and collected. This is a final state - PRODUCTION_ERROR - Card production failed - REQUEST_ERROR - Card production request failed |
Example response:
{
"kioskId": "WIS00001",
"occurredAt": "2024-01-01T12:24:56.121Z",
"status": "IN_PROGRESS"
}
422: Unprocessable Content - The card information can't be processed by the kiosk machine. For more details, check the error code returned
application/json
| Property | Type | Required | Description |
|---|---|---|---|
description |
string,null |
No | Detailed description of the error code. |
errorCode |
string,null |
No | Code returned when card production is not successful. Nullable. Request errors - Returned when status is REQUEST_ERROR: - UNKNOWN_ERROR - An error occurred on the server - REQUEST_ALREADY_EXISTS - The request has already been submitted - KIOSK_ID_NOT_FOUND - The kiosk ID does not exist - CARD_TYPE_NOT_FOUND - The card type does not exist - INVALID_FIELD_VALUE - Some field values are unexpected - INVALID_PIN_FORMAT - The PIN does not follow ISO0 or ISO2 standard - EMPTY_OR_NULL_FIELD_VALUE - Some required fields are empty or null - EMPTY_OR_NULL_OR_WRONG_SIZE_FIELD_VALUE - Some required fields are empty, null, or have incorrect lengths - CHARSET_NOT_SUPPORTED - The character set for some fields is not supported - INVALID_FIELD_FORMAT - Some field formats are invalid - INVALID_FIELD_ENCODING - The encoding for some fields is not expected - CDATA_ENCODING_OR_FORMATING_ERROR - The encoding or formatting for XML text field values is incorrect - PIN_LENGTH_ERROR - The PIN length is incorrect - PIN_VERIFICATION_FAILED - The PIN cannot be verified because the server is unreachable - DATA_PREPARATION_FAILED - The server failed to parse the request - PARTIAL_DATA_RECEIVED - Only part of the expected data has been received - NO_BRANCH_LINKED_TO_KIOSK - The kiosk has not been linked to any branch - IMAGE_SERVER_ERROR - The image server is unreachable or failed to process the data - PAN_ALREADY_EXISTS - The PAN already exists - PRINTER_OR_SATELLITE_NOT_READY - The printer or satellite is not ready to start the production - REQUEST_CREATED_BUT_NOT_STARTED - The request has been created, but production is pending until the printer or satellite is ready - UNABLE_TO_ACCEPT_REQUEST - The system is currently busy and cannot accept new requests at this time Production errors - Returned when status is PRODUCTION_ERROR: - CB_NOT_AVAILABLE - Main server error: central base not available - CB_DB_NOT_AVAILABLE - Main server error: database not available - CB_NETWORK_NOT_AVAILABLE - Main server error: network not available - CB_AUTHENTICATION_FAILED - Main server error: user authentication verification failed - CB_SERVICE_NOT_ALLOWED - Main server error: the accessed service requires a higher security level - CB_TIME - Main server error: timeout occurred on the Central Base side - DP_NOT_AVAILABLE - Data processing error: the Data preparation module is not available - DP_IO_ERROR - Data processing error: Input/Output error when communicating with the DP - DP_TIMEOUT - Data processing error: timeout error - SAT_SERVER_NOT_REACHABLE - Satellite agent error: the server is not reachable - SAT_AUTHENTICATION_FAILED - Satellite agent error: user authentication failed on satellite - SAT_NETWORK_NOT_AVAILABLE - Satellite agent error: the network is not available - PRT_NOT_REACHABLE - Printer error: printer is not reachable - PRT_SETUP_ERROR - Printer error: printer setup is incorrect - PRT_TIMEOUT - Printer error: printer timeout - PRT_RIBBON - Printer error: ribbon error - PRT_LOCK_ERROR - Printer error: printer physically unlocked - PRT_RIBBON_MISSING - Printer error: ribbon is missing - PRT_RIBBON_ENDED - Printer error: ribbon has ended - PRT_COVER_OPEN - Printer error: printer cover is open - PRT_PAUSED - Printer error: printer paused - PRD_UNEXPECTED_DATA - Production error: production data is incorrect - PRD_FEEDER_EMPTY - Production error: feeder is empty - PRD_FEEDER_JAM - Production error: feeder card jam - PRD_HOPPER_FULL - Production error: hopper is full - PRD_HOPPER_DOOR - Production error: hopper door is open - PRD_HOPPER_JAM - Production error: hopper card jam - PRD_MAGSTRIPE - Production error: error occurred during magstripe encoding - PRD_SMARTCARD - Production error: error occurred during chip personalization - PRD_EMBOSSER - Production error: error occurred during embossing - PRD_TIMEOUT - Production error: production timeout has been reached - PRD_REJECT_FULL - Production error: reject box is full - PRD_SMARTCARD_CARD_NOT_IN_READER - Production error: card is not in reader - PRD_FINAL_VALIDATION_NOK - Production error: user has rejected card production - INV_NOT_INITIALIZED - Production error: inventory not initialized - UNKNOWN_ERROR - Unknown error |
kioskId |
string,null |
No | Identifier that specifies which kiosk machine is producing the card. When the status is READY, this value is null. |
occurredAt |
string (date-time) |
No | Time when the card production request has been sent to the kiosk machine (ISO 8601 format). |
status |
enum: READY, IN_PROGRESS, PRODUCED, PRODUCTION_ERROR, REQUEST_ERROR |
No | Current production status: - READY - Card is ready for production - IN_PROGRESS - Card is in production at the kiosk machine - PRODUCED - Card is produced and collected. This is a final state - PRODUCTION_ERROR - Card production failed - REQUEST_ERROR - Card production request failed |
Example response:
{
"description": "The PIN cannot be verified because the server is unreachable",
"errorCode": "PIN_VERIFICATION_FAILED",
"kioskId": "WIS00001",
"occurredAt": "2024-01-01T12:24:56.121Z",
"status": "REQUEST_ERROR"
}
429: Rate limit exceeded. Retry after the number of seconds specified in the Retry-After header
application/json
The response is object.