# Providing BLIK code for Level 0 transaction

See https://docs.simpay.pl/payment/blik-level0 for more information.

Endpoint: POST /payment/{serviceId}/blik/level0/{transactionId}
Version: 1.0.0
Security: bearerAuth

## Path parameters:

  - `serviceId` (string, required)
    Service ID

  - `transactionId` (string, required)
    Transaction ID

## Response 400 fields (application/json):

  - `success` (boolean, required)
    Request status

  - `errorCode` (string, required)
    Error status code
    Example: "INVALID_BLIK_CODE"

  - `message` (string, required)
    Error message
    Example: "Invalid BLIK code."

## Response 401 fields (application/json):

  - `success` (boolean, required)
    Request status

  - `errorCode` (string, required)
    Error status code
    Enum: "UNAUTHORIZED"

## Response 403 fields (application/json):

  - `success` (boolean, required)
    Request status

  - `errorCode` (string, required)
    Error status code
    Enum: "INVALID_ABILITY_PROVIDED", "IP_ADDRESS_NOT_WHITELISTED"

## Response 404 fields (application/json):

  - `success` (boolean, required)
    Request status

  - `errorCode` (string, required)
    Error status code
    Enum: "SERVICE_NOT_FOUND", "TRANSACTION_NOT_FOUND", "ROUTE_NOT_FOUND"

## Response 409 fields (application/json):

  - `success` (boolean, required)
    Request status

  - `errorCode` (string, required)
    Error status code
    Example: "ALIAS_NOT_UNIQUE"

  - `message` (string, required)
    Error message
    Example: "Alias is not unique. Select interested alias by providing alias.blik_id alongside with alias.value and alias.type."

  - `data` (object, required)
    Example: {"alternatives":[{"value":"SIMSIM","type":"UID","label":"TEST APP 222","blik_id":953824},{"value":"SIMSIM","type":"UID","label":"TEST APP 111","blik_id":953793}]}

  - `data.alternatives` (array, required)
    Example: [{"value":"SIMSIM","type":"UID","label":"TEST APP 222","blik_id":953824},{"value":"SIMSIM","type":"UID","label":"TEST APP 111","blik_id":953793}]

  - `data.alternatives.value` (string, required)
    Alias value

  - `data.alternatives.type` (string, required)
    Alias type

  - `data.alternatives.label` (string, required)
    Alias label

  - `data.alternatives.blik_id` (integer, required)
    Alias identifier in the BLIK system

## Response 422 fields (application/json):

  - `success` (boolean, required)
    Request status

  - `errorCode` (string, required)
    Error status code
    Enum: "VALIDATION_ERROR"

  - `errors` (object, required)
    Example: {"amount":["The amount field is required."],"currency":["The selected currency is invalid."]}

  - `errors.amount` (array)
    Example: ["The amount field is required."]

## Response 429 fields (application/json):

  - `success` (boolean, required)
    Request status

  - `errorCode` (string, required)
    Error status code
    Example: "TOO_MANY_FAILED_ATTEMPTS"

  - `message` (string, required)
    Error message
    Example: "Too many failed attempts with providing BLIK ticket for this user."

  - `data` (object, required)
    Example: {"retryAfter":17}

  - `data.retryAfter` (integer)
    Next attempt available in seconds (for this payer)
    Example: 17


## Response 204 fields