Verify card issuance OTP

POST

/cards/issuances/{card_issuance_id}/verify-otp

Last modified:2025-12-02 10:06:51

Verifies the OTP for a card issuance flow. On success, the system proceeds with card creation and PIN setting when applicable.

Error Responses:

400 INVALID_OTP_FORMAT - OTP format is invalid (must be 4 digits)

400 OTP_EXPIRED - OTP has expired. Please initiate a new operation.

400 OTP_MAX_ATTEMPTS_REACHED - Maximum OTP verification attempts reached. Please initiate a new operation.

400 OTP_VERIFICATION_FAILED - OTP verification failed (generic error)

400 OTP_INCORRECT - Invalid OTP provided. Please try again.

404 CARD_ISSUANCE_NOT_FOUND - The card issuance cannot be found

404 OTP_OPERATION_NOT_FOUND - OTP operation context is missing or not found

409 CARD_STATUS_NOT_ALLOWED - Card issuance state transition is not allowed

412 OTP_OPERATION_WRONG_STATUS - OTP operation is not in correct state (already completed or failed)

503 SERVICE_UNAVAILABLE - The service is currently unavailable. Please try again later.

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Default Response

Body

🟠400400

🟠401401

🟠403403

🟠404404

🟠405405

🟠409409

🟠410410

🟠412412

🟠422422

🟠429429

🔴500500

🔴501501

🔴503503

🔴504504

🔴505505

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/cards/issuances//verify-otp' \
--header 'Content-Type: application/json' \
--data-raw '{
    "otp": "1234"
}'

Response Example

200 - example1

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:35:00Z",
    "account_id": "b2c3d4e5-f6a7-5890-b123-c4d5e6f7a8b9",
    "account_number": "ACC-2024-00123",
    "customer_id": "c3d4e5f6-a7b8-9012-c345-d6e7f8a9b0c1",
    "status": "ISSUED",
    "idempotency_key": "f9e8d7c6-b5a4-3210-9876-543210fedcba",
    "card": {
        "id": "f5a4b3c2-d1e0-9876-5432-1a0b9c8d7e6f",
        "account_id": "b2c3d4e5-f6a7-5890-b123-c4d5e6f7a8b9",
        "token": 987654321,
        "status": "ACTIVE",
        "last_4_digits": "1234",
        "expiry_date": "2027-12-31",
        "design": "standard",
        "created_at": "2024-01-15T10:35:00Z",
        "updated_at": "2024-01-15T10:35:00Z"
    }
}

Modified at 2025-12-02 10:06:51

Complete card issuance

Convert virtual to physical