| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| gateways:authorize.net [2019/08/03 23:06] – marija | gateways:authorize.net [2023/05/18 11:04] (current) – [Ensure Authorize.Net Test Mode is turned off] adam |
|---|
| ---- dataentry gateway ---- | ---- dataentry gateway ---- |
| type : gateway # do not change this line | type : gateway # do not change this line |
| name : Authorize.net (AIM) # | name : Authorize.net (AIM) |
| countries : US # | countries : US, CA, GB, AU |
| support-added : 0.2.0 # | support-added : 0.2.0 |
| support-removed : # | support-removed : |
| supports-3dsecure: no # | supports-3dsecure : no |
| supports-multicurrency : # enter "yes" or "no" (without quotes) | supports-multicurrency : # enter "yes" or "no" (without quotes) |
| gateway_url : https://account.authorize.net/ui/themes/anet/oauth/PricingPage.aspx?resellerID=72636&profiletypeid=2 # | gateway_url : https://account.authorize.net/ui/themes/anet/oauth/PricingPage.aspx?resellerID=72636&profiletypeid=2 |
| ---- | ---- |
| | |
| |
| |
| - Set up [[http://reseller.authorize.net/application/72636/|an Authorize.net account]] | - Set up [[http://reseller.authorize.net/application/72636/|an Authorize.net account]] |
| - Log into your Authorize.net account | - Log into your Authorize.net account |
| | - If you're intending to start taking live orders from customers, ensure your Authorize.Net account is not in Test Mode (see below for more details on that). |
| - Under your Account settings, click on Settings | - Under your Account settings, click on Settings |
| - Under "Security Settings", choose "API Login ID and Transaction Key" | - Under "Security Settings", choose "API Login ID and Transaction Key" |
| - Acquire your Authorize.net API ID. If one is not visible (which is sometimes the case), you can use your Authorize.net login username in its place. | - Acquire your Authorize.net API ID. If one is not visible (which is sometimes the case), you can use your Authorize.net login username in its place. |
| - Set the live/test radio button selection to Live (unless you're setting up your own test account). | - Set the live/test radio button selection to Live (unless you're setting up your own test account). |
| - Log in to the Foxy administration and proceed to the payment gateway settings. Within the "Let customers pay with a Credit or Debit Card" option, select "Authorize.Net". Enter the two values you copied from your Authorize.Net account, the Transaction Key and API ID (or Authorize.net login username) and save. | - Log in to the Foxy administration and proceed to the [[https://admin.foxycart.com/admin.php?ThisAction=EditPaymentGateway|payment gateway]] settings. Within the "Let customers pay with a Credit or Debit Card" option (check the box if unchecked), select "Authorize.Net" from the //bank card payment method// dropdown. Enter the two values you copied from your Authorize.Net account, the Transaction Key and API ID (or Authorize.net login username) and save. |
| - If your store needs to verify that the credit card is valid for certain amounts, you can set the (live or test) //card verification mode:// field. This feature's use is if you want to save a credit card for the customer and verify that it's valid, but not charge it at the time of entry. See the <wrap hi>?</wrap> to the right of the field for help on options. | - If your store needs to verify that the credit card is valid for certain amounts, you can set the (live or test) //card verification mode:// field. This feature's use is if you want to save a credit card for the customer and verify that it's valid, but not charge it at the time of entry. See the <wrap hi>?</wrap> to the right of the field for help on options. |
| - TEST. | - TEST. |
| - If you're doing international sales, make sure you configure your AVS settings, as described below. | - If you're doing international sales, make sure you configure your AVS settings, as described below. |
| | |
| | ==== Authorize.Net Test Mode ==== |
| | |
| | If you are taking your Authorize.Net account live, you will need to make sure that Test Mode is turned off within your Authorize.Net account. This setting defaults to on for all new accounts, and if left on, will result in no payments being taken from customers even though your Foxy payment settings are set to live payment servers. If your account is in test mode, you should see an orange banner that says "Your account is in TEST MODE" at the top of the Authorize.Net administration. |
| | |
| | You can [[https://support.authorize.net/knowledgebase/Knowledgearticle/?code=000001314|see instructions on how to turn off Test Mode within your Authorize.Net account on their website here]]. |
| |
| ==== Turning off your Authorize.net Email Receipt ==== | ==== Turning off your Authorize.net Email Receipt ==== |
| Make sure you at least give this a look when using Authorize.net. Many non-US banks don't support AVS, and Authorize.net's default settings reject cards from banks that don't support it. This may not be the behavior you want, so please make sure you understand what all the information on this page means. If you leave it as is, you'll likely be rejecting many international orders. | Make sure you at least give this a look when using Authorize.net. Many non-US banks don't support AVS, and Authorize.net's default settings reject cards from banks that don't support it. This may not be the behavior you want, so please make sure you understand what all the information on this page means. If you leave it as is, you'll likely be rejecting many international orders. |
| |
| If you're //not// a high-risk target for fraudulent orders you can uncheck most of the checkboxes. Many merchants leave "B" as the only box checked and don't have issues, though checking B, E, R, and N is probably a good idea. Every business is different so we recommend exploring the settings and only checking the boxes you //want// checked. Keep an eye on your store's error log to catch problems and adjust your AVS settings to resolve them, if necessary. If you anticipate many international orders you'll likely want to relax the AVS settings significantly. More on [[http://developer.authorize.net/faqs/#global|Authorize.net's FAQ]]. | If you're //not// a high-risk target for fraudulent orders you can allow most of the options. Many merchants leave "B" as the only decline option and don't have issues, though declining B, E, R, and N is probably a good idea. Every business is different so we recommend exploring the settings and only decline the options you //want// declined. Keep an eye on your store's error log to catch problems and adjust your AVS settings to resolve them, if necessary. If you anticipate many international orders you'll likely want to relax the AVS settings significantly. More on [[http://developer.authorize.net/faqs/#global|Authorize.net's FAQ]]. |
| |
| If you //are// a high-risk target for fraud, or you're experiencing a lot of it, you probably want to check B, E, R, U, S, and N, and give serious consideration to G. | If you //are// a high-risk target for fraud, or you're experiencing a lot of it, you probably want to set to Decline B, E, R, U, S, and N, and give serious consideration to G. |
| |
| ==== Configuring your CSC (Card Security Code) Settings ==== | ==== Configuring your CSC (Card Security Code) Settings ==== |
| From your "Settings" page, click the "Card Code Verification" link under "Security Settings", and make sure all the checkboxes are unchecked. If you need to check any of these options, please ensure that you understand that FoxyCart's may sometimes send transactions without the CSC. More information is on the [[.:start|payment gateway overview]] page. | From your "Settings" page, click the "Card Code Verification" link under "Security Settings", and make sure all the options except for N are allowed. If you need to set any of these options other than N to decline, please ensure that you understand that FoxyCart's may sometimes send transactions without the CSC. More information is on the [[.:start|payment gateway overview]] page. |
| |
| | You should also ensure that the //Card Code// field on the //Form Fields// setting is unchecked. To to that, go to "Settings" in your Authorize.net account, click on "Payment Form" then select "Form Fields". On this settings page ensure that the "required" checkbox is //not// checked for "Card Code" and save. |
| ==== Configuring your Phone fields ==== | ==== Configuring your Phone fields ==== |
| Make sure you check whether or not your Authorize.net account is configured to require the customer phone number. If it is, you'll need to make that a required field on your checkout. For store's on Foxy 2.0, you can do that from the "configuration" section of the administration in the "Customize which checkout fields are shown and required" option. For store's on version 1.1 or older, [[snippets:checkout:making_checkout_fields_required|you can use this snippet]]. | Make sure you check whether or not your Authorize.net account is configured to require the customer phone number. If it is, you'll need to make that a required field on your checkout. For store's on Foxy 2.0, you can do that from the "configuration" section of the administration in the "Customize which checkout fields are shown and required" option. For store's on version 1.1 or older, [[snippets:checkout:making_checkout_fields_required|you can use this snippet]]. |
| |
| ===== Troubleshooting & Interpreting Response Codes ===== | ===== Troubleshooting & Interpreting Response Codes ===== |
| [[http://developer.authorize.net/tools/responsereasoncode/|Response Reason Codes and Response Reason Text]] is the authoritative source for descriptions and explanations of Authorize.net reason response codes. | [[https://developer.authorize.net/api/reference/responseCodes.html|Response Reason Codes and Response Reason Text]] is the authoritative source for descriptions and explanations of Authorize.net reason response codes. |
| |
| === Response Reason Code: 103 === | === Response Reason Code: 103 === |
