# Utworzenie subskrypcji

Zobacz https://docs.simpay.pl/payment/blik-recurrent po więcej informacji.

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

## Path parameters:

  - `serviceId` (string, required)
    Id usługi

## Request fields (application/json):

  - `transactionId` (string, required)
    Id transakcji

  - `ticket` (object, required)
    Obiekt kodu BLIK
    Example: {"T6":"462755"}

  - `ticket.T6` (string, required)
    6-cyfrowy Kod BLIK
    Example: "462755"

  - `alias` (object, required)
    Informacje o Aliasie BLIK
    Example: {"value":"AAABBCC","type":"PAYID","label":"Płatność za plan premium w serwisie aaa"}

  - `alias.value` (string, required)
    Wartość aliasu (np. ID subskrypcji)
    Example: "AAABBCC"

  - `alias.type` (string, required)
    Typ aliasu (dla subskrypcji - PAYID)
    Enum: "PAYID"

  - `alias.label` (string)
    Etykieta widoczna w aplikacji bankowej płacącego
    Example: "Płatność za plan premium w serwisie aaa"

  - `options` (any, required)

  - `descriptions` (object,null)
    Dodatkowe opisy przekazywane do banku płacącego

  - `descriptions.line1` (string,null)
    Linijka nr 1

  - `descriptions.line2` (string,null)
    Linijka nr 2

  - `descriptions.line3` (string,null)
    Linijka nr 3

## Response 201 fields (application/json):

  - `success` (boolean, required)
    Status zapytania
    Example: true

  - `data` (object, required)
    Example: {"subscriptionId":"019970c6-3d3e-708c-9313-5f89e251e2c0","aliasId":"019970c6-3ce8-71e7-8214-20fd635532fb"}

  - `data.subscriptionId` (string, required)
    Id subskrypcji

  - `data.aliasId` (string, required)
    Id aliasu

## 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_ALREADY_EXISTS"

  - `message` (string, required)
    Error message
    Example: "Selected alias value has been already in our system. You must pass unique alias value, for example subscription id."

## 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."]