If you’re upgrading from an Artisan POS version older than 4.9.175, we recommend that you review these procedures before (or soon after) you upgrade, so you know what to expect. Many of the details have changed.<\/p>\n\n\n\n
The rest of this article assumes you’re using Artisan 4.9.175 or later.<\/p>\n\n\n\n
Payment Status Menu<\/h2>\n\n\n\n
In general, you will now be presented with the following Payment Status Menu<\/em><\/strong> whenever Artisan POS doesn’t receive a response from the PIN Pad (or payment processing software like NETePay or Paygistix Client), or receives a response indicating a Communications Error further up the line. In such cases, Artisan can’t tell whether or not the transaction went through successfully.<\/p>\n\n\n\n There are three possible realities.<\/p>\n\n\n\n All of these are reported as communications errors. In many cases, Artisan POS can’t determine which of these cases actually occurred, so it requires assistance from a user. In earlier versions of Artisan POS, there was no way for the user to indicate which of these realities had occurred, and Artisan POS had to assume that the transaction had not been <\/span>processed. Unfortunately, this often resulted in duplicate charges, as users would run the card again, even though it might have already been processed.<\/p>\n\n\n\n The only way to know for sure what happened was to contact the processor via your Processing Portal<\/strong> or by phone and determine the actual status of the transaction.<\/p>\n\n\n\n A Processing Portal<\/strong> is a website that allows merchants to log in and view transactions. Sometimes a portal may also allow you to enter new charges and credits. These portals are provided by your processor and\/or Datacap, the company that serves as the backbone for a number of integrated payment processing methods.<\/p>\n\n\n\n Before picking a choice from the Payment Status Menu, it’s critical that you check your merchant account portal, or otherwise contact your merchant account provider (sometimes known as your “processor”), to determine the actual<\/span><\/em> status.<\/p>\n\n\n\n There are five choices in the menu. Choose the one that best describes the status of the transaction.<\/p>\n\n\n\n If you choose Approved<\/em><\/strong> or Unknown<\/em><\/strong>, you’ll be asked to confirm that you’re really sure.<\/p>\n\n\n\n If you chose Approved<\/em><\/strong>, you’ll also be prompted to enter the Approval Code for the transaction. In most cases, the Approval Code will be available from your payment portal, though you may have to dig into the transaction details.<\/p>\n\n\n\n If you were unable to obtain the Approval Code (a.k.a. Auth Code), you can leave it blank and Artisan will use “**OK**”, after an additional confirmation.<\/p>\n\n\n\n If you look in the details of a Payment Log (“CC Log”) entry, you can tell that it was manually verified with the Payment Status Menu by looking at the Response Summary. It will start with “Verified Externally”, the name of the user who authorized<\/strong><\/em> this verification (which might be different than the cashier who was processing the payment), and the name of the specific status that was selected in the menu.<\/p>\n\n\n\n If “Unknown” was chosen, the Response Summary will show the actual error, but the status (in “Action \/ Status”) will show as “(None)”.<\/p>\n\n\n\n Some processing methods (see below) support payment processing queries<\/em><\/strong>. Artisan POS<\/em> will use these after a communications error to automatically check if the transaction has been processed, distinguishing between the three “realities” above, without having to ask the user. Unless the query itself also has a communication failure (after four tries), you won’t see the Payment Status menu in these cases.<\/p>\n\n\n\n Review your Payment Processing Settings to confirm which processing method you’re currently using. In Artisan POS<\/em>, on a sales station that accepts payment cards, click Tools, then Program Options, and select Business & Financial, followed by Payment Processing Settings, as shown below. <\/p>\n\n\n\n Queries will be used (if needed) if the Processing Method is WildsPay, Edge HostPay (deprecated), Innovo Gateway (also deprecated), or DC Direct<\/strong>. They will also be used with other Datacap processing methods (NETePay<\/strong> and TranCloud<\/strong>) if they’re in “Hosted Bridge<\/strong>“<\/em> mode (which communicates with the Datacap gateway rather than directly to payment processors like TSYS and First Data), which will have letters in the Merchant ID and will show an “API Key” field. Queries are also used with TranCloud<\/strong> “Classic<\/strong>“<\/em> (that is, not<\/span> Hosted<\/em>) unless using a Direct Connection, as indicated by an “@” after the Device ID in the “TranCloud Device ID” field.<\/p>\n\n\n\n If you’re using a processing method that does not<\/em> support queries, or if several query attempts all also fail, then you’ll be presented with the Payment Status Menu (unless it’s completely disabled by the security settings below).<\/p>\n\n\n\n If you’re using one of the Datacap methods mentioned above, you’ll need to initially set up your API Key in your Payment Processing Settings. See this article for details:<\/p>\n\n\n\n Configuring Datacap API Keys<\/a><\/p>\n\n\n\n Suppose you feel that you can’t depend on your staff to answer this question correctly, perhaps because they don’t have access to your merchant account portal. In that case, you can use the Financial Task Setting for “Manually Verifying Credit Card Payment Status” to control which user levels can authorize selection of specific payment statuses from the menu (or confirm voids). Leaving the payment status as Unknown does not require authorization.<\/p>\n\n\n\n The payment processing log will clearly show which transactions were verified externally, with a Response Summary like, “Externally Verified by David: Transaction Was Approved”, which lists the selected status and the user who authorized<\/em><\/strong> that status choice. (The “Clerk” field, as usual, lists the cashier<\/em><\/strong> who initiated the payment.)<\/p>\n\n\n\n To disable the Payment Status Menu entirely, you can set the above task setting to “Not Allowed”. In that case, the menu will not be presented, and the status will be Unknown (displayed as “(none)” in the Payment Log). You also won’t get the “void confirmation” dialog.<\/p>\n\n\n\n It is neither normal nor acceptable to have frequent errors. Recently, we have seen an uptick in these occurrences, which have usually been resolved by ensuring the following points.<\/p>\n\n\n\n The techniques above are designed to handle intermittent communications failures. Sometimes, though, your Internet connection goes out for an extended period (planned or unplanned). You should prepare for this possibility and have a backup plan for processing payments. Here are a few options to consider:<\/p>\n\n\n\n Overview – Concepts Integrated payment processing (credit cards, debit cards, etc.) in Artisan POS is normally seamless and straightforward to use, once it’s all set up. However, when Internet, local network (LAN), PIN pad, or software communication errors or outages occur while processing a payment, it can get a bit…<\/p>\n","protected":false},"author":11,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_eb_attr":"","_monsterinsights_skip_tracking":false,"footnotes":"","_members_access_role":[],"_members_access_error":""},"ht-kb-category":[298,322],"ht-kb-tag":[414,419,420,421],"class_list":["post-22600","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-payment-processing","ht_kb_category-payment-processing-accounting","ht_kb_tag-payment-processing","ht_kb_tag-api-key","ht_kb_tag-configuration","ht_kb_tag-communications"],"_links":{"self":[{"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/ht-kb\/22600","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/users\/11"}],"replies":[{"embeddable":true,"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/comments?post=22600"}],"version-history":[{"count":37,"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/ht-kb\/22600\/revisions"}],"predecessor-version":[{"id":22725,"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/ht-kb\/22600\/revisions\/22725"}],"wp:attachment":[{"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/media?parent=22600"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/ht-kb-category?post=22600"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/ht-kb-tag?post=22600"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}![\"\"](\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2025\/05\/2025-05-27_15h53_46.png\")
<\/a><\/figure>\n\n\n\n\n
Understanding the Options<\/h2>\n\n\n\n
\n
You know that the transaction was successful because you checked your portal, phoned the processor, or confirmed with an app on the customer’s phone.<\/li>\n\n\n\n
You know that the transaction was denied for any number of reasons because you checked your portal or phoned the processor.<\/li>\n\n\n\n
You voided the transaction through your portal or by phoning the processor.<\/li>\n\n\n\n
You confirmed that the processor had never received the transaction because you checked with your portal, or you phoned the processor.<\/li>\n\n\n\n
You are unable to log into the portal, or you don’t know or don’t have time to find out what really happened. This option maintains the same behavior as before, and it will not allow you to save the sale until you add another payment. After processing the transaction again, you should confirm with your processor and then void any duplicates.<\/li>\n<\/ul>\n\n\n\n<\/a><\/figure>\n\n\n\n<\/a><\/figure>\n\n\n\n<\/a><\/figure>\n\n\n\nIdentifying Manually-Verified Payments<\/h2>\n\n\n\n
Automatic Queries<\/h2>\n\n\n\n
Does My Processing Method Support Queries?<\/h2>\n\n\n\n
<\/a>Now, look at the Payment Processing Method.<\/p>\n\n\n\n<\/a><\/figure>\n\n\n\nConfiguring Datacap API Keys<\/h2>\n\n\n\n
Security Controls for Manual Verifications<\/h2>\n\n\n\n
<\/a><\/figure>\n\n\n\nAvoiding Communication Errors in the First Place<\/h2>\n\n\n\n
\n
Intermittent Failures vs. Full Internet Outages<\/h2>\n\n\n\n
\n
<\/a><\/h2>\n","protected":false},"excerpt":{"rendered":"