---- dataentry gateway ----
type                   : gateway # do not change this line
name                   : Trust Payments # 
countries              : GB # 
support-added          : 0.7.2 # 
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.trustpayments.com/ # 
----



====== Trust Payments ======
===== Setting Up Trust Payments for FoxyCart =====
Input Merchant Username, Merchant Password and Site Reference in the appropriate fields in the FoxyCart admin.

If you are using 3D Secure, you can set ''3D secure options'' to ''Enabled''. You'll need to generate within your Trust Payments account the ''JWT Username'' and ''JWT Secret'' and enter them into the Foxy admin's additional Fields on the Trust Payments gateway settings. These fields were previously labeled ''issuer'' and ''encryption key'' in the Foxy admin, respectively, so if you see those labels, you can enter the JWT credentials there.

<wrap important>**Important:** The FoxyCart IP address range must be added</wrap> or transactions will fail to process correctly.

FoxyCart's current IP's are as follows:
    * **IP:** ''54.243.60.3''
    * **IP:** ''54.152.220.165''
    * **IP:** ''204.13.109.11''
    * **IP:** ''199.204.138.214''
    * **IP:** ''199.79.51.69''

You add this to the "Valid IP/network(s)" field within your MyST configuration for the username settings that you're entering into FoxyCart:

{{:gateways:screen_shot_2015-02-18_at_12.43.23_pm.png?nolink&200|}}

The IP's can be entered as comma separated values like this: ''54.243.60.3,54.152.220.165,204.13.109.11,199.204.138.214,199.79.51.69''

<wrap important>**Important:** You will not want Dynamic Currency Conversion (dcc) enabled on your account</wrap>. By default this should not be enabled, but if it is, then payments will fail with an invalid field error.
===== Testing =====
==== Obtaining a Test Account ====
https://www.trustpayments.com/contact-us/
==== Test Card Numbers ====
https://docs.trustpayments.com/document/testing/

===== Troubleshooting & Interpreting Response Codes =====
https://www.trustpayments.com/contact-us/



===== Important Notes and Caveats =====

=== 401 Authorization Required Error ===

If you receive a 401 error when trying to complete a test transaction, and you've triple checked that the username and password you've entered into FoxyCart is correct, you will need to contact SecureTrading to ask for a username for your account that has correct access for web services. You'll need to use the new username provided by SecureTrading than the one you currently have plugged into FoxyCart.

=== Invalid field (30000): dcccurrencyiso3a ===

If you see this error when attempting to complete a purchase, you will need to reach out to the Trust Payments team and request that they disable Dynamic Currency Conversion (dcc) on your account. Foxy has native currency conversion functionality, and so does not integrate with Secure Trading's conversion functionality.
===== 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.