{"id":117,"date":"2021-07-21T15:41:41","date_gmt":"2021-07-21T15:41:41","guid":{"rendered":"https:\/\/payb.co.uk\/integration-guide\/?p=117"},"modified":"2021-07-21T15:41:41","modified_gmt":"2021-07-21T15:41:41","slug":"appendix-1-gateway-response-status-codes","status":"publish","type":"post","link":"https:\/\/payb.co.uk\/integration-guide\/hosted-payment-form\/appendix-1-gateway-response-status-codes\/","title":{"rendered":"Appendix 1: Gateway Response Status Codes"},"content":{"rendered":"<p>Below are the status codes likely to be received when integrating with the gateway.<\/p>\n<table border=\"1\" width=\"612\" cellspacing=\"0\" cellpadding=\"0\">\n<tbody>\n<tr valign=\"TOP\">\n<td bgcolor=\"#b8cce2\" width=\"80\" height=\"35\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">Status<\/span><\/span><\/p>\n<p><span style=\"font-size: medium;\"><span style=\"font-size: small;\">Code<\/span><\/span><\/td>\n<td bgcolor=\"#b8cce2\" width=\"135\">\n<p align=\"CENTER\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">Transaction<\/span> <span style=\"font-size: small;\">Result<\/span><\/span><\/p>\n<\/td>\n<td bgcolor=\"#b8cce2\" width=\"396\">\n<p align=\"CENTER\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">Description<\/span><\/span><\/p>\n<\/td>\n<\/tr>\n<tr valign=\"TOP\">\n<td width=\"80\" height=\"71\">&nbsp;<\/p>\n<p align=\"CENTER\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">0<\/span><\/span><\/p>\n<\/td>\n<td width=\"135\">&nbsp;<\/p>\n<p align=\"CENTER\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">Successful<\/span><\/span><\/p>\n<\/td>\n<td width=\"396\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\"><strong>Transaction<\/strong><\/span> <span style=\"font-size: small;\"><strong>Authorised:<\/strong><\/span><\/span><\/p>\n<p><span style=\"font-size: medium;\"><span style=\"font-size: small;\">The transaction was successful and you will be given an<\/span> <span style=\"font-size: small;\">Authorisation<\/span> <span style=\"font-size: small;\">Code as<\/span> <span style=\"font-size: small;\">part<\/span> <span style=\"font-size: small;\">of<\/span> <span style=\"font-size: small;\">the<\/span> <span style=\"font-size: small;\">message returned<\/span> <span style=\"font-size: small;\">by the<\/span><\/span><\/p>\n<p><span style=\"font-size: medium;\"><span style=\"font-size: small;\">gateway.<\/span><\/span><\/td>\n<\/tr>\n<tr valign=\"TOP\">\n<td width=\"80\" height=\"90\">&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p align=\"CENTER\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">3<\/span><\/span><\/p>\n<\/td>\n<td width=\"135\">&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p align=\"CENTER\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">Incomplete<\/span><\/span><\/p>\n<\/td>\n<td width=\"396\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\"><strong>Transaction Awaiting 3D Secure Authentication:<\/strong><\/span> <span style=\"font-size: small;\">Transaction<\/span> <span style=\"font-size: small;\">is<\/span> <span style=\"font-size: small;\">now<\/span> <span style=\"font-size: small;\">awaiting<\/span> <span style=\"font-size: small;\">3D<\/span> <span style=\"font-size: small;\">Secure<\/span> <span style=\"font-size: small;\">Authentication<\/span> <span style=\"font-size: small;\">from<\/span> <span style=\"font-size: small;\">the<\/span> <span style=\"font-size: small;\">customer. This status has a 2 hour expiry time set by the card<\/span> <span style=\"font-size: small;\">scheme,<\/span> <span style=\"font-size: small;\">at<\/span> <span style=\"font-size: small;\">which<\/span> <span style=\"font-size: small;\">point,<\/span> <span style=\"font-size: small;\">the<\/span> <span style=\"font-size: small;\">transaction<\/span> <span style=\"font-size: small;\">will<\/span> <span style=\"font-size: small;\">fail<\/span> <span style=\"font-size: small;\">(Issuer<\/span><\/span><\/p>\n<p><span style=\"font-size: medium;\"><span style=\"font-size: small;\">Authentication<\/span> <span style=\"font-size: small;\">Expired).<\/span><\/span><\/td>\n<\/tr>\n<tr valign=\"TOP\">\n<td width=\"80\" height=\"71\">&nbsp;<\/p>\n<p align=\"CENTER\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">4<\/span><\/span><\/p>\n<\/td>\n<td width=\"135\">&nbsp;<\/p>\n<p align=\"CENTER\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">Referred<\/span><\/span><\/p>\n<\/td>\n<td width=\"396\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\"><strong>Transaction<\/strong><\/span> <span style=\"font-size: small;\"><strong>Referred:<\/strong><\/span><\/span><\/p>\n<p><span style=\"font-size: medium;\"><span style=\"font-size: small;\">The<\/span> <span style=\"font-size: small;\">card<\/span> <span style=\"font-size: small;\">issuer<\/span> <span style=\"font-size: small;\">has<\/span> <span style=\"font-size: small;\">parked<\/span> <span style=\"font-size: small;\">the<\/span> <span style=\"font-size: small;\">transaction<\/span> <span style=\"font-size: small;\">awaiting<\/span> <span style=\"font-size: small;\">contact<\/span> <span style=\"font-size: small;\">with<\/span> <span style=\"font-size: small;\">the<\/span> <span style=\"font-size: small;\">customer<\/span> <span style=\"font-size: small;\">before proceeding<\/span> <span style=\"font-size: small;\">to<\/span> <span style=\"font-size: small;\">authorise<\/span> <span style=\"font-size: small;\">or<\/span> <span style=\"font-size: small;\">decline<\/span> <span style=\"font-size: small;\">the<\/span><\/span><\/p>\n<p><span style=\"font-size: medium;\"><span style=\"font-size: small;\">transaction.<\/span><\/span><\/td>\n<\/tr>\n<tr valign=\"TOP\">\n<td width=\"80\" height=\"179\">&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p align=\"CENTER\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">5<\/span><\/span><\/p>\n<\/td>\n<td width=\"135\">&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p align=\"CENTER\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">Declined<\/span><\/span><\/p>\n<\/td>\n<td width=\"396\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\"><strong>Transaction<\/strong><\/span> <span style=\"font-size: small;\"><strong>Failed:<\/strong><\/span><\/span><\/p>\n<p><span style=\"font-size: medium;\"><span style=\"font-size: small;\">The transaction was declined by the card issuer or acquiring<\/span> <span style=\"font-size: small;\">bank. In the event of the Address or CV2 verification failure, this<\/span> <span style=\"font-size: small;\">will also be noted on the message from the gateway (Example,<\/span> <span style=\"font-size: small;\">\u201cCard declined: AVS policy + CV2 policy\u201d). If the message given<\/span> <span style=\"font-size: small;\">by the gateway only says \u201cCard declined\u201d with no other<\/span> <span style=\"font-size: small;\">information, then no other information was given to us from the<\/span> <span style=\"font-size: small;\">card<\/span> <span style=\"font-size: small;\">issuer<\/span> <span style=\"font-size: small;\">or<\/span> <span style=\"font-size: small;\">acquiring<\/span> <span style=\"font-size: small;\">bank<\/span> <span style=\"font-size: small;\">as to<\/span> <span style=\"font-size: small;\">the underlying<\/span> <span style=\"font-size: small;\">reason why.<\/span><\/span><\/p>\n<p><span style=\"font-size: medium;\"><span style=\"font-size: small;\">The only person who can find out why the transaction was<\/span> <span style=\"font-size: small;\">declined<\/span> <span style=\"font-size: small;\">is the<\/span> <span style=\"font-size: small;\">customer<\/span> <span style=\"font-size: small;\">by contacting<\/span> <span style=\"font-size: small;\">their<\/span> <span style=\"font-size: small;\">bank<\/span> <span style=\"font-size: small;\">directly.<\/span><\/span><\/td>\n<\/tr>\n<tr valign=\"TOP\">\n<td width=\"80\" height=\"89\">&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p align=\"CENTER\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">20<\/span><\/span><\/p>\n<\/td>\n<td width=\"135\">&nbsp;<\/p>\n<p><span style=\"font-size: medium;\"><span style=\"font-size: small;\">Duplicate<\/span> <span style=\"font-size: small;\">Transaction<\/span><\/span><\/td>\n<td width=\"396\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">The<\/span> <span style=\"font-size: small;\">transaction<\/span> <span style=\"font-size: small;\">which<\/span> <span style=\"font-size: small;\">was<\/span> <span style=\"font-size: small;\">processed<\/span> <span style=\"font-size: small;\">was<\/span> <span style=\"font-size: small;\">a<\/span> <span style=\"font-size: small;\">duplicate.<\/span> <span style=\"font-size: small;\">If<\/span> <span style=\"font-size: small;\">this<\/span> <span style=\"font-size: small;\">is<\/span> <span style=\"font-size: small;\">the<\/span> <span style=\"font-size: small;\">case, then the original transaction information is also passed back<\/span> <span style=\"font-size: small;\">from the gateway so you can determine the result of the original<\/span> <span style=\"font-size: small;\">transaction. Please refer to your respective integration method<\/span> <span style=\"font-size: small;\">documentation<\/span> <span style=\"font-size: small;\">form<\/span> <span style=\"font-size: small;\">more<\/span> <span style=\"font-size: small;\">information.<\/span><\/span><\/td>\n<\/tr>\n<tr valign=\"TOP\">\n<td width=\"80\" height=\"124\">&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p align=\"CENTER\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\">30<\/span><\/span><\/p>\n<\/td>\n<td width=\"135\">&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p><span style=\"font-size: medium;\"><span style=\"font-size: small;\">Failed<\/span> <span style=\"font-size: small;\">(Error(s)<\/span> <span style=\"font-size: small;\">Occurred)<\/span><\/span><\/td>\n<td width=\"396\"><span style=\"font-size: medium;\"><span style=\"font-size: small;\"><strong>Transaction<\/strong><\/span> <span style=\"font-size: small;\"><strong>Failed:<\/strong><\/span><\/span><\/p>\n<p><span style=\"font-size: medium;\"><span style=\"font-size: small;\">This is usually an indicator that the integration to the gateway is<\/span> <span style=\"font-size: small;\">incomplete and\/or not working correctly. There will also be<\/span> <span style=\"font-size: small;\">additional error information feedback from the gateway for<\/span> <span style=\"font-size: small;\">merchants to determine what the error is specifically. Please<\/span> <span style=\"font-size: small;\">refer<\/span> <span style=\"font-size: small;\">to<\/span> <span style=\"font-size: small;\">your respective integration<\/span> <span style=\"font-size: small;\">methods<\/span> <span style=\"font-size: small;\">documentation<\/span> <span style=\"font-size: small;\">for<\/span><\/span><\/p>\n<p><span style=\"font-size: medium;\"><span style=\"font-size: small;\">more<\/span> <span style=\"font-size: small;\">information.<\/span><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h1 class=\"western\" align=\"CENTER\"><\/h1>\n","protected":false},"excerpt":{"rendered":"<p>Below are the status codes likely to be received when integrating with the gateway. Status Code Transaction Result Description &nbsp; 0 &nbsp; Successful Transaction Authorised: The transaction was successful and you will be given an Authorisation Code as part of the message returned by the gateway. &nbsp; &nbsp; 3 &nbsp; &nbsp; Incomplete Transaction Awaiting 3D&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[4,30],"tags":[],"_links":{"self":[{"href":"https:\/\/payb.co.uk\/integration-guide\/wp-json\/wp\/v2\/posts\/117"}],"collection":[{"href":"https:\/\/payb.co.uk\/integration-guide\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/payb.co.uk\/integration-guide\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/payb.co.uk\/integration-guide\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/payb.co.uk\/integration-guide\/wp-json\/wp\/v2\/comments?post=117"}],"version-history":[{"count":1,"href":"https:\/\/payb.co.uk\/integration-guide\/wp-json\/wp\/v2\/posts\/117\/revisions"}],"predecessor-version":[{"id":118,"href":"https:\/\/payb.co.uk\/integration-guide\/wp-json\/wp\/v2\/posts\/117\/revisions\/118"}],"wp:attachment":[{"href":"https:\/\/payb.co.uk\/integration-guide\/wp-json\/wp\/v2\/media?parent=117"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/payb.co.uk\/integration-guide\/wp-json\/wp\/v2\/categories?post=117"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/payb.co.uk\/integration-guide\/wp-json\/wp\/v2\/tags?post=117"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}