--- updatedAt: 2026-05-07T13:26:35.000Z agentTools: siteIndex: https://developers.pismo.io/llms.txt projectIndex: https://developers.pismo.io/pismo-docs/llms.txt --- # Associate noname card with customer Bind an account and customer to a noname card, which changes its status to `CREATED`. The card is then treated as a normal physical plastic or metal card. You have to pass this endpoint a noname card's ID. Card IDs are generated when the [Start noname card bulk process](ref:start-bulk) endpoint is called. This endpoint generates an event for each card - [Card created](https://developers.pismo.io/events/docs/cards-create-1) - with event data that includes the card ID, bulk ID, and external ID. Refer to the [Data and reporting](doc:data-reporting-overview) guide for information on events and setting up event notifications. The bind operation is completed asynchronously and generates a [Customer bound to noname card](https://developers.pismo.io/events/docs/cards-bind-card-1) event. Make sure the operation has completed and the event generated before attempting to access or use the associated card. **Card reissuing** * You can use this endpoint to reissue a card—replacing the card to be reissued with a noname card, which is then treated as a normal physical card. If a card to be replaced is entered (`reissued_card_id`), the [Card updated](https://developers.pismo.io/events/docs/cards-update-1) event is also generated. * If you attempt to reissue a card to a card that has already been associated, meaning it is no longer a noname card and no longer has an `UNBOUND` status, you will get a **409 Conflict** error. **Note:** This endpoint requires an account token - an access token encoded with a Pismo account ID. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Card issuing - Cards", "version": "1.4.6", "description": "Card endpoints API", "contact": { "name": "API Support", "url": "https://developers.pismo.io/support/" }, "license": { "name": "Copyright Pismo" } }, "servers": [ { "url": "https://sandbox.pismolabs.io", "description": "Sandbox API server for testing." }, { "url": "https://gw-pci.pismolabs.io", "description": "Sandbox PCI API server for testing." } ], "security": [ { "BearerAuth": [] } ], "tags": [ { "name": "Noname", "description": "Noname card endpoints. Noname cards are batch-generated and not initially associated with customers, which occurs later." } ], "components": { "parameters": { "cardId": { "in": "path", "name": "cardId", "schema": { "type": "string" }, "description": "Pismo card ID", "example": "12345", "required": true }, "customerIdHeader": { "in": "header", "name": "x-customer-id", "schema": { "type": "integer" }, "required": true, "description": "Pismo customer ID", "example": 125555 }, "x-AccountIdHeader": { "in": "header", "name": "x-account-id", "schema": { "type": "string" }, "description": "Account ID", "required": true, "example": "8675309" } }, "schemas": { "BindRequest": { "type": "object", "properties": { "reissued_card_id": { "$ref": "#/components/schemas/ReissuedCardID" } } }, "ReissuedCardID": { "type": "integer", "description": "Last issued card ID", "example": 123456 } }, "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "description": "Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in an \"Unauthorized\" error.", "bearerFormat": "JWT" } }, "responses": { "400BadRequest": { "description": "Bad Request" }, "401Unauthorized": { "description": "Access token is missing or invalid" }, "403Forbidden": { "description": "You don't have permission to access this resource" }, "409Conflict": { "description": "Specified resource status conflict with current request" }, "500InternalServer": { "description": "Internal server error" } } }, "paths": { "/wallet/v2/cards/{cardId}/noname/bind": { "put": { "operationId": "post-v2-card-bind", "summary": "Associate noname card with customer", "description": "Bind an account and customer to a noname card, which changes its status to `CREATED`. The card is then treated as a normal physical plastic or metal card.\n\nYou have to pass this endpoint a noname card's ID. Card IDs are generated when the [Start noname card bulk process](https://developers.pismo.io/pismo-docs/reference/start-bulk) endpoint is called. This endpoint generates an event for each card - [Card created](https://developers.pismo.io/events/docs/cards-create-1) - with event data that includes the card ID, bulk ID, and external ID. Refer to the [Data and reporting](https://developers.pismo.io/pismo-docs/docs/data-reporting-overview) guide for information on events and setting up event notifications.\n\nThe bind operation is completed asynchronously and generates a [Customer bound to noname card](https://developers.pismo.io/events/docs/cards-bind-card-1) event. Make sure the operation has completed and the event generated before attempting to access or use the associated card. \n\n**Card reissuing**\n\n* You can use this endpoint to reissue a card—replacing the card to be reissued with a noname card, which is then treated as a normal physical card. If a card to be replaced is entered (`reissued_card_id`), the [Card updated](https://developers.pismo.io/events/docs/cards-update-1) event is also generated. \n\n* If you attempt to reissue a card to a card that has already been associated, meaning it is no longer a noname card and no longer has an `UNBOUND` status, you will get a **409 Conflict** error. \n\n**Note:** This endpoint requires an account token - an access token encoded with a Pismo account ID.\n", "tags": [ "Noname" ], "parameters": [ { "$ref": "#/components/parameters/cardId" }, { "$ref": "#/components/parameters/x-AccountIdHeader" }, { "$ref": "#/components/parameters/customerIdHeader" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BindRequest" } } } }, "responses": { "202": { "description": "Your request was accepted. The bind operation is made asynchronously, check the event [Customer bound to noname card](https://developers.pismo.io/events/docs/cards-bind-card-1)." }, "400": { "$ref": "#/components/responses/400BadRequest" }, "401": { "$ref": "#/components/responses/401Unauthorized" }, "403": { "$ref": "#/components/responses/403Forbidden" }, "409": { "$ref": "#/components/responses/409Conflict" }, "500": { "$ref": "#/components/responses/500InternalServer" } } } } } } ```