API Reference
  1. Treasury Solutions
  2. Card Issuance

Issue a new card

post
https://sandbox-api.prioritycommerce.com/v1/passport/v1/customer///issuance/card

Issue a Debit or Prepaid card for a customer with flexible delivery options. Cards can only be issued to an account in ACTIVE status.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required

Identifier type for the customer. Use id for the Passport-assigned reference ID or externalId for the program manager-assigned identifier.

Allowed:
int64
required

The customer identifier value corresponding to the selected parent identifier type.

Body Params

Request body for issuing a new card. Provide cardholder details, card configuration, and delivery method.

string
enum

Defines the funding model of the card. DEBIT cards are linked to an account balance. PREPAID cards are pre-funded and supported only for business customers.

Allowed:
cardholder
object

Cardholder details. Required for business customers to specify whether the cardholder is an Authorized User or Beneficial Owner.

cardProgram
object

Card program under which the card will be issued. If not provided, the system uses the default program configured for your account. Retrieve available programs using POST /issuance/cardProgram/list.

string
enum

Required only for digital-first card programs. DIGITAL issues a virtual card first (physical can be requested later). DIGITAL_AND_PHYSICAL issues both virtual and physical cards together.

Allowed:
shippingDetail
object

Shipping details for physical card delivery. Provide either an existing address.id or inline address fields. Inline address is only supported for PREPAID cards.

account
object

Account to link to the card. Required for DEBIT cards.

string

Program manager-assigned external identifier for the card.

int64

Passport-assigned identifier of the account to link.

string

Program manager-assigned external identifier of the account to link.

entity
object
string

Additional text to emboss on the physical card.

Responses

400

The request could not be accepted by the Passport server due to a malformed syntax, which may be a missing required parameter or other syntactical error.

401

The request lacks valid authentication credentials. Verify the API key and authorization header.

500

An unexpected error occurred on the Passport server while processing the request.

Updated 7 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 7 days ago

Did this page help you?