Changelog

Koshelek Pay API

Documentation has moved

The information on this page is no longer updated and may be obsolete. The most current Koshelek documentation is now available at the new address:

https://developers.koshelek.app/en/

v1.2.1 (2023.02.14)

Invoice

• Parameter taxAmount is no longer mandatory.

v1.2.0 (2022.10.26)

Request list of available payment methods

• Asynchronous processing for this request (HTTP response code: 201) is no longer used for new integrations (deprecated).

Get available payment methods

• The request is no longer used for new integrations (deprecated).

v1.1.0 (2022.04.28)

Item

• Added parameters measure, currency.

Slip

• Added parameter currency.

• Parameter operationId: updated description (parameter value is assigned by payment provider upon return.)

CheckoutInvoice

• Added parameter currency.

Invoice

• Added parameter currency.

Refund payment

• Request body: added parameter currency.

v1.0.0 (2022.02.21)

API connection

• Added merchant identifiers: legalId, paymentPurpose, subscriptionPurpose.

• Added more details to other FPS identifiers.

Request status

• Response body: field errorCode now includes additional values: EXTERNAL_PROVIDER_ERROR, SUBSCRIPTION_IS_NOT_FOUND, PAYMENT_DECLINED_BY_EXTERNAL_PROVIDER.

Refund payment

• Response body: field errorCode now includes additional value: PAYMENT_ORDER_IS_NOT_FOUND.

Slip

• Added parameter kzo.

PaymentMethod

• Added parameter paymentPurpose.

v0.9.0 (2022.02.11)

From this version onwards, Pay API supports payment providers "SBP" and "Dolyame".

Slip

• Parameter paymentType now includes additional value: DOLYAME.

PaymentMethod

• Parameter type now includes additional value: DOLYAME.

v0.8.0 (2022.01.27)

Slip

• Parameter transactionId renamed to: paymentTransactionId.

• Added parameter refundTransactionId.

v0.7.0 (2022.01.24)

Slip

• Added parameter id.

• Removed parameters terminalKey, sourceId, commission.

• Parameter dateTime renamed to: operationDateTime.

• Parameter operationDateTime: updated date format.

Request status

• Response body: added parameter errorCode.

Refund payment

• Response body: added parameter errorCode.

v0.6.0 (2021.12.27)

Refund payment scenario

• Alternative refund scenarios and possible errors added.

API Requests

• Description of requestId parameter extended.

v0.5.0 (2021.12.23)

Invoice

• Fields taxation, kktRegNumber, fnNumber, fpd, fdNumber, website and qr are marked as optional.

v0.4.0 (2021.12.08)

Refund payment

• Request body: removed parameter refundId.

v0.3.0 (2021.11.29)

Refund payment

• Request body: added parameter refundId.

v0.2.0 (2021.11.25)

Request status

• Added timing rules.

v0.1.0 (2021.11.17)

API connection

• Added new merchant identifiers: Stores, Terminals.

Request list of available payment methods

• Request body: added parameters terminalId, storeId.

• Request body: removed parameter terminalKey.

Checkout

• Request body: added parameters terminalId, storeId.

• Request body: removed parameter terminalKey.

Send payment receipt

• Request body: added parameters terminalId, storeId.

• Request body: removed parameter terminalKey.

Cancel payment

• Request body: added parameters terminalId, storeId.

• Request body: removed parameter terminalKey.

Refund payment

• Request body: added parameters terminalId, storeId.

• Request body: added array items.

• Request body: removed parameter terminalKey.

Item

• Added parameter article.

Slip

• Added parameters terminalId, storeId.

• Removed parameter terminalKey.