---- dataentry gateway ----
type                   : gateway # do not change this line
name                   : Handepay
countries              : GB
support-added          : 2.0
support-removed        : 
auth-net-emulation     : no # enter "yes" or "no" (without quotes)
supports-3dsecure      : yes # enter "yes" or "no" (without quotes)
supports-multicurrency : yes # enter "yes" or "no" (without quotes)
gateway_url            : https://www.handepay.co.uk/online-payments/payment-gateway/
----






====== handepay ======
===== Setting Up handepay for FoxyCart =====

  * Go to the Foxy admin at https://admin.foxy.io, log in, and select your store if needed.
  * Go to "Settings-->Payments" and select the Payment method set to add it to.
  * Under "Payment methods", click "Add payment method +".
  * Select Handepay. If it is unavailable to select, you may need to disable (Remove) your current credit card gateway. Hosted payment methods may remain.
  * Enter Handepay Merchant ID. **(Required)**
  * Enter Handepay Pre Shared Key. **(Required)**
  * Click "Create"

===== Advanced Features =====
FoxyCart can pass along an optional `orderRef` number, supplied by the customer or an integration on the checkout page. This value will show up in the Handepay backend. To take advantage of this, pass in a ''name="gateway_order_reference" value="foo"'' value in the checkout form (replacing ''foo'' with your desired value). One way to do this is through the Custom Checkout Fields option in the **templates configuration** settings of the Foxy admin.


===== Testing =====
==== Obtaining a Test Account ====
Handepay has test merchant IDs and card numbers that you can use to test ordering. [[https://www.handepay.co.uk/help-and-support/welcome/|Contact their support]] for additional resources.

==== Test Card Numbers ====
These belong to Cardstream but they work with Handepay as well https://support.cardstream.com/hc/en-gb/articles/360011889898-Test-Cards

===== Troubleshooting & Interpreting Response Codes =====
Details on different response and error codes [[https://support.cardstream.com/hc/en-gb/sections/360003533337-Error-Codes|can be reviewed here]]. While these error codes are for Cardstream, they should also apply for Handepay.


===== Important Notes and Caveats =====
If you have any questions for Handepay, they can be contacted at [[https://www.handepay.co.uk/help-and-support/welcome]].


===== User Notes and Experiences =====
<wrap tip>If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date.</wrap> We reserve the right to edit or remove comments that don't add value to this page.