DOCS
The process of purchasing on installments typically involves the following steps:
| MCC Code | Code Name |
|---|---|
| 1041 | Production of oils and other liquid fats |
| 1101 | Distilling, rectifying, and blending of alcohols |
| 2446 | Manufacturing of nuclear fuels |
| 2540 | Manufacturing of weapons and ammunition |
| 4612 | Activities of agents engaged in the sale of fuels, ores, metals, and industrial chemicals |
| 4671 | Wholesale sale of fuels and related products |
| 4672 | Wholesale sale of metals and metal ores |
| 4677 | Wholesale sale of waste and scrap |
| 9200 | Activities related to games of chance and mutual betting |
| 9491 | Activities of religious organizations |
| 9492 | Activities of political organizations |
| 9405 | Organizations and associations |
Process installment payments by using the transaction creation endpoint and providing the appropriate payment channel identifier.
| Payment Channel Name | ChannelId - identifier |
|---|---|
| Raty Pekao 1% | 77 |
| Raty Pekao 3 x 0% | 78 |
| Raty Pekao do 10 x 0 | 80 |
| Raty Pekao 0,7% | 81 |
| Alior Raty | 49 |
| PragmaPay Installment for business | 86 |
To create a BNPL transaction, send a POST request to the endpoint:
https://api.tpay.com/transactions
Check the details in the API Reference documentation: POST /transactions
In the request, specify the following parameters:
amount * | Transaction amount. |
description * | Transaction description visible to the payer. |
payer.email | Payer's email address. |
payer.name | Payer's full name. |
pay.channelId | Installment payment channel identifier. |
* Fields required.
The basic request body should look like this:
{ "amount": 0.1, "description": "Testowa transakcja ratalna", "payer": { "email": "[email protected]", "name": "Jan Nowak" }, "pay": { "channelId": 77 } }
Example:
curl --location 'https://api.tpay.com/transactions' \ --header 'Authorization: Bearer <access_token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount": 0.1, "description": "Testowa transakcja ratalna", "payer": { "email": "[email protected]", "name": "Jan Nowak" }, "pay": { "channelId": 77 } }'
After sending the request, you will receive a TransactionCreated schema in response.
The key response parameters are:
result | success - The transaction was successfully created. |
status | pending - The transaction is awaiting payment. |
transactionPaymentUrl | URL to which the payer should be redirected. |
Example response:
{ "result": "success", "requestId": "786dee7ec39502226238", "transactionId": "01K5BK4HEPB0WBCGT51FMTYSYJ", "title": "TR-CWM-D14339X", "posId": "ps_e4dkPVDEm4Jg726q", "status": "pending", "date": { "creation": "2024-07-04 21:15:23", "realization": null }, "amount": 0.1, "currency": "PLN", "description": "Testowa transakcja ratalna", "hiddenDescription": "", "payer": { "payerId": "py_a9rjlZWxRLdG1bqY", "email": "[email protected]", "name": "Jan Nowak", "phone": "", "address": "", "city": "", "country": "PL", "postalCode": "" }, "payments": { "status": "pending", "method": "pay_by_link", "amountPaid": 0, "date": { "realization": null } }, "transactionPaymentUrl": "https://secure.tpay.com/?title=TR-CWM-D14339X&uid=01J1ZJREPKDXXJ5E4JRWYVXMN2" }
Redirect the payer to the URL provided in the response in the transactionPaymentUrl field.
At the given URL, the payer will be redirected to the installment application, where they complete the required information and submit the application.
We will inform you about the transaction status via notification after transaction posting.
You can place the Installment Calculator from Pekao Bank on your website anywhere you like (e.g., on the product page).
This allows customers to calculate the number and/or amount of installments by themselves.
To display the installment calculator, copy the source code below and place it in the selected location.
Pekao Installment Calculator 1%:
Pekao Installment Calculator 3 x 0%:
Pekao Installment Calculator 0.7%:
Pekao Installment Calculator 10 x 0%:
The Pekao installment calculator can be set to show the proposed price divided into installments on product pages - find out how to do it
You can also use banners with the text Check the Installment or Calculate Installment - embed them on the site in such a way that clicking on them will display the calculator. Download banners..
You can place the Alior Installment Calculator on your website anywhere you like (e.g., on the product page).
This allows customers to calculate the number and/or amount of installments by themselves.
To display the installment calculator, copy the source code below and place it in the selected location.