Purchase Transaction - ZEN API documentation

The Merchant's Shop, when initiating a purchase Transaction, sends the mandatory and optional parameters to the ZEN.COM Payment system in request to process the Transaction and then return the Payment status in response.

As part of the purchase Transaction, the following actions are possible:
Create Transaction
Capture Transaction
Cancel Transaction
Renew Transaction
Validate ApplePay session
Calculate cashback
Get Transaction details (with ZEN.COM's id)
Get Transaction details (with Merchant's id)

Please note that all requests should be sent using the POST method, except for retrieving Transaction details, which should be sent using the GET method.

For some Transaction types, such as card Transactions, in addition to creating the Transaction, a capture is also required. In such cases, the request should first be sent to the https://docs.zen.com/payments/api-reference/create-purchase-transaction endpoint, followed by a request to the https://docs.zen.com/payments/api-reference/capture-purchase-transaction endpoint.

INFO

All available endpoints can be found in API Reference documentation.

CAUTION

The Transaction flow varies depending on the selected Payment method / Payment channel. Some methods / channels may require redirection to an external service (e.g., bank Transaction authorization). For this reason, it is essential for the Merchant to fully handle the responses sent by ZEN.COM and ensure appropriate reactions to the sent communication.

Please note that each Payment channel requires a specific value to be provided in the paymentSpecificData object. Please find a list of all Payment channels below supported by ZEN.COM, along with the value that must be specified in the paymentSpecificData.type parameter to correctly initiate a Transaction for the selected Payment method. Depending on the type parameter, additional parameters may also be required. Please refer to the API Reference documentation for the required parameters.

Buy now, pay later

Card payments

Cryptocurrencies

Digital wallets

Instant Bank Transfers

Local Payment Methods

Prepaid

ZEN.COM Pay

Below you will find example requests for the most popular payment methods, along with the corresponding responses returned by the ZEN.COM API (happy flow).

To create the purchase Transaction:

One time card Transaction example

Google Pay Transaction example

Blik Transaction example

Instant bank transfer (PME_BANK_TRANSFER) Transaction example

Klarna Transaction example

Pay-by-link (PBL) Transaction example

PayPo Poland Transaction example

PayPo Romania Transaction example