{"id":752,"date":"2023-12-28T14:12:58","date_gmt":"2023-12-28T14:12:58","guid":{"rendered":"https:\/\/www.zen.com\/developer\/?page_id=752"},"modified":"2024-05-24T13:34:12","modified_gmt":"2024-05-24T13:34:12","slug":"merchant-checklist","status":"publish","type":"page","link":"https:\/\/www.zen.com\/developer\/merchant-checklist\/","title":{"rendered":"Merchant checklist"},"content":{"rendered":"\n<h4 class=\"wp-block-heading\">Merchant checklist<\/h4>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Create your account <\/strong><\/h3>\n\n\n<div class=\"lazyblock-checklist-1dKnND wp-block-lazyblock-checklist\"><ul class=\"lazy-block-checklist\">\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">Fill out the contact form on get.zen.com, through which a account manager will get in touch with you. Together, you will go through the onboarding process, during which you will choose the type of integration and payment methods you wish to have on your store. Decide which integration method will be suitable for you.<\/div><\/label>\n    <\/li>\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">Think about payment method are necessary for your business and which ones your customers will most frequently use.\u00a0<\/div><\/label>\n    <\/li>\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">Ensure that you have completed all necessary steps with your account manager.<\/div><\/label>\n    <\/li>\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">Ask the account manager about testing the account.\u00a0 <b>Important information: For the test account registration, we will need information about IP address you will be using during testing.<\/b><\/div><\/label>\n    <\/li>\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">You will receive login credentials for your test account on the my.zen-test.com platform.<\/div><\/label>\n    <\/li>\n<\/ul><\/div>\n\n\n<p><a href=\"https:\/\/confluence.code.g2a.com\/pages\/viewpage.action?pageId=284375881\"><\/a><\/p>\n\n\n\n<p>Remember that credentials for the test and production accounts are different!<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Starting the test<\/strong><\/h3>\n\n\n<div class=\"lazyblock-checklist-1aCxCd wp-block-lazyblock-checklist\"><ul class=\"lazy-block-checklist\">\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">Log in to your account and review with the credentials.\u00a0 <b> Important information: In the store settings you will find credentials and you should have two payment methods BLIK and Card &#8211; these are the only available methods for the test environment.<\/b><\/div><\/label>\n    <\/li>\n<\/ul><\/div>\n\n\n<h3 class=\"wp-block-heading\"><strong><strong>Build your integration<\/strong><\/strong><\/h3>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Starting the test<\/strong><\/h3>\n\n\n<div class=\"lazyblock-checklist-GwReU wp-block-lazyblock-checklist\"><ul class=\"lazy-block-checklist\">\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">Log in to your account and review with the credentials.\u00a0 <b> Important information: In the store settings you will find credentials and you should have two payment methods BLIK and Card &#8211; these are the only available methods for the test environment, refund is only available for Card method. You should receive information about the test BLIK and test card credentials for your test environment via mail along with your logs credentials.\u00a0<\/b><\/div><\/label>\n    <\/li>\n<\/ul><\/div>\n\n\n<p><br><br>You can find the credentials by logging into the platform at my.zen-test.com, accessing your store, and then navigating to &#8222;Store Settings&#8221;.&nbsp;<\/p>\n\n\n\n<p><strong>Test your integration<\/strong><\/p>\n\n\n<div class=\"lazyblock-checklist-1R2QWy wp-block-lazyblock-checklist\"><ul class=\"lazy-block-checklist\">\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">Make test payment Depending on the integration method you have chosen, whether it&#8217;s checkout or API, according to the instructions for the respective method, you need to perform a test payment.\u00a0To test your integration, initiate a test payment; Your payment can be accepted or rejected Handle errored or refused payments. It is crucial to understand how the system works when a payment is declined or encounters an error. Refer to our documentation for assistance in conducting such a payment.<\/div><\/label>\n    <\/li>\n<\/ul><\/div>\n\n\n<p><\/p>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>How to make successful payment?<\/summary>\n<figure class=\"wp-block-table table--no-borders\"><table><tbody><tr><td><strong>Checkout<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\"><strong>API<\/strong><\/td><\/tr><tr><td>1. <a href=\"https:\/\/www.zen.com\/developer\/checkout-integration\/#request\" data-type=\"URL\" data-id=\"https:\/\/www.zen.com\/developer\/checkout-integration\/#request\">Creating a request.<\/a><br>2. <a href=\"https:\/\/www.zen.com\/developer\/checkout-integration\/#signature\" data-type=\"URL\" data-id=\"https:\/\/www.zen.com\/developer\/checkout-integration\/#signature\">Generating signature.<\/a><br>Important: Go through all the signature generation instruction points carefully, paying attention to whether the data declared in the request differs from that in the text before hashing, remembering to preserve all characters.&nbsp;<br>3. <a href=\"https:\/\/www.zen.com\/developer\/checkout-integration\/#ipn\" data-type=\"URL\" data-id=\"https:\/\/www.zen.com\/developer\/checkout-integration\/#ipn\">Configure IPN.<\/a><br>4. Test payment.&nbsp;<br>Important: To set up payment ZEN, you should POST to this ZEN test URL&nbsp;<strong>https:\/\/secure.zen-test.com\/api\/checkouts<\/strong><br>5. Check payment on my.zen-test.com panel.<\/td><td class=\"has-text-align-left\" data-align=\"left\">1. <a href=\"https:\/\/developer.zen.com\/payments\/api\/powerapi.html#tag\/Transactions\/operation\/createTransaction\" data-type=\"URL\" data-id=\"https:\/\/developer.zen.com\/payments\/api\/powerapi.html#tag\/Transactions\/operation\/createTransaction\">Creating transaction.&nbsp;<\/a><br>To create transaction you have to POST to this ZEN test URL&nbsp;<br>https:\/\/api.zen-test.com\/v1\/transactions<br>Important: In the request, there are data such as &#8222;paymentChannel&#8221; and &#8222;type&#8221;, the values of which you can check at this address&nbsp;<br>https:\/\/www.zen.com\/developer\/api-integration\/#payment-methods<br><em>We need to remember to add in headers the API Key (from credentials) and Content-Type: application\/json<\/em><br>2. <a href=\"https:\/\/www.zen.com\/developer\/checkout-integration\/#ipn\" data-type=\"URL\" data-id=\"https:\/\/www.zen.com\/developer\/checkout-integration\/#ipn\">Configure IPN.<\/a>&nbsp;<br>3. Check payment on my.zen-test.com panel.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n<div class=\"lazyblock-checklist-11WJdE wp-block-lazyblock-checklist\"><ul class=\"lazy-block-checklist\">\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">Make test refund In the plug-in and checkout integration, you can only process refunds through the my.zen-test.com platform, whereas in the API integration, in addition to processing refunds through the ZEN platform, you can also do so via a POST to the ZEN test URL\u00a0https:\/\/api.zen-test.com\/v1\/transactions\/refundAccording to our API documentation field transactionId &#8211; id of transaction to be refunded provided in ZEN, you can check value in\u00a0my.zen-test.com<\/div><\/label>\n    <\/li>\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">Check IPN configuration After a successful payment or refund, an Instant Payment Notification (IPN) with information about the payment and refund should be sent to the declared URL address.\u00a0If you receive a notification after completing a test transaction, the configuration was successful.<\/div><\/label>\n    <\/li>\n<\/ul><\/div>\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary><strong>Configure integration on production environment&nbsp;<\/strong><\/summary>\n<p>Check on your zen account (my.zen.com) you have all required payment methods are visible, and you can click to activate them.<br>Follow our integration documentation to have the opportunity to process payments and repeat the steps from the test environment with the corresponding URL address as listed in our documentation.<\/p>\n<\/details>\n\n\n<div class=\"lazyblock-checklist-Z6SJxX wp-block-lazyblock-checklist\"><ul class=\"lazy-block-checklist\">\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">Additional set up. For each type of integration, there are certain payment methods that need to be integrated additionally: Apple Pay, Google Pay or PayPal.\u00a0<\/div><\/label>\n    <\/li>\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">Make a payment. Test various payment methods in the production environment; you will have access to all configured methods.<\/div><\/label>\n    <\/li>\n<\/ul><\/div>\n\n\n<p><br>For API integration; <strong>&nbsp;<\/strong><\/p>\n\n\n<div class=\"lazyblock-checklist-fWx7n wp-block-lazyblock-checklist\"><ul class=\"lazy-block-checklist\">\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">Make a refund. You can perform partial and full refund, whether partial refunds are possible depends on the payment method. Partial refunds are not available for the Pay by Link method.<\/div><\/label>\n    <\/li>\n    <li>\n      <label><input type=\"checkbox\"> <div class=\"label\">IPN configuration.\u00a0 Configure IPN in the production environment, make sure you acknowledge IPN using the HTTP protocol with a &#8222;200&#8221; status. However, if you do this incorrectly, IPNs will be sent to you queued. Check if you&#8217;re receiving all IPNs for your account.<\/div><\/label>\n    <\/li>\n<\/ul><\/div>\n\n\n<h3 class=\"wp-block-heading\"><strong>You are ready to operate and use the ZEN gateway correctly<\/strong>.<\/h3>\n\n\n\n<p><a href=\"https:\/\/www.zen.com\/developer\/start-integrating\/\" data-type=\"page\" data-id=\"55\">Integration type<\/a>&gt;&gt;<\/p>\n\n\n\n<p><a href=\"https:\/\/www.zen.com\/developer\/3d-secure\/\" data-type=\"page\" data-id=\"1009\">3DS more information>><\/a><\/p>\n\n\n\n<p><a href=\"https:\/\/www.zen.com\/developer\/payment-methods-transaction-type\/\" data-type=\"link\" data-id=\"https:\/\/www.zen.com\/developer\/payment-methods-transaction-type\/\">Transaction Type &gt;&gt;<\/a><\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><\/h4>\n","protected":false},"excerpt":{"rendered":"<p>Merchant checklist Create your account Remember that credentials for the test and production accounts are different! Starting the test Build your integration Starting the test You can find the credentials by logging into the platform at my.zen-test.com, accessing your store, and then navigating to &#8222;Store Settings&#8221;.&nbsp; Test your integration For API integration; &nbsp; You are [&hellip;]<\/p>\n","protected":false},"author":9,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"acf":[],"_links":{"self":[{"href":"https:\/\/www.zen.com\/developer\/wp-json\/wp\/v2\/pages\/752"}],"collection":[{"href":"https:\/\/www.zen.com\/developer\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.zen.com\/developer\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.zen.com\/developer\/wp-json\/wp\/v2\/users\/9"}],"replies":[{"embeddable":true,"href":"https:\/\/www.zen.com\/developer\/wp-json\/wp\/v2\/comments?post=752"}],"version-history":[{"count":35,"href":"https:\/\/www.zen.com\/developer\/wp-json\/wp\/v2\/pages\/752\/revisions"}],"predecessor-version":[{"id":1018,"href":"https:\/\/www.zen.com\/developer\/wp-json\/wp\/v2\/pages\/752\/revisions\/1018"}],"wp:attachment":[{"href":"https:\/\/www.zen.com\/developer\/wp-json\/wp\/v2\/media?parent=752"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}