Create a card

Create a card under a specified card program and affiliated with a Funding Source. Returns an ID with which to retrieve card details.

application/json

Request Body required

• cardProgramId string required

  ID of card program to use when creating a card

• fundingSourceId string required

  ID of the Funding Source the card will authorize against

Responses

• 200
• 400
• 403

---

Successful operation

application/json

• Schema
• Example (from schema)

---

Schema

• cardId string

  The created card ID

{
  "cardId": "string"
}

Request fields are invalid

application/json

• Schema
• Example (from schema)

---

Schema

• statusCode integer required
• statusName string required
• errorCode string required
• errors string[]

{
  "statusCode": 400,
  "statusName": "Bad Request",
  "errorCode": "BAD_REQUEST",
  "errors": [
    "Expected string, received number"
  ]
}

User is not allowed to perform the action with the reason stated in the message

FORBIDDEN Insufficient permissions to perform the action.

LIVENESS_MISMATCH Card program or cardholder have the wrong liveness for the request.

CARD_PROGRAM_INVALID Card program does not belong to a partner this cardholder is associated with.

FUNDING_SOURCE_INVALID Funding source cannot be used with this card program.

KYC_REQUIRED KYC profile is missing, does not have PASSED status, or does not match card program region. Use the spending prerequisites endpoint for more details.

CONTACT_EMAIL_REQUIRED Cardholder does not have a contact phone.

CONTACT_PHONE_REQUIRED Cardholder does not have a contact email.

AML_CHECK_FAILED AML check failed.

application/json

• Schema
• Example (from schema)

---

Schema

• statusCode integer required
• statusName string required
• errorCode string required
• reason string

{
  "statusCode": 403,
  "statusName": "Forbidden",
  "errorCode": "FORBIDDEN",
  "reason": "Unauthorized"
}

Loading...