ZEN API documentation
Go to zen.comGo to myZEN.com
Documentation
  • Sandbox
  • Plugin integration
  • Checkout integration
  • API reference
  • API transfers
  • Merchant panel
  • Brandbook
Go to zen.comGo to myZEN.com
Documentation
  • Sandbox
  • Plugin integration
  • Checkout integration
  • API reference
  • API transfers
  • Merchant panel
  • Brandbook
  1. Integration
  • About ZEN
    • First steps with ZEN
    • Who we are
    • What we provide
    • How we provide
  • Introduction
    • Definitions
    • About API integration
    • Revenue strams
    • Environments
    • Authorization & Authentication
    • Payment methods
    • Payment process
    • Currencies
    • Languages
  • Account registration & configuration
    • Before you begin
    • Registration
    • Configuration
    • Merchant's panel
    • Payments setup
    • Locating Transactions in my.zen.com
    • Finding settlements
  • Features
    • Available features
    • 3-Domain Secure (3DS)
    • Account Funding Transactions (AFT)
    • Address Verification Service
    • Authorization fee
    • Card widget
    • Cashback
    • Currency Conversion Service
    • Fraud collector (fingerPrintId)
    • Instant Payment Notification (IPN)
    • Payment Link
    • Shop logo on ZEN.COM checkout
    • Reports
  • Integration
    • Response codes
    • Error codes
    • Prepare the communication
    • Available Payment methods
    • Purchase Transaction
    • Refund Transaction
    • Payout Transaction
    • Transaction status check
    • Saving and tokenizing cards
    • Customers and cards management
    • One-click Payments
      • One-click Blik Payments
      • One-click card Payments
      • One-click Apple Pay Payments
      • One-click Google Pay Payments
    • Recurring Payments
      • Blik recurring Payments
  1. Integration

Purchase Transaction

integration code.jpg
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.
To create the purchase Transaction:
One time card Transaction example
Google Pay Transaction example
Blik Transaction example
Pay-by-link (PBL) Transaction example
PayPo Poland Transaction example
PayPo Romania Transaction example
Modified at 2025-11-04 13:35:01
Previous
Available Payment methods
Next
Refund Transaction