terminalUuid | string | Yes | Your individual Terminal's UUID |
amount | number | Yes | Amount of the transaction. |
currency | string 3 characters | Yes | Currency in ISO 4217 alphabetic code of the transaction (it will determine payment methods displayed on the paywall). Must be written in all capital letters. |
merchantTransactionId | string [ 1 .. 128 ] characters ^[a-zA-Z0-9?&:-/=.,#]+$ | Yes | Merchant’s unique identifier of the transaction. No two requests sent by merchant can have same value in this field. Otherwise, the transactions with duplicate number will be immediately rejected by ZEN. |
signature | Parameter used for message authentication and it is calculated based on the concatenation of fields | Yes | Signature of the post |
originMerchantTransactionId | string < = 128 characters | No | Origin Merchant Transaction ID used by Merchant to gather more than one unique merchantTransactionId's Example: 23beb187-f8a3-44b8-9ef8-b31180358dd3 |
customer.id | string < = 128 characters | No | Customer Id in Merchant's system |
customer.firstName | string < = 128 characters | No | First name of the Customer |
customer.lastName | string < = 128 characters | No | Last name of the Customer |
customer.email | string < = 256 characters | No | Email address of the Customer |
customer.phone | string < = 64 characters match pattern: ^[0-9+]+$ | No | Customer's phone number |
items.code | string < = 64 characters | No | Merchant’s code for the sold item |
items.category | string < = 64 characters | No | Merchant’s category for the sold item |
items.name | string < = 128 characters | No | Name of the sold item |
items.price | string^-?(?=.* [1-9])\d{1,16}(?:.\d{1,12})?$ | No | Unit price of the sold item |
items.quantity | number | No | Quantity of the sold items |
items.lineAmountTotal | number | No | Total price of the sold items |
shippingAddress.id | string < = 64 characters ^[a-zA-Z0-9_-]+$ | No | This is ID of the merchant’s customer provided by merchant |
shippingAddress.firstName | string < = 128 characters | No | First name of the Customer |
shippingAddress.lastName | string < = 128 characters | No | Last name of the Customer |
shippingAddress.country | string 2 characters ^[A-Z]+$ | No | Country of the Customer |
shippingAddress.city | string 128 characters ^[A-Z]+$ | No | Country of the Customer |
shippingAddress.buildingNumber | string < = 128 characters | No | Building number of the Customer |
shippingAddress.roomNumber | string < = 32 characters | No | Room number of the Customer |
billingAddress.street | string < = 128 characters | No | Street of the Customer |
billingAddress.city | string < = 128 characters | No | City of the Customer |
billingAddress.countryState | string < = 128 characters | No | Country of the Customer |
billingAddress.province | string < = 128 characters | No | Province of the Customer |
billingAddress.buildingNumber | string < = 128 characters | No | Building number of the Customer |
billingAddress.roomNumber | string < = 32 characters | No | Room number of the Customer |
billingAddress.postcode | string [ 5 .. 6 ] characters | No | Postcode of the Customer |
billingAddress.companyName | string < = 128 characters | No | Company name of the Customer |
billingAddress.phone | string [ 2 .. 64 ] characters ^[0-9+]+$ | No | Phone of the Customer |
billingAddress.taxId | string < = 128 characters | No | Tax Id of the Customer |
urlRedirect | string < = 256 characters url | No | URL for redirection after transaction. Used if „urlSuccess” and „urlFailure” were not specified |
urlSuccess | string < = 256 characters url | No | URL for redirection after successful Transaction |
urlFailure | string < = 256 characters url | No | URL for redirection after failure Transaction |
customIpnUrl | string < = 256 characters url | No | URL address used by ZEN to send IPN to |
specifiedPaymentMethod | string | No | Code to limit checkout to one payment method. Check limiting checkout for more information |
specifiedPaymentChannel | string | No | Code to limit checkout to one payment channel. Check limiting checkout for more information |
comment | string < = 512 characters | No | Any Merchant comment associated with the Transaction |