{"id":291,"date":"2017-06-20T06:53:47","date_gmt":"2017-06-20T06:53:47","guid":{"rendered":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/webpay\/payment-transaction-leg\/request-hash-calculation\/"},"modified":"2017-09-08T13:30:24","modified_gmt":"2017-09-08T13:30:24","slug":"request-hash-calculation","status":"publish","type":"docs","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/webpay\/payment-transaction-leg\/request-hash-calculation\/","title":{"rendered":"Request Hash Calculation"},"content":{"rendered":"<h4><strong>HASH COMPUTATION<\/strong><\/h4>\n<p>The following fields are to be combined and hashed using <em>SHA512<\/em> algorithm and this private hash key assigned to the <strong><u>hash<\/u><\/strong> POST field:-<\/p>\n<ul>\n<li><strong><u>txn_ref<\/u><\/strong><\/li>\n<li><strong><u>product_id<\/u><\/strong><\/li>\n<li><strong><u>pay_item_id<\/u><\/strong><\/li>\n<li><strong><u>amount<\/u><\/strong><\/li>\n<li><strong><u>site_redirect_url<\/u><\/strong><\/li>\n<li><strong><u>MacKey<\/u><\/strong><\/li>\n<\/ul>\n<p><img decoding=\"async\" loading=\"lazy\" class=\"alignnone wp-image-475 size-full\" src=\"http:\/\/sandbox.interswitchng.com\/docbase\/wp-content\/uploads\/2017\/06\/payment_hash.png\" alt=\"\" width=\"840\" height=\"47\" \/><\/p>\n<p>where \u2018+\u2019 represents string concatenation of values (i.e, \u201ca\u201d + \u201cb\u201d = \u201cab\u201d).<\/p>\n<p><strong>Please note the order of the parameters<\/strong>.<\/p>\n<p>Mac Key:-<\/p>\n<p>This is a 128 character alphanumeric string that is used to calculate the hash. It is usually provided when the merchant is about to Go Live (i.e start accepting real payments). For DEMO transactions, the following value should be used:-<\/p>\n<p><span style=\"color: #993300;\"><em>D3D1D05AFE42AD50818167EAC73C109168A0F108F32645C8B59E897FA930DA44F9230910DAC9E20641823799A107A02068F7BC0F4CC41D2952E249552255710F<\/em><\/span><\/p>\n<p>Please be wary of extra characters and spaces when working with the MAC Key and hash computation.<\/p>\n<p>&nbsp;<\/p>\n<h4>Hash Computation Example<\/h4>\n<p>For example for a transaction with the following field values &#8211;<\/p>\n<p>1) txn_ref \u2013 <span style=\"color: #800000;\">MYC_060616_31<\/span><\/p>\n<p>2) product_id &#8211; <span style=\"color: #339966;\">6205<\/span><\/p>\n<p>3) pay_item_id &#8211; <span style=\"color: #ff9900;\">101<\/span><\/p>\n<p>4) amount \u2013 <span style=\"color: #ff00ff;\">125000<\/span> (i.e \u20a61,250)<\/p>\n<p>5) site_redirect_url \u2013 <a href=\"http:\/\/www.mycompany.com\/response\/\"><span style=\"color: #ff0000;\">http:\/\/www.mycompany.com\/response\/<\/span><\/a><\/p>\n<p>6) MacKey &#8211;<\/p>\n<p><span style=\"color: #0000ff;\">D3D1D05AFE42AD50818167EAC73C109168A0F108F32645C8B59E897FA930DA44F9230910DAC9E20641823799A107A02068F7BC0F4CC41D2952E249552255710F<\/span><\/p>\n<p>&nbsp;<\/p>\n<p>String to be hashed =<\/p>\n<p><span style=\"color: #993300;\">MYC_060616_31<\/span><span style=\"color: #339966;\">6205<\/span><span style=\"color: #ff9900;\">101<\/span><span style=\"color: #ff00ff;\">125000<\/span><span style=\"color: #ff0000;\">http:\/\/www.mycompany.com\/response\/<\/span><span style=\"color: #0000ff;\">D3D1D05AFE42AD50818167EAC73C109168A0F108F32645C8B59E897FA930DA44F9230910DAC9E20641823799A107A02068F7BC0F4CC41D2952E249552255710F<\/span><\/p>\n<p>After computing value\u2026<\/p>\n<p>Hash =<br \/>\n<span style=\"color: #333399;\">79D9AC677F21A44D37D5993FD0E0BCB0FF633F18F82B6472CFD1B21EF26B00C79B4D5B4B7C8C7FD2794B11A77581EA3326B80A94307B9EB6548DE2BA77662088<\/span><\/p>\n<p>&nbsp;<\/p>\n<p>A good resource where you can check the hash you;re generating can be found at the link below-<\/p>\n<p><a href=\"http:\/\/www.convertstring.com\/Hash\/SHA512\">SHA 512 Generator<\/a><\/p>\n<p><img decoding=\"async\" loading=\"lazy\" class=\"alignnone wp-image-479 size-full\" src=\"http:\/\/sandbox.interswitchng.com\/docbase\/wp-content\/uploads\/2017\/06\/hash_computation-I.png\" alt=\"\" width=\"695\" height=\"604\" srcset=\"https:\/\/sandbox.interswitchng.com\/docbase\/wp-content\/uploads\/2017\/06\/hash_computation-I.png 695w, https:\/\/sandbox.interswitchng.com\/docbase\/wp-content\/uploads\/2017\/06\/hash_computation-I-300x261.png 300w\" sizes=\"(max-width: 695px) 100vw, 695px\" \/><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":283,"menu_order":2,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"doc_tag":[],"_links":{"self":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/291"}],"collection":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/comments?post=291"}],"version-history":[{"count":5,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/291\/revisions"}],"predecessor-version":[{"id":1818,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/291\/revisions\/1818"}],"up":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/283"}],"next":[{"title":"Sample Response & Fields","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/webpay\/payment-transaction-leg\/sample-response-fields\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/293"}],"prev":[{"title":"HTTP POST Form Fields","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/webpay\/payment-transaction-leg\/http-post-form-fields\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/289"}],"wp:attachment":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/media?parent=291"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/doc_tag?post=291"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}