---
updatedAt: 2026-02-13T13:17:56.000Z
agentTools:
  projectIndex: https://docs.interswitchgroup.com/llms.txt
---

# Create a single card

This API allows the creation of one card at a time, supporting various scenarios such as creating debit cards on new or existing accounts, reissuing debit cards, and creating new or reissuing existing prepaid cards. If a pre-generated PAN is provided, the service will attempt to create the card using it; otherwise, a PAN will be automatically generated. Additionally, the endpoint supports creating anonymous cards.

<br />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "passport-management",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://qa.interswitchng.com/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/card-management/api/v1/card/request?": {
      "post": {
        "summary": "Create a single card",
        "description": "This API allows the creation of one card at a time, supporting various scenarios such as creating debit cards on new or existing accounts, reissuing debit cards, and creating new or reissuing existing prepaid cards. If a pre-generated PAN is provided, the service will attempt to create the card using it; otherwise, a PAN will be automatically generated. Additionally, the endpoint supports creating anonymous cards.",
        "operationId": "card-management-create-single-card",
        "parameters": [
          {
            "name": "cardType",
            "in": "query",
            "description": "The card types",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "DEBIT_NEW_ACCOUNT",
                "DEBIT_EXISTING_ACCOUNT",
                "DEBIT_REISSUE",
                "PREPAID_NEW",
                "PREPAID_REISSUE"
              ]
            }
          },
          {
            "name": "isActiveActive\\*\\*",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ]
            }
          },
          {
            "name": "isAnonymous",
            "in": "query",
            "description": "true - creates anonymous card without any customer specific details. Account Id, Account Type, First Name, Last Name, Name On Card are not required.  false - customer is linked to the card and all required fields must be provided.",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ]
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "userId",
                  "issuerNr",
                  "cardProgram"
                ],
                "properties": {
                  "firstName": {
                    "type": "string",
                    "description": "Required for New Debit and Prepaid Cards"
                  },
                  "lastName": {
                    "type": "string",
                    "description": "Required for New Debit and Prepaid Cards"
                  },
                  "userId": {
                    "type": "string",
                    "description": "User Id or Name e.g Alex"
                  },
                  "nameOnCard": {
                    "type": "string",
                    "description": "Required for Reissue Debit and Prepaid Cards"
                  },
                  "accountType": {
                    "type": "string",
                    "description": "Required for All Debit Card Types"
                  },
                  "customerId": {
                    "type": "string",
                    "description": "Customer ID is autogenerated when not provided"
                  },
                  "issuerNr": {
                    "type": "string",
                    "description": "Issuer Number e.g 2",
                    "default": "2"
                  },
                  "cardProgram": {
                    "type": "string",
                    "description": "Card Program e.g VERVE",
                    "default": "VERVE"
                  },
                  "pan": {
                    "type": "string",
                    "description": "Required for Reissue Debit and Prepaid Cards"
                  },
                  "lostOrStolen": {
                    "type": "string",
                    "description": "Required for Reissue Debit and Prepaid Cards"
                  },
                  "pin": {
                    "type": "string",
                    "description": "Default is 1234 when not provided",
                    "default": "1234"
                  },
                  "branchCode": {
                    "type": "string"
                  },
                  "mobileNr": {
                    "type": "string",
                    "description": "Customer Mobile Number"
                  },
                  "emailAddress": {
                    "type": "string",
                    "description": "Customer Email Address"
                  },
                  "streetAddress": {
                    "type": "string",
                    "description": "Street Address"
                  },
                  "streetAddressLine2": {
                    "type": "string",
                    "description": "Street Address Line 2"
                  },
                  "city": {
                    "type": "string",
                    "description": "City"
                  },
                  "state": {
                    "type": "string",
                    "description": "State"
                  },
                  "postalCode": {
                    "type": "string",
                    "description": "Postal Code"
                  },
                  "countryCode": {
                    "type": "string",
                    "description": "Country Code"
                  },
                  "title": {
                    "type": "string",
                    "description": "Customer Title e.g Mr"
                  },
                  "middleName": {
                    "type": "string",
                    "description": "Customer Middle Name"
                  },
                  "dateOfBirth": {
                    "type": "string",
                    "description": "Date of Birth in format YYYYMMDD e.g 19810130"
                  },
                  "rid": {
                    "type": "string",
                    "description": "Receiving Institution Identifier for Postilion"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"code\": \"00\",\n    \"description\": \"Successful\",\n    \"correlationId\": \"2f6b1ebb444845a0b896fefab2fb254b\",\n    \"card\": {\n        \"pan\": \"5061800000000000389\",\n        \"seqNr\": \"001\",\n        \"expiryDate\": \"2508\",\n        \"pinOffset\": \"7183\",\n        \"cvv\": \"902\",\n        \"cvv2\": \"840\",\n        \"pinInfo\": \"3DD636885F8CBAA5\",\n        \"track2\": \"5061800000000000389=2508101007183902\",\n        \"customerId\": \"20220811144303279780389\"\n    },\n    \"successful\": true\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "example": "00"
                    },
                    "description": {
                      "type": "string",
                      "example": "Successful"
                    },
                    "correlationId": {
                      "type": "string",
                      "example": "2f6b1ebb444845a0b896fefab2fb254b"
                    },
                    "card": {
                      "type": "object",
                      "properties": {
                        "pan": {
                          "type": "string",
                          "example": "5061800000000000389"
                        },
                        "seqNr": {
                          "type": "string",
                          "example": "001"
                        },
                        "expiryDate": {
                          "type": "string",
                          "example": "2508"
                        },
                        "pinOffset": {
                          "type": "string",
                          "example": "7183"
                        },
                        "cvv": {
                          "type": "string",
                          "example": "902"
                        },
                        "cvv2": {
                          "type": "string",
                          "example": "840"
                        },
                        "pinInfo": {
                          "type": "string",
                          "example": "3DD636885F8CBAA5"
                        },
                        "track2": {
                          "type": "string",
                          "example": "5061800000000000389=2508101007183902"
                        },
                        "customerId": {
                          "type": "string",
                          "example": "20220811144303279780389"
                        }
                      }
                    },
                    "successful": {
                      "type": "boolean",
                      "example": true,
                      "default": true
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"code\": \"10409\",\n    \"description\": \"Account already exists.\",\n    \"correlationId\": \"ff5c14d25d4e4c06aacadcb17f2beea1\",\n    \"successful\": false\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "example": "10409"
                    },
                    "description": {
                      "type": "string",
                      "example": "Account already exists."
                    },
                    "correlationId": {
                      "type": "string",
                      "example": "ff5c14d25d4e4c06aacadcb17f2beea1"
                    },
                    "successful": {
                      "type": "boolean",
                      "example": false,
                      "default": true
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```