Issue new card

Issues a new card for the user.

Endpoint

POST /issue

Request

circle-info

Content-Type: application/json

Request body

Request (application/json)
{
  "productCode": "B0067bd6bf2b2604be25e9821b0",
  "request_id": "request-id-12345",
  "amount": 25,
  "currency": "USD",
  "cardValidityYears": 3,
  "preferredAccount": "string",
  "cardName": "My New Card",
  "firstName": "Jimmy",
  "lastName": "Taylor"
}

Request parameters

  • *productCode (string) — Product code used to identify the card type

  • *request_id (string, 12 – 36 characters) — Unique identifier for the request

  • *amount (decimal) — Initial balance of the card

  • *currency (string) — Currency code (must correspond to the product code currency)

  • cardValidityYears (number, 1 – 4) — Card expiration period in years

  • preferredAccount (string) — Preferred account for debiting

  • cardName (string, max 32 characters) — Personalized card name

  • firstName (string) — Card-specific field

  • lastName (string) — Card-specific field

Currency enum list

  • USD

  • EUR

Response

Response parameters

  • type (string, ISSUE) — Type of operation

  • status (string) — Current state of the operation

  • docid (number) — Operation tracking document ID

  • request_id (string) — Request identifier provided in the request

Status enum list

  • INPROCESS

  • EXECUTED

  • DECLINED

Last updated