[{"_1":2,"_1010":-5,"_1011":-5},"loaderData",{"_3":4,"_1009":-5},"root",{"_5":6,"_27":28,"_31":-7,"_32":33,"_48":49,"_103":104,"_141":142},"meta",[7,14,17,22,25],{"_8":9,"_10":11,"_12":13},"tagName","link","rel","icon","href","https://assets.apidog.com/app/apidoc-image/custom/20241108/b7770ef8-fa03-45af-ac10-5512a42bb8fb.svg",{"_8":9,"_10":15,"_12":16},"canonical","https://docs.zen.com/payments/checkout-integration/statuses",{"_18":19,"_20":21},"name","description","content","Transaction statuses - Checkout documentation",{"_18":23,"_20":24},"keywords","Transaction statuses, Checkout documentation, API Design, API Specification, API Test, API Documentation, API Mock",{"_26":21},"title","i18nState",{"_29":30},"clientLocale","en-US","errorCodeMessage","clientConfig",{"_34":35,"_36":37,"_38":39,"_40":41,"_46":47},"apiBaseUrl","https://api.apidog.com","appWebUrl","https://app.apidog.com","apidocBuiltinPrefixPath","https://assets.apidog.com/app/static/apidoc","cloudMockBaseUrls",{"_42":43,"_44":45},"pathMode","https://mock.apidog.com/m1/{projectId}-{version}-{service}","idMode","https://mock.apidog.com/m2/{projectId}-{version}-{service}","apidocIsShowLogo",true,"urlConfig",{"_50":51,"_11":54,"_92":93,"_99":100},"home",{"_52":53},"index","https://apidog.com",{"_55":56,"_57":58,"_59":58,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":79,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91},"apidoc","https://assets.apidog.com/app/static/brand/apidoc.png","apidog","https://assets.apidog.com/app/static/brand/apidog-logo-256.png","apidog europe","googleDiscovery","https://assets.apidog.com/app/static/brand/google-discovery.png","har","https://assets.apidog.com/app/static/brand/har.png","iodocs","https://assets.apidog.com/app/static/brand/io-doc.png","jmeter","https://assets.apidog.com/app/static/brand/jmeter.png","openapi","https://assets.apidog.com/app/static/brand/openapi.png","postman","https://assets.apidog.com/app/static/brand/postman.png","raml","https://assets.apidog.com/app/static/brand/raml.png","wadl","https://assets.apidog.com/app/static/brand/wadl.png","curl","https://assets.apidog.com/app/static/brand/curl.png","insomnia","https://assets.apidog.com/app/static/brand/insomnia.png","wsdl","https://assets.apidog.com/app/static/brand/wsdl.png","markdown","https://assets.apidog.com/app/static/brand/markdown.png","html","https://assets.apidog.com/app/static/brand/html.png","protobuf","https://assets.apidog.com/app/static/brand/protobuf.png","soapui","https://assets.apidog.com/app/static/brand/soapui.svg","javaProject","https://assets.apidog.com/app/static/brand/java-project.png","help",{"_52":94,"_95":96,"_97":98},"https://apidog.com/help","browserExtension","https://chromewebstore.google.com/detail/apidog-browser-extension/dmhljjnonlhapikmelaefohecogokhio","csv","https://apidog.com/help/reference/csv","assets",{"_101":102},"logo512Png","https://assets.apidog.com/static/logo/apidog-logo-512.png","envConfig",{"_105":55,"_106":107,"_108":107,"_109":110,"_111":112,"_113":114,"_115":53,"_116":57,"_117":30,"_118":119,"_120":121,"_123":124,"_125":126,"_127":128,"_129":130,"_131":132,"_133":134,"_139":140},"RELEASE_BASE","DEBUG_API_BASE","","DEBUG_WEB_URL_BASE","AGENT_SERVER_API_BASE","https://web-proxy.apidog.com","APP_REGION","GLOBAL","APP_NAME","Apidog","APP_HOMEPAGE","APP_NAME_LOWER","DEFAULT_LOCALE","APP_BROWSER_EXTENSION_ADAPTER","apidogAgentCrossRequest","APP_API_SERVER_HOSTNAMES",[122],"api.apidog.com","APP_SUPPORT_EMAIL","support@apidog.com","APP_SCRIPT_MAIN_OBJECTS","$","SERVER_PROTOCOL","http","SERVER_HOST","apidog-api-svc","DEFAULT_DOC_LAYOUT","TwoColumn","NOT_CUSTOM_DOMAIN_HOSTNAMES",[135,136,137,138],"www.apidog.com","apidog.com","www.apidog.io","apidog.io","SERVER_REQUEST_TIMEOUT",15000,"docsDataState",{"_143":144,"_208":209,"_513":514,"_576":577,"_581":582,"_615":616,"_629":630,"_631":632,"_633":634,"_663":664,"_702":703,"_704":705,"_713":714,"_1003":1004,"_1006":1007},"navigation",{"_145":146,"_147":148,"_190":-7,"_191":192,"_193":194},"type","FIRST_LEVEL_NAVIGATION","firstLevelNavbarItems",[149,159,163,186],{"_145":9,"_150":151,"_26":152,"_11":-7,"_153":154,"_155":156,"_157":158},"id","01J44815C9RKMWRCERBQ1E8QD0","Go to zen.com","target","blank","to","https://www.zen.com","disabled",false,{"_145":9,"_150":160,"_26":161,"_11":-7,"_153":154,"_155":162,"_157":158},"01J5QKN0YXYP3QJH5FXG5VFVFZ","Go to myZEN.com","https://www.my.zen.com/",{"_145":164,"_150":165,"_26":166,"_157":158,"_11":-7,"_167":168,"_185":158},"menu","01JDHBFY9HD08CZZNJAVCK28S7","Documentation","children",[169,173,177,181],{"_145":9,"_150":170,"_26":171,"_11":-7,"_153":154,"_155":172,"_157":158},"01JDHBN4A325BT7T99M27YAGT6","Plugin integration","https://docs.zen.com/payments/plugins/",{"_145":9,"_150":174,"_26":175,"_11":-7,"_153":154,"_155":176,"_157":158},"01JDHBNBVGQDVZYBH9QHKS4V9C","API business","https://docs.zen.com/payments/api-integration",{"_145":9,"_150":178,"_26":179,"_11":-7,"_153":154,"_155":180,"_157":158},"01JDHBNFX6FE63RRF5W9P4GZGC","API reference","https://docs.zen.com/payments/api-reference/",{"_145":9,"_150":182,"_26":183,"_11":-7,"_153":154,"_155":184,"_157":158},"01JDHBMS3Z3408GHNAKB7PWYY8","Merchant panel","https://docs.zen.com/payments/merchant-panel/","selected",{"_145":9,"_150":187,"_26":188,"_11":-7,"_153":154,"_155":189,"_157":158},"01J4481BW9RHJ13S21QJEF2JSR","Brandbook","https://zencom.notion.site/ZEN-merchant-marketing-guide-877f9ca8712b4423ae59b64d840456eb","navId","align","left","navRightLinkItems",[195,200,204],{"_145":11,"_196":197,"_11":198,"_26":107,"_155":199,"_153":154},"key","icon-0-https://www.linkedin.com/company/zen-com","https://assets.apidog.com/app/static/apidoc/nav-right-side-icons/13.svg","https://www.linkedin.com/company/zen-com",{"_145":11,"_196":201,"_11":202,"_26":107,"_155":203,"_153":154},"icon-1-https://m.facebook.com/ZeroEffortNonbank/","https://assets.apidog.com/app/static/apidoc/nav-right-side-icons/7.svg","https://m.facebook.com/ZeroEffortNonbank/",{"_145":11,"_196":205,"_11":206,"_26":107,"_155":207,"_153":154},"icon-2-https://www.instagram.com/zen.com_official?utm_source=ig_web_button_share_sheet&igsh=ZDNlZDc0MzIxNw==","https://assets.apidog.com/app/static/apidoc/nav-right-side-icons/9.svg","https://www.instagram.com/zen.com_official?utm_source=ig_web_button_share_sheet&igsh=ZDNlZDc0MzIxNw==","sidebarTree",{"_210":-7,"_211":-7,"_212":213,"_214":215,"_503":504,"_505":506,"_509":510,"_511":512},"goBackSidebarTreeApiFolderNode","rootSidebarTreeApiFolderNode","homeLink","/payments/checkout-integration","sidebarTreeList",[216,259,319,367,427],{"_145":217,"_218":219,"_150":220,"_18":221,"_196":222,"_223":224,"_167":229,"_235":219,"_236":-7,"_19":-7,"_11":-7,"_155":107,"_185":158,"_258":158},"apiDetailFolder","docId",0,2152128,"About ZEN","apiDetailFolder.2152128","shareSettings",{"_225":226,"_227":228},"directoryTreeDisplayStyle","GENERAL_FOLDER","folderContentsDisplayingSettings","HIDE",[230,240,246,252],{"_145":231,"_150":232,"_18":233,"_196":234,"_235":220,"_236":-7,"_237":238,"_11":-7,"_155":239,"_185":158},"doc",602253,"First steps with ZEN","doc.602253","parentId","resourceName","tags",[],"/payments/checkout-integration/first-steps",{"_145":231,"_150":241,"_18":242,"_196":243,"_235":220,"_236":-7,"_237":244,"_11":-7,"_155":245,"_185":158},601168,"Who we are","doc.601168",[],"/payments/checkout-integration/who-we-are",{"_145":231,"_150":247,"_18":248,"_196":249,"_235":220,"_236":-7,"_237":250,"_11":-7,"_155":251,"_185":158},601169,"What we provide","doc.601169",[],"/payments/checkout-integration/what-we-provide",{"_145":231,"_150":253,"_18":254,"_196":255,"_235":220,"_236":-7,"_237":256,"_11":-7,"_155":257,"_185":158},601171,"How we provide","doc.601171",[],"/payments/checkout-integration/how-we-provide","expanded",{"_145":217,"_218":219,"_150":260,"_18":261,"_196":262,"_223":263,"_167":264,"_235":219,"_236":-7,"_19":-7,"_11":-7,"_155":107,"_185":158,"_258":158},1729077,"Introduction","apiDetailFolder.1729077",{"_225":226,"_227":228},[265,271,277,283,289,295,301,307,313],{"_145":231,"_150":266,"_18":267,"_196":268,"_235":260,"_236":-7,"_237":269,"_11":-7,"_155":270,"_185":158},601175,"Definitions","doc.601175",[],"/payments/checkout-integration/definitions",{"_145":231,"_150":272,"_18":273,"_196":274,"_235":260,"_236":-7,"_237":275,"_11":-7,"_155":276,"_185":158},602254,"About ZEN checkout","doc.602254",[],"/payments/checkout-integration/about-zen-checkout",{"_145":231,"_150":278,"_18":279,"_196":280,"_235":260,"_236":-7,"_237":281,"_11":-7,"_155":282,"_185":158},618353,"Revenue streams","doc.618353",[],"/payments/checkout-integration/revenue-streams",{"_145":231,"_150":284,"_18":285,"_196":286,"_235":260,"_236":-7,"_237":287,"_11":-7,"_155":288,"_185":158},601179,"Environments","doc.601179",[],"/payments/checkout-integration/environments",{"_145":231,"_150":290,"_18":291,"_196":292,"_235":260,"_236":-7,"_237":293,"_11":-7,"_155":294,"_185":158},621168,"Authorization & authentication","doc.621168",[],"/payments/checkout-integration/authorization-authentication",{"_145":231,"_150":296,"_18":297,"_196":298,"_235":260,"_236":-7,"_237":299,"_11":-7,"_155":300,"_185":158},601181,"Payment methods","doc.601181",[],"/payments/checkout-integration/payment-methods",{"_145":231,"_150":302,"_18":303,"_196":304,"_235":260,"_236":-7,"_237":305,"_11":-7,"_155":306,"_185":158},618344,"Payment process","doc.618344",[],"/payments/checkout-integration/payment-process",{"_145":231,"_150":308,"_18":309,"_196":310,"_235":260,"_236":-7,"_237":311,"_11":-7,"_155":312,"_185":158},601182,"Currencies","doc.601182",[],"/payments/checkout-integration/currencies",{"_145":231,"_150":314,"_18":315,"_196":316,"_235":260,"_236":-7,"_237":317,"_11":-7,"_155":318,"_185":158},601183,"Languages","doc.601183",[],"/payments/checkout-integration/languages",{"_145":217,"_218":219,"_150":320,"_18":321,"_196":322,"_223":323,"_167":324,"_235":219,"_236":-7,"_19":-7,"_11":-7,"_155":107,"_185":158,"_258":158},1729096,"Account registration & configuration","apiDetailFolder.1729096",{"_225":226,"_227":228},[325,331,337,343,349,355,361],{"_145":231,"_150":326,"_18":327,"_196":328,"_235":320,"_236":-7,"_237":329,"_11":-7,"_155":330,"_185":158},601187,"Before you begin","doc.601187",[],"/payments/checkout-integration/before-begin",{"_145":231,"_150":332,"_18":333,"_196":334,"_235":320,"_236":-7,"_237":335,"_11":-7,"_155":336,"_185":158},601188,"Registration","doc.601188",[],"/payments/checkout-integration/registration",{"_145":231,"_150":338,"_18":339,"_196":340,"_235":320,"_236":-7,"_237":341,"_11":-7,"_155":342,"_185":158},601189,"Configuration","doc.601189",[],"/payments/checkout-integration/configuration",{"_145":231,"_150":344,"_18":345,"_196":346,"_235":320,"_236":-7,"_237":347,"_11":-7,"_155":348,"_185":158},601190,"Merchant’s panel","doc.601190",[],"/payments/checkout-integration/merchant-panel",{"_145":231,"_150":350,"_18":351,"_196":352,"_235":320,"_236":-7,"_237":353,"_11":-7,"_155":354,"_185":158},618392,"Payments setup","doc.618392",[],"/payments/checkout-integration/payments-setup",{"_145":231,"_150":356,"_18":357,"_196":358,"_235":320,"_236":-7,"_237":359,"_11":-7,"_155":360,"_185":158},618397,"Locating Transactions in my.zen.com","doc.618397",[],"/payments/checkout-integration/locating-transactions",{"_145":231,"_150":362,"_18":363,"_196":364,"_235":320,"_236":-7,"_237":365,"_11":-7,"_155":366,"_185":158},618398,"Finding settlements","doc.618398",[],"/payments/checkout-integration/finding-settlements",{"_145":217,"_218":219,"_150":368,"_18":369,"_196":370,"_223":371,"_167":372,"_235":219,"_236":-7,"_19":-7,"_11":-7,"_155":107,"_185":158,"_258":158},2152156,"Features","apiDetailFolder.2152156",{"_225":226,"_227":228},[373,379,385,391,397,403,409,415,421],{"_145":231,"_150":374,"_18":375,"_196":376,"_235":368,"_236":-7,"_237":377,"_11":-7,"_155":378,"_185":158},684206,"Available features","doc.684206",[],"/payments/checkout-integration/features",{"_145":231,"_150":380,"_18":381,"_196":382,"_235":368,"_236":-7,"_237":383,"_11":-7,"_155":384,"_185":158},685018,"3-Domain Secure (3DS)","doc.685018",[],"/payments/checkout-integration/3ds",{"_145":231,"_150":386,"_18":387,"_196":388,"_235":368,"_236":-7,"_237":389,"_11":-7,"_155":390,"_185":158},870047,"Account Funding Transactions (AFT)","doc.870047",[],"/payments/checkout-integration/aft",{"_145":231,"_150":392,"_18":393,"_196":394,"_235":368,"_236":-7,"_237":395,"_11":-7,"_155":396,"_185":158},618350,"Authorization fee","doc.618350",[],"/payments/checkout-integration/authorization-fee",{"_145":231,"_150":398,"_18":399,"_196":400,"_235":368,"_236":-7,"_237":401,"_11":-7,"_155":402,"_185":158},685016,"Card widget","doc.685016",[],"/payments/checkout-integration/card-widget",{"_145":231,"_150":404,"_18":405,"_196":406,"_235":368,"_236":-7,"_237":407,"_11":-7,"_155":408,"_185":158},689189,"Cashback","doc.689189",[],"/payments/checkout-integration/cashback",{"_145":231,"_150":410,"_18":411,"_196":412,"_235":368,"_236":-7,"_237":413,"_11":-7,"_155":414,"_185":158},685019,"Currency Conversion Service","doc.685019",[],"/payments/checkout-integration/currency-conversion",{"_145":231,"_150":416,"_18":417,"_196":418,"_235":368,"_236":-7,"_237":419,"_11":-7,"_155":420,"_185":158},618393,"Instant Payment Notification (IPN)","doc.618393",[],"/payments/checkout-integration/ipn",{"_145":231,"_150":422,"_18":423,"_196":424,"_235":368,"_236":-7,"_237":425,"_11":-7,"_155":426,"_185":158},618401,"Shop logo on ZEN.COM checkout","doc.618401",[],"/payments/checkout-integration/shop-logo",{"_145":217,"_218":219,"_150":428,"_18":429,"_196":430,"_223":431,"_167":432,"_235":219,"_236":-7,"_19":-7,"_11":-7,"_155":107,"_185":158,"_258":47},1794142,"Integration","apiDetailFolder.1794142",{"_225":226,"_227":228},[433,438,444,450,456,462,468,474,480,486],{"_145":231,"_150":434,"_18":327,"_196":435,"_235":428,"_236":-7,"_237":436,"_11":-7,"_155":437,"_185":158},618387,"doc.618387",[],"/payments/checkout-integration/integration",{"_145":231,"_150":439,"_18":440,"_196":441,"_235":428,"_236":-7,"_237":442,"_11":-7,"_155":443,"_185":158},684207,"Integration checklist","doc.684207",[],"/payments/checkout-integration/checklist",{"_145":231,"_150":445,"_18":446,"_196":447,"_235":428,"_236":-7,"_237":448,"_11":-7,"_155":449,"_185":158},680514,"Communication parameters","doc.680514",[],"/payments/checkout-integration/communication-parameters",{"_145":231,"_150":451,"_18":452,"_196":453,"_235":428,"_236":-7,"_237":454,"_11":-7,"_155":455,"_185":158},680149,"Prepare the communication","doc.680149",[],"/payments/checkout-integration/communication-preparing",{"_145":231,"_150":457,"_18":458,"_196":459,"_235":428,"_236":-7,"_237":460,"_11":-7,"_155":461,"_185":158},618391,"Generating a Signature","doc.618391",[],"/payments/checkout-integration/signature",{"_145":231,"_150":463,"_18":464,"_196":465,"_235":428,"_236":-7,"_237":466,"_11":-7,"_155":467,"_185":158},618388,"Purchase Transaction","doc.618388",[],"/payments/checkout-integration/purchase",{"_145":231,"_150":469,"_18":470,"_196":471,"_235":428,"_236":-7,"_237":472,"_11":-7,"_155":473,"_185":158},618389,"Purchase Transaction with limited Payment methods","doc.618389",[],"/payments/checkout-integration/purchase-limited",{"_145":231,"_150":475,"_18":476,"_196":477,"_235":428,"_236":-7,"_237":478,"_11":-7,"_155":479,"_185":158},618396,"Refund Transaction","doc.618396",[],"/payments/checkout-integration/refund",{"_145":231,"_150":481,"_18":482,"_196":483,"_235":428,"_236":-7,"_237":484,"_11":-7,"_155":485,"_185":47},685138,"Transaction statuses","doc.685138",[],"/payments/checkout-integration/statuses",{"_145":217,"_218":219,"_150":487,"_18":488,"_196":489,"_223":490,"_167":491,"_235":428,"_236":-7,"_19":-7,"_11":-7,"_155":107,"_185":158,"_258":158},2978570,"Recurring Payments","apiDetailFolder.2978570",{"_225":226,"_227":228},[492,498],{"_145":231,"_150":493,"_18":494,"_196":495,"_235":487,"_236":-7,"_237":496,"_11":-7,"_155":497,"_185":158},836778,"About recurring","doc.836778",[],"/payments/checkout-integration/about-recurring",{"_145":231,"_150":499,"_18":464,"_196":500,"_235":487,"_236":-7,"_237":501,"_11":-7,"_155":502,"_185":158},838117,"doc.838117",[],"/payments/checkout-integration/recurring-transaction","selectedSidebarTreeNode",{"_145":231,"_150":481,"_18":482,"_196":483,"_235":428,"_236":-7,"_237":484,"_11":-7,"_155":485,"_185":47},"parentSidebarTreeApiFolderNodes",[507],{"_145":217,"_218":219,"_150":428,"_18":429,"_196":430,"_223":431,"_167":508,"_235":219,"_236":-7,"_19":-7,"_11":-7,"_155":107,"_185":158,"_258":47},[],"previousSidebarTreeNode",{"_145":231,"_150":475,"_18":476,"_196":477,"_235":428,"_236":-7,"_237":478,"_11":-7,"_155":479,"_185":158},"nextSidebarTreeNode",{"_145":231,"_150":493,"_18":494,"_196":495,"_235":487,"_236":-7,"_237":496,"_11":-7,"_155":497,"_185":158},"docsBaseConfig",{"_26":515,"_516":515,"_19":107,"_517":518,"_523":13,"_524":525,"_532":30,"_533":519,"_534":158,"_535":158,"_536":158,"_537":158,"_538":47,"_539":540,"_541":47,"_542":47,"_543":47,"_544":158,"_545":47,"_546":47,"_547":47,"_548":158,"_549":550,"_552":553,"_555":556,"_557":558,"_562":563,"_565":158,"_566":47,"_567":47,"_568":569,"_570":571,"_574":47,"_575":47},"Checkout documentation","siteName","logoSettings",{"_519":520,"_521":522},"light","https://assets.apidog.com/app/apidoc-image/custom/20250428/845124d5-bc0e-45c5-9c6e-989f15868254.png","dark","https://assets.apidog.com/app/apidoc-image/custom/20250428/56592679-1a37-419a-8c4f-8f8a92361d18.png","favicon","themePrimarySettings",{"_519":526,"_521":531},{"_527":528,"_529":530},"primaryColor","rgba(34,226,67,1)","textColor","WHITE",{"_527":528,"_529":530},"language","theme","displayThemeToggle","isShowPrefixUrl","isShowMaintainer","isShowUpdatedAt","isShowLastModifiedAt","displayFieldIds",[],"hidePoweredBy","hideBuiltWith","hideRunInAppButton","hideTryItOutButton","exportable","hideCloneButton","hideMyAppButton","hideAppFormatExportOption","googleAnalytics",{"_551":107},"measurementId","visibilitySettings",{"_145":554},"PUBLIC","apiDocLayout","OneColumn","mockRule",{"_559":560,"_561":47},"rules",[],"enableSystemRule","corsProxySettings",{"_150":564},4,"enableVibeCodingViaMCP","enableCopyPage","enableLLMs","globalMetadata","[\n {\"name\": \"description\", \"content\": \"{{DESCRIPTION}}\"},\n {\"name\": \"keywords\", \"content\": \"{{KEYWORDS}}\"}\n]","robotsFile",{"_572":47,"_20":573},"enable","User-Agent: *\nAllow: /\n\nSitemap: {{SITEMAP_URL}}","enableSitemapFile","persistEnvVariables","versionList",[578],{"_150":579,"_18":580,"_185":47,"_155":213,"_157":158},"575930","latest","resourceData",{"_145":231,"_583":584,"_602":603},"data",{"_150":481,"_18":482,"_585":107,"_20":586,"_587":428,"_588":589,"_590":591,"_592":593,"_594":595,"_596":597,"_598":597,"_145":107,"_237":599,"_600":601},"sidebarTitle","![integration code.jpg](https://api.apidog.com/api/v1/projects/609436/resources/345797/image-preview)\n\nYou can obtain information about the status of a Transaction registered in the **ZEN.COM** system in two ways:\n\n1. via IPN\n2. by sending a request to the **ZEN.COM** API\n\nChoose the most suitable option for receiving information about the Transaction status.\n\n\n\n \n\n \n Add an endpoint on your Shop's server that will create a request to the **ZEN.COM**. It will receive and process IPN POST from **ZEN.COM**. Depending on your network requirements and security, it may be necessary to add our IP address to the whitelist on your firewall.\n \n \nSet up IPN to specify which events should be monitored and transmitted to your system. You can configure this in two ways:\n1. In the Credentials tab in the Merchant panel, you can provide the IPN URL address. \n ![IPN-URL.jpg](https://api.apidog.com/api/v1/projects/609436/resources/345680/image-preview)\n2. With each request, you can provide a `customIpnUrl` for this request as an optional field. If you leave this field blank, **ZEN.COM** will use the IPN URL address saved in your Merchant panel. To verify whether the IPN is sent by **ZEN.COM**, you should use the IPN API Secret.\n\n:::highlight blue 💡\n**Example of JSON with `customIpnUrl` parameter**\n```\n{\n \"terminalUuid\":\"19b692d0-00b9-48f7-92ca-1509f055df2e\",\n \"amount\":1000,\n \"currency\":\"PLN\",\n \"merchantTransactionId\":\"trasaction1\",\n \"customer\":{\n \"id\":\"CustomerId328642\",\n \"firstName\":\"John\",\n \"lastName\":\"Doe\",\n \"email\":\"john.doe@test.com\"\n },\n \"items\":[\n {\n \"code\":\"itemCode1\",\n \"category\":\"itemCategory1\",\n \"name\":\"itemName1\",\n \"price\":50,\n \"quantity\":4,\n \"lineAmountTotal\":200\n },\n {\n \"code\":\"itemCode2\",\n \"category\":\"itemCategory2\",\n \"name\":\"itemName2\",\n \"price\":100,\n \"quantity\":2,\n \"lineAmountTotal\":200\n }\n ],\n \"billingAddress\":{\n \"id\":\"bAId1\",\n \"firstName\":\"John\",\n \"lastName\":\"Doe\",\n \"country\":\"PL\",\n \"street\":\"streetName\",\n \"city\":\"cityName\",\n \"countryState\":\"stateName\",\n \"province\":\"provinceName\",\n \"buildingNumber\":\"1\",\n \"roomNumber\":\"11\",\n \"postcode\":\"23-232\",\n \"companyName\":\"Company Name\",\n \"phone\":\"+48555555555\",\n \"taxId\":\"12345678\"\n },\n \"shippingAddress\":{\n \"id\":\"sA1\",\n \"firstName\":\"John\",\n \"lastName\":\"Doe\",\n \"country\":\"PL\",\n \"street\":\"streetName\",\n \"city\":\"cityName\",\n \"countryState\":\"stateName\",\n \"province\":\"provinceName\",\n \"buildingNumber\":\"1\",\n \"roomNumber\":\"11\",\n \"postcode\":\"11-111\",\n \"companyName\":\"Company Name\",\n \"phone\":\"+48555555555\"\n },\n \"urlFailure\":\"https://backtoshop/failure\",\n \"urlRedirect\":\"https://backtoshop/redirect\",\n \"urlSuccess\":\"https://backtoshop/success\",\n \"customIpnUrl\":\"https://backtoshop/notiify\",\n \"language\":\"pl\",\n \"signature\":\"16a36c391255e99596f12d802bf8fbba9b3414a23fc85bbf21974c05183961f3;sha256\"\n}\n```\n:::\n \n \n:::highlight blue 💡\n**Example of IPN for purchase Transaction**\n```\n{\n \"type\":\"TRT_PURCHASE\",\n \"transactionId\":\"2d36ff20-017d-4c63-b626-407edb369cc2\",\n \"merchantTransactionId\":\"feb78e88-47bc-428a-8ea4-806535aaf2de\",\n \"amount\":\"100\",\n \"currency\":\"PLN\",\n \"status\":\"PENDING\",\n \"hash\":\"28EE6604A8A40ACC8B8CE0B8DE9AAC87A4E24BBF0388A48ED164E512C8073C7E\",\n \"signature\":\"D3739E5ADCC20E436DEE8F386C81B1C3ACCCE0558FAB65EC924564F998F983EE\",\n \"paymentMethod\":{\n \"name\":\"PME_PBZ\",\n \"channel\":\"PCL_PBZ\",\n \"parameters\":{\n \n }\n },\n \"customer\":{\n \"firstName\":\"John\",\n \"lastName\":\"Doe\",\n \"email\":\"john@doe.pl\",\n \"ip\":\"172.89.0.1\",\n \"country\":\"US\"\n },\n \"securityStatus\":\"pending\",\n \"riskData\":{\n \n },\n \"email\":\"john@doe.pl\"\n}\n:::\n \n \nAt **ZEN.COM**, we use HASH to further secure the communication between Merchant systems and **ZEN.COM** systems. To correctly calculate the HASH, it is necessary to use specific parameters in the order indicated below:\n1. `transaction.merchantTransactionId`\n2. `transaction.currency`\n3. `transaction.amount`\n4. `transactionStatus`\n5. `merchantIpnSecret`\n\nHash values are calculated as follows:\n\n:::highlight blue \nsha256({transaction.merchantTransactionId}{transaction.currency}{transaction.amount}{transactionStatus}{merchantIpnSecret})\n:::\n\n:::warning\nProviding incorrect data in the HASH or an incorrect order of parameters in the transmitted HASH will result in the rejection of such communication.\n:::\n \nYou should create a hash for particular values using sha256 and compare the result with the hashed values of the received IPN. To verify whether the IPN is sent by **ZEN.COM**, you should use the IPN API Secret. You can find IPN API Secret in your [my.zen.com ](my.zen.com )Merchant panel.\n \nMerchant **IPN Secret** used for this example is:\n\n:::highlight blue\naeb8e7bf-0009-4f30-b521-1136fd336ae6\n:::\n\nwith\n\n:::highlight blue\n`merchantTransactionID` = feb78e88-47bc-428a-8ea4-806535aaf2de\n`currency` = PLN\n`amount` = 100\n`transactionStatus` = PENDING\n`merchantIpnSecret` = aeb8e7bf-0009-4f30-b521-1136fd336ae6\n:::\n\nwe get\n\n:::highlight blue\n`sha256(feb78e88-47bc-428a-8ea4-806535aaf2dePLN100PENDINGaeb8e7bf-0009-4f30-b521-1136fd336ae6)`\n:::\n\nwhich gives\n\n:::highlight blue\n`hash = 28EE6604A8A40ACC8B8CE0B8DE9AAC87A4E24BBF0388A48ED164E512C8073C7E`\n:::\n\nThe received hash is **equal** to the hash received in IPN. This confirms that IPN was sent by **ZEN.COM**.\n\n\nTo confirm that the IPN was successfully received, your system must send the following response:\n\n-content type: application/json\n\n:::highlight blue 💡\n**Example of the response**\n{\n `status`: „ok”\n}\n::: \n\n \n \n \n:::info\nBefore create a request, please read our API reference documentation: https://developer.zen.com/api-9879340\n:::\n\n\n \nCreate a GET request using parameters as shown below.\n \nPath parameters\n| Name | Allowed values | Required field | Description |\n| --- | --- | --- | --- |\n| `id` | string | Y | An unique identifier |\n\nHeader parameters\n| Name | Allowed values | Required field | Description |\n| --- | --- | --- | --- |\n| `request-id` | string | Y | An unique identifier generated by requesting Merchant |\n \n\nSend the POST request to:\n1. test environment: https://api.zen-test.com/v1/transactions/{id}\n2. production environment: https://api.zen.com/v1/transactions/{id}\n \n\n:::highlight blue 💡\n**Example of JSON response**\n```\n{\n \"id\":\"497f6eca-6276-4993-bfeb-53cbbbba6f08\",\n \"merchantTransactionId\":\"12a3b098-a4a5-4f2a-9763-4a32d5ge32dc\",\n \"amount\":\"123.04\",\n \"currency\":\"PLN\",\n \"createdAt\":\"2019-08-24T14:15:22.123Z\",\n \"modifiedAt\":\"2019-08-24T14:15:22.123Z\",\n \"type\":\"TRT_REFUND\",\n \"status\":\"ACCEPTED\",\n \"paymentChannel\":\"PCL_CARD\"\n}\n:::\n\n \n \n","folderId","projectId",609436,"moduleId",360466,"createdAt","2024-10-02T09:50:05.000Z","updatedAt","2024-10-10T09:53:06.000Z","creatorId",479081,"editorId",[],"visibility","INHERITED","extraData",{"_604":605,"_613":614},"apiFieldList",[606],{"_145":594,"_196":607,"_18":608,"_609":595,"_610":611,"_612":47},"updateAt","Last modified:","value","format","2024-10-10 09:53:06","hidden","dataSchemaDefinitions",{},"docsIdTypeData",{"_617":618,"_619":589,"_588":589,"_620":621,"_622":623,"_624":625,"_626":627,"_628":-7},"onlineType","APIDOC","onlineId","teamId",270695,"branchId",575930,"visitType","customDomain","subdirectory","payments/checkout-integration","specialFileType","notification",[],"footerBanner",[],"projectSetting",{"_635":636,"_637":638,"_659":660,"_661":662},"auth",{},"advancedSettings",{"_639":158,"_640":158,"_641":47,"_642":643,"_644":158,"_645":158,"_646":647,"_653":654},"enableJsonc","enableBigint","responseValidate","isDefaultUrlEncoding",3,"enableTestScenarioSetting","enableYAPICompatScript","publishedDocUrlRules",{"_648":649,"_650":651,"_652":47},"defaultRule","RESOURCE_KEY_ONLY","resourceKeyStandard","LEGACY","enableResourceKeyStandard","folderShareExpandModeSettings",{"_655":656,"_657":658},"expandId",[],"mode","MANUAL","securityScheme",{},"mockSettings",{},"environments",{"_665":666,"_689":690,"_698":699},"selectedEnvironment",{"_150":667,"_18":668,"_669":670,"_671":672,"_674":675,"_676":677,"_678":679,"_680":681,"_145":682,"_600":683,"_588":589,"_684":685,"_596":597,"_686":219,"_237":687,"_598":597,"_592":688,"_594":688},1748120,"Prod Env","baseUrl","https://prod.your-api-server.com","baseUrls",{"_673":670},"default","requestProxyAgentSettings",{},"variables",[],"parameters",{},"registrationCenters",[],"normal","protected","projectType","HTTP","ordering",[],"2024-07-23T11:01:36.000Z","environmentList",[691],{"_150":667,"_18":668,"_669":670,"_671":692,"_674":693,"_676":694,"_678":695,"_680":696,"_145":682,"_600":683,"_588":589,"_684":685,"_596":597,"_686":219,"_237":697,"_598":597,"_592":688,"_594":688},{"_673":670},{},[],{},[],[],"servers",[700],{"_150":673,"_18":701},"Default Server","searchSettings",{},"versionSettings",[706],{"_622":623,"_707":47,"_18":580,"_708":580,"_663":709},"isDefaultVersion","slug",{"_710":711,"_712":667},"environmentIds",[667],"defaultEnvironmentId","seoInfos",["M",715,716,731,732,738,739,745,746,752,753,759,760,766,767,773,774,779,780,786,787,793,794,800,801,807,808,814,815,821,822,828,829,835,836,842,843,849,850,856,857,863,864,870,871,877,878,884,885,891,892,898,899,905,906,912,913,919,920,926,927,933,934,940,941,947,948,954,955,961,962,968,969,975,976,982,983,989,990,996,997],"602253:DOC",{"_150":717,"_718":232,"_719":720,"_721":722,"_26":107,"_19":107,"_23":107,"_723":724,"_588":589,"_730":-5},2378,"relatedId","relatedType","DOC","path","first-steps","metaSocial",{"_725":726,"_728":729},"twitter",{"_727":107,"_26":107,"_19":107},"image","facebook",{"_727":107,"_26":107,"_19":107},"customMeta","601168:DOC",{"_150":733,"_718":241,"_719":720,"_721":734,"_26":107,"_19":107,"_23":107,"_723":735,"_588":589,"_730":-5},2379,"who-we-are",{"_725":736,"_728":737},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"601169:DOC",{"_150":740,"_718":247,"_719":720,"_721":741,"_26":107,"_19":107,"_23":107,"_723":742,"_588":589,"_730":-5},2380,"what-we-provide",{"_725":743,"_728":744},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"601171:DOC",{"_150":747,"_718":253,"_719":720,"_721":748,"_26":107,"_19":107,"_23":107,"_723":749,"_588":589,"_730":-5},2381,"how-we-provide",{"_725":750,"_728":751},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"601175:DOC",{"_150":754,"_718":266,"_719":720,"_721":755,"_26":107,"_19":107,"_23":107,"_723":756,"_588":589,"_730":-5},2382,"definitions",{"_725":757,"_728":758},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"602254:DOC",{"_150":761,"_718":272,"_719":720,"_721":762,"_26":107,"_19":107,"_23":107,"_723":763,"_588":589,"_730":-5},2383,"about-zen-checkout",{"_725":764,"_728":765},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618353:DOC",{"_150":768,"_718":278,"_719":720,"_721":769,"_26":107,"_19":107,"_23":107,"_723":770,"_588":589,"_730":-5},2384,"revenue-streams",{"_725":771,"_728":772},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"601179:DOC",{"_150":775,"_718":284,"_719":720,"_721":663,"_26":107,"_19":107,"_23":107,"_723":776,"_588":589,"_730":-5},2385,{"_725":777,"_728":778},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"621168:DOC",{"_150":781,"_718":290,"_719":720,"_721":782,"_26":107,"_19":107,"_23":107,"_723":783,"_588":589,"_730":-5},2386,"authorization-authentication",{"_725":784,"_728":785},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"601181:DOC",{"_150":788,"_718":296,"_719":720,"_721":789,"_26":107,"_19":107,"_23":107,"_723":790,"_588":589,"_730":-5},2387,"payment-methods",{"_725":791,"_728":792},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618344:DOC",{"_150":795,"_718":302,"_719":720,"_721":796,"_26":107,"_19":107,"_23":107,"_723":797,"_588":589,"_730":-5},2388,"payment-process",{"_725":798,"_728":799},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"601182:DOC",{"_150":802,"_718":308,"_719":720,"_721":803,"_26":107,"_19":107,"_23":107,"_723":804,"_588":589,"_730":-5},2389,"currencies",{"_725":805,"_728":806},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"601183:DOC",{"_150":809,"_718":314,"_719":720,"_721":810,"_26":107,"_19":107,"_23":107,"_723":811,"_588":589,"_730":-5},2390,"languages",{"_725":812,"_728":813},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"601187:DOC",{"_150":816,"_718":326,"_719":720,"_721":817,"_26":107,"_19":107,"_23":107,"_723":818,"_588":589,"_730":-5},2391,"before-begin",{"_725":819,"_728":820},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"601188:DOC",{"_150":823,"_718":332,"_719":720,"_721":824,"_26":107,"_19":107,"_23":107,"_723":825,"_588":589,"_730":-5},2392,"registration",{"_725":826,"_728":827},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"601189:DOC",{"_150":830,"_718":338,"_719":720,"_721":831,"_26":107,"_19":107,"_23":107,"_723":832,"_588":589,"_730":-5},2393,"configuration",{"_725":833,"_728":834},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"601190:DOC",{"_150":837,"_718":344,"_719":720,"_721":838,"_26":107,"_19":107,"_23":107,"_723":839,"_588":589,"_730":-5},2394,"merchant-panel",{"_725":840,"_728":841},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618392:DOC",{"_150":844,"_718":350,"_719":720,"_721":845,"_26":107,"_19":107,"_23":107,"_723":846,"_588":589,"_730":-5},2395,"payments-setup",{"_725":847,"_728":848},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618397:DOC",{"_150":851,"_718":356,"_719":720,"_721":852,"_26":107,"_19":107,"_23":107,"_723":853,"_588":589,"_730":-5},2396,"locating-transactions",{"_725":854,"_728":855},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618398:DOC",{"_150":858,"_718":362,"_719":720,"_721":859,"_26":107,"_19":107,"_23":107,"_723":860,"_588":589,"_730":-5},2397,"finding-settlements",{"_725":861,"_728":862},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"684206:DOC",{"_150":865,"_718":374,"_719":720,"_721":866,"_26":107,"_19":107,"_23":107,"_723":867,"_588":589,"_730":-5},2398,"features",{"_725":868,"_728":869},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"685018:DOC",{"_150":872,"_718":380,"_719":720,"_721":873,"_26":107,"_19":107,"_23":107,"_723":874,"_588":589,"_730":-5},2399,"3ds",{"_725":875,"_728":876},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618350:DOC",{"_150":879,"_718":392,"_719":720,"_721":880,"_26":107,"_19":107,"_23":107,"_723":881,"_588":589,"_730":-5},2400,"authorization-fee",{"_725":882,"_728":883},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"685016:DOC",{"_150":886,"_718":398,"_719":720,"_721":887,"_26":107,"_19":107,"_23":107,"_723":888,"_588":589,"_730":-5},2401,"card-widget",{"_725":889,"_728":890},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"689189:DOC",{"_150":893,"_718":404,"_719":720,"_721":894,"_26":107,"_19":107,"_23":107,"_723":895,"_588":589,"_730":-5},2402,"cashback",{"_725":896,"_728":897},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"685019:DOC",{"_150":900,"_718":410,"_719":720,"_721":901,"_26":107,"_19":107,"_23":107,"_723":902,"_588":589,"_730":-5},2403,"currency-conversion",{"_725":903,"_728":904},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618393:DOC",{"_150":907,"_718":416,"_719":720,"_721":908,"_26":107,"_19":107,"_23":107,"_723":909,"_588":589,"_730":-5},2404,"ipn",{"_725":910,"_728":911},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618401:DOC",{"_150":914,"_718":422,"_719":720,"_721":915,"_26":107,"_19":107,"_23":107,"_723":916,"_588":589,"_730":-5},2405,"shop-logo",{"_725":917,"_728":918},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618387:DOC",{"_150":921,"_718":434,"_719":720,"_721":922,"_26":107,"_19":107,"_23":107,"_723":923,"_588":589,"_730":-5},2406,"integration",{"_725":924,"_728":925},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"684207:DOC",{"_150":928,"_718":439,"_719":720,"_721":929,"_26":107,"_19":107,"_23":107,"_723":930,"_588":589,"_730":-5},2407,"checklist",{"_725":931,"_728":932},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"680514:DOC",{"_150":935,"_718":445,"_719":720,"_721":936,"_26":107,"_19":107,"_23":107,"_723":937,"_588":589,"_730":-5},2408,"communication-parameters",{"_725":938,"_728":939},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"680149:DOC",{"_150":942,"_718":451,"_719":720,"_721":943,"_26":107,"_19":107,"_23":107,"_723":944,"_588":589,"_730":-5},2409,"communication-preparing",{"_725":945,"_728":946},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618391:DOC",{"_150":949,"_718":457,"_719":720,"_721":950,"_26":107,"_19":107,"_23":107,"_723":951,"_588":589,"_730":-5},2410,"signature",{"_725":952,"_728":953},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618388:DOC",{"_150":956,"_718":463,"_719":720,"_721":957,"_26":107,"_19":107,"_23":107,"_723":958,"_588":589,"_730":-5},2411,"purchase",{"_725":959,"_728":960},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618389:DOC",{"_150":963,"_718":469,"_719":720,"_721":964,"_26":107,"_19":107,"_23":107,"_723":965,"_588":589,"_730":-5},2412,"purchase-limited",{"_725":966,"_728":967},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"618396:DOC",{"_150":970,"_718":475,"_719":720,"_721":971,"_26":107,"_19":107,"_23":107,"_723":972,"_588":589,"_730":-5},2413,"refund",{"_725":973,"_728":974},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"685138:DOC",{"_150":977,"_718":481,"_719":720,"_721":978,"_26":107,"_19":107,"_23":107,"_723":979,"_588":589,"_730":-5},2414,"statuses",{"_725":980,"_728":981},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"836778:DOC",{"_150":984,"_718":493,"_719":720,"_721":985,"_26":107,"_19":107,"_23":107,"_723":986,"_588":589,"_730":-5},3901,"about-recurring",{"_725":987,"_728":988},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"838117:DOC",{"_150":991,"_718":499,"_719":720,"_721":992,"_26":107,"_19":107,"_23":107,"_723":993,"_588":589,"_730":-5},3903,"recurring-transaction",{"_725":994,"_728":995},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"870047:DOC",{"_150":998,"_718":386,"_719":720,"_721":999,"_26":107,"_19":107,"_23":107,"_723":1000,"_588":589,"_730":-5},4442,"aft",{"_725":1001,"_728":1002},{"_727":107,"_26":107,"_19":107},{"_727":107,"_26":107,"_19":107},"itemPathPrefix",{"_669":107,"_1005":107,"_626":627},"versionSlug","appEnvMap",{"_1008":119},"appBrowserExtensionAdapterKey","routes/_index/route","actionData","errors"]