---
title: "BLIK charge by alias"
method: POST
path: "/api/v1/paymentMethod/blik/chargeByAlias"
tags: ["BLIK API"]
---

# BLIK charge by alias

`POST /api/v1/paymentMethod/blik/chargeByAlias`

## Request

- Base URL: `https://sandbox.przelewy24.pl`
- URL: `https://sandbox.przelewy24.pl/api/v1/paymentMethod/blik/chargeByAlias`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/przelewy24/apis/przelewy24-rest-api-documentation/docs/api/v1/paymentMethod/blik/chargeByAlias/post.ts> (a function with typed inputs; its response is checked against the schema)

`chargeByAlias` is a one-click payment method. It allows the customer's funds to be charged using a previously obtained alias (`getAliasesByEmail`).

The obtained alias must be passed in the <a href="#tag/Transaction-service-API/operation/registerTransaction"><b>methodRefId</b></a> parameter when registering the transaction.

## Request body

- BlikOneClick
  - `token` string, required: Token obtained when registering the transaction using the <b><a href="#tag/Transaction-service-API/operation/registerTransaction">transaction/register</a></b> request. <br> <br> <b><font color="#DB2053">IMPORTANT!</font></b><br> To charge the payer correctly using blikChargeByAlias, include the <b>PSU</b> object inside the <b>additional</b> object in the <b><a href="#tag/Transaction-service-API/operation/registerTransaction">transaction/register</a></b> request.
  - `type` string, required
  - `aliasValue` string: <b>Note! Sending this parameter will overwrite the existing alias.</b> <br/> A unique user alias that can be used to charge funds during subsequent transactions. <br><br><b><font color="#DB2053">IMPORTANT!</font></b> This parameter is <b>required</b> if the request contains the `recurring` object.
  - `aliasLabel` string: <b>Note! Sending this parameter will overwrite the existing label.</b> <br/> Alias label displayed in the application. <br><br><b><font color="#DB2053">IMPORTANT!</font></b> This parameter is <b>required</b> if the request contains the `recurring` object.
  - `recurring` RecurringParamsIn: Object containing information about a recurring BLIK payment. <div id="note">Recurring payment functionality is not enabled by default. To activate the service, contact Technical Support using the <a href="https://www.przelewy24.pl/centrum-pomocy/wsparcie-techniczne-api/brakuje-odpowiedzi-na-twoje-pytanie"><b>contact form</b></a>.</div>
    - `type` 'M' | 'A' | 'O': Recurring payment type. Allowed values: `A`, `M`, `O`.
    - `expirationDate` string, date-time: Recurring payment expiration date in `YYYY-MM-DDThh:mm:ss` format.
    - `frequency` string: Payment frequency. The value must match the regular expression: `[1-9][0-9]{0,2}[DWMY]`.
    - `totalLimitAmount` integer: Maximum total amount that may be charged during the entire process.
    - `limitAmount` integer: Maximum amount of a single charge.
    - `totalLimitCount` integer: Number of payments to be made during the entire process.
    - `availableBanks` boolean: Parameter indicating whether the bank's support for recurring payments has been checked. A value of `false` means that no such verification was performed.

## Response `201`

Created

- BlikChargeByCodeResponse
  - `data` object
    - `orderId` integer
    - `message` string
  - `responseCode` number

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `409`: Conflict - the alias is ambiguous; the response contains alternative keys.
- `500`: Internal Server Error

## Changes

- **2026-09-03** `5861a691aa36`: 7 breaking, 1 warning, 2 info
  - added the pattern `^[1-9][0-9]{0,2}[DWMY]$` to the request property `recurring/frequency`
  - the `recurring/expirationDate` request property format changed from no format to `date-time`
  - the response's body type changed from no type to `object` for status `201`
  - the response's body type changed from no type to `object` for status `400`
  - …6 more
- **2024-09-18** `e9d9982466d8`: 1 breaking, 4 info
  - removed the enum value `A+` of the request property `recurring/type`
  - the `availableBanks` request property default value `true` was added
  - added `O` discriminator mapping keys to the `recurring` request property
  - removed `A+` discriminator mapping keys from the `recurring` request property
  - …1 more

[Operation history](https://skmtc.dev/przelewy24/apis/przelewy24-rest-api-documentation/changes/api/v1/paymentMethod/blik/chargeByAlias/post.md)

---

[API](https://skmtc.dev/przelewy24/apis/przelewy24-rest-api-documentation.md) - [All operations](https://skmtc.dev/przelewy24/apis/przelewy24-rest-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/przelewy24/apis/przelewy24-rest-api-documentation/revisions/5861a691aa36?raw)