Skip to content

Card Issuance

Card issuance method.

URL

Method: POST

  • Production: https://api.baas.kvell.group/v1/issue-card/applications/{application_id}/issue
  • Stage: https://api.baas.stage.kvell.group/v1/issue-card/applications/{application_id}/issue

Request parameters

Name
 Data type Required Description
application_id string Yes The application ID received when creating the card issuance application

Request headers

Name Data type Required Description
X-Api-Key string Yes Unique shop identifier
X-Signature string Yes Signature

The X-Signature signature is formed by concatenating X-Api-Key, application_id, and secret_key. A sha256 hash is computed from the resulting string:

sha256({x-api-key}{application_id}{secret_key})

where secret_key is the secret key found in the merchant's shop settings.

Response

Example response

{
    "id": "11",
    "created": "value",
    "status": "success",
    "auth_code": "value",
    "remote_id": "value",
    "response_code": null,
    "error_message": null,
    "card_mask": "value",
    "card_expire": "value",
    "application": {
        "id": "value",
        "created": "value",
        "status": "success",
        "request_id": "value",
        "remote_id": null,
        "error_message": null,
        "additional_data": {
            // request body
        }
    }
}

{
    "id": "11",
    "created": "value",
    "status": "declined",
    "auth_code": null,
    "remote_id": "value",
    "response_code": "value",
    "error_message": "Issuance declined.",
    "card_mask": null,
    "card_expire": null,
    "application": {
        // request body
    } 
}

{ 
    "errors": [
        {
            "code": "value",
            "message": "Application has wrong state: declined"
        }
    ]
}

Response parameters

Name Type Description
id string Card issuance identifier
created string Card issuance creation date (UTC)
status string Card issuance status
remote_id string Identifier on the provider's side
error_message string Error message
auth_code string Authorization code
response_code string Error code
card_mask string Masked card number
card_expire string Card expiration date
application json JSON object with application information
  • status — card issuance status:
    • new — card issuance created
    • success — the card was issued successfully
    • declined — card issuance declined, issuance refused