Activate a card

POST 
/v1/cards/:cardId/activate

Activates a card. Cards must be activated before they can be used for transactions.

This endpoint is idempotent and will return success if the card is already active.

Request

Path Parameters

cardId stringrequired

The UUID of the card to activate

Responses

201

The card was successfully activated.

application/json

Schema

Schema

traceId string
message string

data

object

id stringrequired

Card UUID

referenceNumber stringrequired

Card reference number

status stringrequired

Possible values: [ACTIVE, BLOCKED, SUSPENDED, CANCELLED]

Current card status

success booleanrequired

Activation success status

message stringrequired

Human-readable message

transactionId string

Transaction ID for traceability

Example (from schema)

{
  "traceId": "string",
  "message": "string",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "referenceNumber": "REF123456789",
    "status": "ACTIVE",
    "success": true,
    "message": "Card successfully activated",
    "transactionId": "TXN987654321"
  }
}

400

Invalid request payload. This can happen if required fields are missing or have invalid formats.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

403

The API key is invalid or the client does not have sufficient permissions.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

404

One of the specified resources was not found. Does not apply for empty result set.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

Loading...