API Reference
Go to zen.comGo to myZEN.com
Documentation
  • Plugin integration
  • Checkout integration
  • API business
  • Merchant panel
Brandbook
Go to zen.comGo to myZEN.com
Documentation
  • Plugin integration
  • Checkout integration
  • API business
  • Merchant panel
Brandbook
  1. payment-links
  • Introduction
  • Authentication & authorization
  • Environments
  • Transaction statuses
  • Notifications
  • Response codes
  • Error codes
  • purchase
    • Create transaction
    • Capture transaction
    • Transaction details using ZEN id
    • Transaction details using merchantTransactionId
    • Cancel transaction
    • Renew authorization
    • Validate ApplePay session
    • Calculate cashback
  • refund
    • Create transaction
  • payout
    • Create transaction
    • Transaction details using ZEN id
    • Transaction details using merchantTransactionId
    • Capture transaction
    • Cancel transaction
    • Renew transaction
    • Transaction details using ZEN id
    • Refresh transaction offers
    • Select transaction offer
  • payment-methods
    • Returns information about payment methods
    • Returns information about payment methods
  • payment-links
    • Create payment link
      POST
    • Fetch payment links list
      GET
    • Fetch payment link
      GET
    • Update payment link
      PATCH
  • customers
    • Create customer
    • Remove customer
    • Add customer recipient
    • Add payout card
    • Remove payout card
    • Fetch payout card list
    • Update payout card details
    • Fetch saved subscription customer list V3
    • Fetch customer
    • Update a customer
    • Fetch card
    • Update card details
    • Remove card
    • Fetch card list
    • Fetch customer recipient list
    • Fetch customer recipient
    • Update customer details recipient
    • Remove customer recipient
    • Fetch saved merchant customer payout recipient list V3
    • Verify merchant's customer payout recipient card
    • Fetch saved merchant customer's payout card V3
    • Initialize widget payout card process
    • Update merchant payout card alias
    • Fetch saved payout card list V3
    • Removes merchant customer payout card.
    • Add customer payout card
    • Fetch saved payout card V3
    • Removes customer saved payout card V3
    • Add paynow recipient
    • Remove paynow profile
  • authorization
    • Calculate authorization amount
    • Calculate reversed authorization amount
  • subscriptions
    • Fetch subscription products list
    • Add new subscription product
    • Fetch subscription product
    • Update subscription product
    • Removes subscription product
    • Fetch subscription plan list
    • Add new subscription plan
    • Fetch subscription plan
    • Removes subscription plan
    • Activate subscription plan
    • Deactivate subscription plan
    • Fetch subscriptions list
    • Fetch subscription
    • Removes subscription
    • Cancel subscription
  • reports
    • Download report file
  1. payment-links

Fetch payment link

GET
https://api.zen.com/v1/payment-links/{id}
payment-links
Fetch one specific payment link, that allows to initiate the payment process.

Request

Path Params
id
string <uuid>
required
An unique identifier
Example:
3fa85f64-5717-4562-b3fc-2c963f66afa6
Header Params
request-id
string 
required
A unique identifier generated by requesting client
>= 38 characters<= 1024 characters
Example:
|us04oqdnzFQVr0rITD9/c9OvDRE2sXVfwerv.
Match pattern:
^[a-zA-Z0-9?&:_|\-\/=+.,#\s]+$

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.zen.com/v1/payment-links/' \
--header 'request-id;'

Responses

🟢200OK
application/json
OK
Body
id
string <uuid>
optional
url
string <uri>
optional
amount
object 
optional
currency
string 
optional
value
number 
optional
customer
object 
optional
firstName
string 
optional
lastName
string 
optional
email
string 
optional
items
array [object {3}] 
optional
name
string 
optional
price
number 
optional
quantity
number 
optional
merchant
object 
optional
uuid
string 
optional
shopUuid
string 
optional
terminalUuid
string 
optional
transactionId
string 
optional
terminalId
string 
optional
expirationDate
string <date-time>
optional
status
string 
optional
createdAt
string 
optional
hidden
boolean 
optional
Example
{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "url": "http://example.com",
    "amount": {
        "currency": "string",
        "value": 0
    },
    "customer": {
        "firstName": "string",
        "lastName": "string",
        "email": "string"
    },
    "items": [
        {
            "name": "string",
            "price": 0,
            "quantity": 0
        }
    ],
    "merchant": {
        "uuid": "string",
        "shopUuid": "string",
        "terminalUuid": "string",
        "transactionId": "string",
        "terminalId": "string"
    },
    "expirationDate": "2019-08-24T14:15:22Z",
    "status": "string",
    "createdAt": "string",
    "hidden": true
}
🟠404Record Not Found
Modified at 2025-07-10 11:28:41
Previous
Fetch payment links list
Next
Update payment link