Complete card issuance

POST

https://api.staging.vrtx.sa/cards/issuances/{card_issuance_id}/complete

Last modified:2025-12-03 10:51:05

Finalises a card issuance after voice authentication has completed.
Provide whether the voice authentication succeeded to advance or fail the issuance workflow.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

example1example2

{
    "is_voice_auth_successful": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

example1example2

curl --location --request POST 'https://api.staging.vrtx.sa/cards/issuances//complete' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "is_voice_auth_successful": true
}'

Responses

🟢200OK

application/json

Default Response

Body

Examples

example1example2

{
    "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"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠405Method Not Allowed

🟠409Conflict

🟠410Gone

🟠412Precondition Failed

🟠422Unprocessable Entity

🟠429Too Many Requests

🔴500Internal Server Error

🔴501Not Implemented

🔴503Service Unavailable

🔴504Gateway Timeout

🔴505HTTP Version Not Supported

Modified at 2025-12-03 10:51:05

Get card issuance

Verify card issuance OTP