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
    • 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
      • Fetch payment links list
      • Fetch payment link
      • Update payment link
    • 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

    Error codes

    Introduction to integration [Bright].png
    ZEN.COM uses IPN's (Instant Payment Notification) to comunicate with your service about possible errors occur during the payment process. Instant Payment Notification inform you about transaction status updates, e.g., about changing the status from pending to rejected. Below you will find full error list code:
    NameDescription
    E00001Creating new transaction in payment service provider failed.
    E00002Transaction was expired on the payment service provider side.
    E00003Creating refund transaction in payment service provider failed.
    E00004Transaction was rejected by payment service provider.
    E00005Checking status of transaction limit was exceeded.
    E00006Refund attempts limit was exceeded.
    E00007Capturing transaction in payment service provider failed.
    E00008Customer belongs to forbidden country.
    E00011Transaction was declined by psp
    E40001Transaction already exists
    E40002Reporting criteria unavailable
    E40003Reporting criteria is inactive
    E40004MID is inactive
    E40005Amount must be greater than 0
    E40006The amount exceeds the maximum permitted amount
    E40007Currency invalid
    E40008Currency invalid
    E40009Transaction in a wrong status for this action
    E40010Debit attempt after expiry of time window
    E40011Transaction does not exist
    E40012Authentication failed
    E40013General technical error
    E40014My paysafecard account not found by provided credentials
    E40015Customer account details do not match
    E40016The merchant does not have access to this function
    E40017The IP address of the merchant has not been added to IP-whitelist
    E40018The Amount specified in the call is invalid. The amount must be: 0 with 2 decimals
    E40019The signature in the call could not be verified using the merchant’s public key
    E40020The MessageID sent in the deposit has been used before
    E40021The enduser that initiated the payment is blocked
    E40022The Locale-attribute is sent with an incorrect value
    E40023This uuid has been used before
    E40024The EndUserID or MessageID sent in the request is null
    E40025The IP attribute sent is invalid. Only one IP address can be sent
    E40026The SuccessURL, FailURL, TemplateURL or NotificationURL sent in the request is malformed. Use valid http(s) address
    E40027The URLTarget, MessageID or EndUserID sent in the request is malformed
    E40028The merchant does not have enough balance on his/her account to execute the refund
    E40029The refund has already been processed
    E40030Some value or parameter in the refund call does not match the expected format
    E40031The refund call was sent before the money for the original deposit was settled
    E40032The OrderID sent in the refund call does not exist
    E40033Several refunds have been made on a single deposit, and the amount in the last refund was larger then the amount that is left to refund on that deposit
    E40034The refund call was sent before the money for the original deposit was settled or captured
    E40035The OrderID sent in the refund call is null
    E40036NotificationURL is not secured
    E40037Provided market does not exists
    E40038Provided store is inactive
    E40039SourceCurrency parameter must be set
    E40040DestinationCurrency parameter must be set
    E40041Payment address is invalid
    E40042Withdrawal is not allowed
    E40043Operation was already finished
    E40044Withdrawal amount is smaller than fee
    E40045Fetching currencies error
    E40046Provided url is invalid
    E40047Invalid parameter was provided
    E40049Customs declaration has already been registered
    E40050The declared amount exceeds the transaction amount
    E40051Missing parameter
    E40052Cannot get express payment method
    E40053Express payment method unavailable
    E40054Unable to fetch user
    E40055Invalid request
    E40056Invalid XML
    E40057Service temporarily unavailable due to maintenance
    E40058Specified method is not supported
    E40059No method specified
    E40060No request received
    E40061Internal error
    E40062The agent is not correct
    E40063The amount is not correct
    E40064Dynamic description (Depending on the payment method) Ex. The amount must be higher than 1
    E40065The amount must be lower than 999999
    E40066The city is not correct
    E40067The country is not correct
    E40068The currency is not correct
    E40069The date of the document is not correct
    E40070The date of birth is not correct
    E40071The email is not correct
    E40072The first name is not correct
    E40073The gender is not correct
    E40074The hash is not correct
    E40075The ip address is not correct
    E40076Your ip address is blocked temporarily
    E40077The KYC is not correct
    E40078The last name is not correct
    E40079The latitude is not correct
    E40080The longitude is not correct
    E40081The merchantId is not correct
    E40082The merchantTransactionId is not correct
    E40083The prohibitedForMinors parameter is not correct
    E40084The street is not correct
    E40085The subMerchantId is not correct
    E40086The telephone number is not correct
    E40087The test parameter is not correct
    E40088The zip code is not correct
    E40089The merchantId do not exist or is not active
    E40090The verion is not correct
    E40091The merchantTransactionId already exists
    E40092The merchantTransactionId does not exist
    E40093The urlCallback is not correct
    E40094The urlKo is not correct
    E40095The urlOk is not correct
    E40096The urlPending is not correct
    E40097The Myneosurf email is not correct
    E40098The Myneosurf email does not exist
    E40099The Myneosurf credentials are not correct
    E40100The Myneosurf password is not correct
    E40101The last three characters of the Myneosurf PIN are not correct
    E40102The Myneosurf corresponding account is not verified
    E40103The Myneosurf corresponding account is blocked
    E40104The service is under maintenance
    E40105Dynamic description (The KYC level 0 is not sufficient). Ex: Account limit:[2500 eur] per year. Available:[1000 eur]
    E40106Dynamic description (The KYC level 1 is not sufficient). Ex: Account limit:[1000 eur] per year. Available:[1000 eur]
    E40107Dynamic description (KYC level 2 limitation). Ex: Account limit:30000 eur per month. Available:[1000 eur]
    E40108Dynamic description (The KYC level 0 or 1 is not sufficient). Ex: Account limit:[1000 eur] per transaction
    E40109Dynamic description (KYC level 2 limitation). Ex: Account limit:[1500 eur] per transaction
    E40110The transaction was declined
    E40111The document type is not correct
    E40112Too many document are awaiting approval, thank you try again later
    E40113The limit of 10 uploaded documents is attempt for this user
    E40114The limit of 2 pending documents is attempt for this user
    E40115The limit of 2 validated documents is attempt for this user
    E40116No document was selected
    E40117Error with upload
    E40118The document is empty
    E40119The document exceeds the limit of 2 Mb
    E40120The document should have an extension
    E40121The document can only have one of these extensions: pdf, jpg, jpeg, bmp, gif, tif, tiff, png
    E40122Error with upload, the format is unauthorized
    E40123The document can’t be visualized
    E40124The status of this document has already been previously updated
    E40125The pincode is not correct
    E40126The email or password are not correct
    E40127The product id is not correct
    E40128The product is not active
    E40129The transaction is not authorized for resellers
    E40130The transaction is not authorized because the client is a minor
    E40131The merchant account is for test purpose only
    E40132The pincode and the test parameter must be the same type
    E40133The product can be used only on a limited list of merchants, and this one does not belong to this list
    E40134The transaction is not authorized for this merchant and this type of product
    E40135The amount to debit is less or equal to zero
    E40136The amount to debit is more than the available balance
    E40137The amount to credit is more than the maximum balance
    E40138The transaction to reverse does not exist
    E40139The transaction to reverse is not successful
    E40140The transaction to reverse is not refundable
    E40141The transaction to reverse have a different currency
    E40142The transaction to reverse have already been reversed entirely
    E40143The transaction to reverse cannot be reversed with this too high amount
    E40144This transaction is not allowed to this merchant
    E40145The maximum total amount of payouts is reached
    E40146Transaction not found
    E40147Service not found
    E40148Card not found
    E40149Parameter paymentProfileId or amount is invalid: One of them should be set
    E40150The amount is insufficiently disposed for the transaction
    E40170Wrong code type
    E40171CLS Entry creation Error
    E40172Wrong transaction amount
    E40173Wrong currency
    E40174Unable to find active user
    E40175Too late for Reversal
    E40176Operation not allowed for current transaction status
    E40177Request after correction
    E40178Commission is already authorized
    E40179Commission was rejected
    E40180Commission was not authorized
    E40181Commission was reversed
    E40182Commission is in complaint process
    E40183Transaction not found
    E40184Transaction ID is already used
    E40185Client application is not active
    E40186Client application was not found
    E40187Status transition is not possible
    E40188Appid is already used
    E40189Phone hash is already default
    E40190Wrong ticket
    E40191Ticket wrong format
    E40192Ticket was expired
    E40193Ticket limit exceeded
    E40194PIN code entry is not allowed for given ticket
    E40195PIN code entry is required for given ticket
    E40196Ticket wrong status
    E40197Unable to use provided ticket in this transaction type
    E40198Ticket was already used
    E40199Wrong transaction type
    E40200Transaction TX_TYPE in SVC_LEVEL mode is not supported
    E40201T6 Ticket limit exceeded
    E40202V9 Ticket limit exceeded
    E40203Active ticket number exceeded
    E40204IKO terminal transaction
    E40205BLIK general error
    E40206Alias not found
    E40207Alias was already assigned to specific device
    E40208Alias was not assigned to specific device
    E40209MSISDN Alias is incorrect
    E40210Alias security error
    E40211Wrong IBAN number
    E40212Client application has invalid status
    E40213T6 reversal is disabled for current account
    E40214Reversal in TXREF mode is disabled for current account
    E40215Invalid original transaction type for reversal
    E40216Reversal for transaction was received too late
    E40217Wrong Acquirer number
    E40218Reversal for given transaction already exists
    E40219Reversals amount sum is bigger than original transaction amount
    E40220Converted reversal for transaction was received too late
    E40221Converted reversal for transaction already exists
    E40222Wrong sub-schema subversion
    E40223Cashback transaction is not allowed
    E40224Wrong KNR number
    E40225Wrong alias context
    E40226Alias too long
    E40227IBAN field is not allowed
    E40228Alias limit exceeded for given application
    E40229Wrong alias type
    E40230Wrong alias scope
    E40231Url for alias is not allowed
    E40232Alias wrong expiration date
    E40233Wrong URL format
    E40234Too many aliases with given value
    E40235Multibank mode does not allow for OVERWRITE
    E40236Missing IBAN field
    E40237The publisher does not support aliases
    E40238Duplicate alias type
    E40239Alias is not unique
    E40240Missing alias field
    E40241Provided alias type cannot be used for given transaction type
    E40242All aliases was filtered out
    E40243Missing alias field
    E40244Transaction require ON-US mode
    E40245Transaction type and sub-type is not supported
    E40246Issuer is temporary unavailable
    E40247Retrying transactions is not allowed
    E40248Retrying transaction was after expiration time
    E40249Bad transaction retry sequence
    E40250Retrying transaction was too early
    E40251Retrying transaction is not allowed for previous retrying status
    E40252Wrong retry transaction data
    E40253Transaction retry does not exists
    E40254PAYID Alias is required for given transaction
    E40255Declined by TAS
    E40256Declined by user
    E40257Declined by SEC
    E40258System ERROR
    E40259General ERROR
    E40260Insufficient funds on user account
    E40261TIMEOUT
    E40262Transaction limit exceeded
    E40263User timeout
    E40264Declined by issuer
    E40265AM_TIMEOUT
    E40266Alias was declined
    E40267Unknown error
    E40268Unknown network error
    E40269Network error of chosen payment system
    E40270Access prohibited. Wrong login or not enough permissions for requested information
    E40271Incorrect signature of request
    E40272Invoice rejected by merchant
    E40273Invoice expired
    E40274Payment system refusal
    E40275Refund is not possible
    E40276Refund amount exceeded
    E40277Identifier not found
    E40278New request with the same nonce
    E40279Payment expired
    E40280Error simulated via merchant’s request
    E40281Refused by payer
    E40282Incorrect payment amount
    E40283Insufficient funds
    E40284Internal error. Refresh the page
    E40285Payment system authorization failed
    E402863D Secure authorization failed
    E40287Invalid card number
    E40288Card expired
    E40289Card blocked
    E40290Amount limit exceeded
    E40291Quantity limit exceeded
    E40292Invalid operation
    E40300Unable to get details about created transaction
    E40301Unable to capture transaction
    E40302Unable to void created transaction
    E40303Unknown transaction status
    E40304Unable to create transaction
    E40305Unable to create transaction refund
    E40306Unauthorized request
    E40307Unsupported payment method channel
    E40308Unsupported payment method
    E40309Invalid payment configuration
    E40310Check-status request failed
    E40311Transaction cancel feature was not implemented
    E40312Unknown transaction status
    E40313Transaction check-status limit is exceeded
    E40314Callback input data is invalid
    E40315Unknown transaction
    E40316Pending transaction check-status strategy is missing
    E40317Transaction capture feature was not implemented
    E40318Identifier of transaction to refund param was missed
    E40319Refund transaction request was failed
    E40320Refund attempt number is exceeded
    E40321Deferred refund input is not valid
    E40322Returned transaction data does not match trx data
    E40323No customer account found by provided credentials
    E40324Customer limit exceeded.
    E40325Top-up limit exceeded.
    E40326Payout amount is below minimum payout amount of the merchant.
    E40327My paysafecard account not found on original transaction
    E40328Customer not active.
    E40329Customer yearly payout limit exceeded.
    E40330Transaction failed, please refer to issuer
    E40331Message format error
    E40333Transaction does not exist / Abandoned transaction
    E40334Original transaction does not exist or state is incorrect
    E40337Invalid card number
    E40339Wrong PIN, expiry date or CVN2
    E40340Wrong cardholder ID information, mobile phone number or CVN2
    E40341You have entered your PIN too many times
    E40342Your card does not support this service
    E50004Customer did not confirm transaction.
    E50013Customer cancelled transaction.
    E50018Topup transaction was declined.
    CT0001Expired payment. Stuck on verification.
    CT0002Expired payment. Stuck on psp transaction created.
    CT0003Expired payment. Stuck on rejected authorisation.
    C00001Error during psp request
    C00002Psp declines payment
    C00003Error during mpi enrollment request
    C00004Error during mpi authentication request
    C00005Mpi enrollment request timeout
    C00006Technical error
    C00007Error during authorisation
    C00008Psp request timeout
    C00009Uncategorized error during psp request
    C00010Conflict (409) returned by provider
    C00011Internal error. Unable to handle psp response. See logs.
    C00012Mpi authentication request timeout
    CR0001Payment declined by fraud service
    C00013Transaction not found on psp
    C00014Error during verification server request
    C00015Error during versioning request
    C00016Error during authentication request
    C00017Versioning request timeout
    C00018Authentication request timeout
    C00019Authentication failed
    C00020Authentication failed
    C00021Error during processing transaction
    C10001Unable to determine provider
    C10002Inconsistent configuration
    C10003Invalid amount
    C10004Unable to determine provider
    C10005Unable to determine provider
    C10006Unable to determine provider
    C10007Payer country is forbidden
    C10008Token not authenicated
    C20009Security failure
    C20011Suspected fraud
    C20082Challenge requested but could not be performed
    C20084Challenge Cancelation
    C20087Card type not supported in 3DS
    C40059Suspected Fraud
    C40063Security violation
    C40087Update card or cardholder data before reattempt; pspExternalRespCode = 83
    C40088Try again later; pspExternalRespCode = 83
    C50001First transaction not found
    C50002First transaction invalid state
    C50003First transaction service target not matched
    C50004First transaction card token not matched
    C50005Unable to validate first transaction
    C50006First transaction missing data
    C50007Technical error
    C30M69Technical error
    C30M68Authentication process timed out
    C30M66Technical error
    C30M65Technical error
    C30M64Technical error
    C30M63Technical error
    C30M50An error occurred during the 3D secure process
    C30M39Technical error
    C30M38The transaction has been denied by the Gateway because 3D secure Authentication failed.
    C30M37Technical error
    C30M36Technical error
    C30M35Technical error
    C30M33Technical error
    C30M32Technical error
    C30M30Transaction Failed due to error in 3D secure process
    C30M20Processor authentication error.
    C30M17Technical error
    C30M16Technical error
    C30M15Technical error
    C30M13Technical error
    C30M12Technical error
    C30M11Format Error
    C30M10Internal server error.
    C30M09The parameter is malformed.
    C30M08The Package Signature is malformed.
    C30M07Incorrect Gateway Response. Connection is broken.
    C30001The transaction has been denied by the Gateway.
    C30002Technical error
    C30003Technical error
    C30004The transaction has been denied by the Gateway due to an interchange timeout.
    C30005The transaction has been declined.
    C30006Transaction pending cardholder authentication.
    C30009Technical error
    C30010The transaction has been partially approved.
    C30011The queried transaction is currently being processed.
    C30013Technical error
    C30015Technical error
    C40001Refer to card issuer
    C40003Technical error
    C40004Technical error
    C40005Do not honor
    C40006General error
    C40007Technical error
    C40008Honor with identification
    C40012Invalid transaction
    C40013Invalid transaction amount
    C40014Invalid card number
    C40015No such issuer
    C40030Format error
    C40041Merchant should retain card (card reported lost)
    C40043Merchant should retain card (card reported stolen)
    C40046Closed Card Account
    C40051Insufficient funds
    C40054Expired card
    C40055Incorrect PIN
    C40057Transaction not permitted to cardholder
    C40058Technical error
    C40059Suspected transaction. Contact Your Bank
    C40061Exceeds approval amount limit
    C40062Restricted Card
    C40063Technical error
    C40065Exceeds withdrawal frequency limit
    C40075Allowable number of PIN-entry tries exceeded
    C40078Blocked or card not activated
    C40089Account Closed – Do not try again
    C40090Cutoff is in process
    C40091Issuer unavailable or switch inoperative
    C40093Technical error
    C40094Duplicate transaction
    C40096System malfunction, System malfunction or certain field error conditions
    E40555Exchange rate expired. Please try again
    C400N0Unable to authorize / CVV2 failure
    C400O5Soft decline (SCA required)
    C3PM14At least one of the input parameters is missing. Parameter [X] is missing.
    C3PM09Transaction failed due to too many requests.
    C3PM18Payment Method not allowed for this merchant.
    C3PM20Operation not allowed for this merchant
    C3PM21Invalid Payment Method
    C3PM22Payment Method missing.
    C3PM50Transaction Amount not within pre-defined threshold.
    C3PM52Transaction Amount exceeds or does not match the Transaction amount referenced in the request.
    C3PM53Amount exceeds the Transaction Amount referenced in the request
    C3PM55The grand total amount does not match the item total amount.
    C3PM64The operation on the transaction referenced in the request has already been executed successful
    C3PM66Referral operation not allowed.
    C3PM67Could not find the original transaction. Make sure that it exists and that its details were transmitted correctly
    C3PM80Technical error
    CR0004Technical error
    C20001Card authentication failed
    C20002Unknown Device
    C20003Unsupported Device
    C20004Exceeds authentication frequency limit
    C20005Expired card
    C20006Invalid card number
    C20007Invalid transaction
    C20008No Card record
    C20009Technical error
    C20010Stolen card
    C20011Suspected fraud
    C20012Transaction not permitted to cardholder
    C20013Cardholder not enrolled in service
    C20014Transaction timed out / Abandoned transaction
    C20015Technical error
    C20016Technical error
    C20017Technical error
    C20018Technical error
    C20019Exceeds ACS maximum challenges
    C20020Non-Payment transaction not supported
    C20021Technical error
    C20022ACS technical issue
    C20023Decoupled Authentication required by ACS but not requested by 3DS Requestor
    C200243DS Requestor Decoupled Max Expiry Time exceeded
    C20025Decoupled Authentication was provided insufficient time to authenticate cardholder. ACS will not make attempt
    C20026Authentication attempted but not performed by the cardholder
    C201013DS Authentication Error
    C201023DS Authentication Error
    C201033DS Authentication Error
    C202013DS Authentication Error
    C202023DS Authentication Error
    C202033DS Authentication Error – Invalid data
    C202043DS Authentication Error – Duplicate Data Element
    C203013DS Authentication Error
    C203023DS Authentication Error
    C203033DS Authentication Error
    C203043DS Authentication Error – ISO Code Invalid
    C203053DS Authentication Error
    C203063DS Authentication Error – Invalid Merchant Category Code (MCC)
    C203073DS Authentication Error – Serial Number Not Valid
    C204023DS Authentication Error – Time Out
    C204033DS Authentication Error
    C204043DS Authentication Error
    C204053DS Authentication Error
    CR0102Limit
    CR0103Connection
    CR0109Payment Missmatch
    CR0110Payment method swapping
    S00001Creating new sendout in payment service provider failed.
    S00002Capturing sendout in payment service provider failed.
    Modified at 2025-03-24 11:01:20
    Previous
    Response codes
    Next
    Create transaction