Documentation You are here: start » gateways » opayo

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
gateways:opayo [2020/12/18 14:10] – [Additional Configuration For Subscriptions & Customer-Not-Present Transactions] adamgateways:opayo [2023/07/11 18:52] (current) – [Opayo by Evalon] marija
Line 12: Line 12:
  
  
-====== Opayo by Evalon ======+====== Opayo by Elavon ======
  
 ===== Setting up Opayo ===== ===== Setting up Opayo =====
Line 23: Line 23:
   - Get your admin password for Opayo - You will be given a link to click on to get your password   - Get your admin password for Opayo - You will be given a link to click on to get your password
   - Login to Opayo (Test) using the admin password supplied: https://test.sagepay.com/MySagePay/    - Login to Opayo (Test) using the admin password supplied: https://test.sagepay.com/MySagePay/ 
-  - Create a new user in your account - this will enable you to perform tests and will be valid only for testing purposes (you'll need to do this again when you go Live)  +  - Create a new user in your Opayo account (within Settings > Users) - this will enable you to perform tests and will be valid only for testing purposes (you'll need to do this again when you go Live). For the "Account Privileges" select "View All Transactions", and for "My Sage Pay Access" select "Search". 
-  -  Add the following IP addresses to your "Valid IP Address" section (or a comparably named section): \\ * **IP:** 54.152.220.165 \\ **Subnet Mask:** 255.255.255.255 +  -  Add the following IP addresses to your "Valid IPs" section (or a comparably named section): \\ * **IP:** ''54.243.60.3'' \\ * **IP:** ''54.152.220.165'' \\ **Subnet Mask:** ''255.255.255.255'' 
-  - Complete your integration with Opayo in the Foxycart STORE > payment section. (Select Opayo as the Bank card payment method and enter your vendor name. Make sure the servers are set to TEST at this stage)+  - Complete your integration with Opayo in the Foxy administration, on the "payment" section. Make sure the payment servers are set to "Test Servers" at this stage. 
 +  - Enable the "Let customers pay with a Credit or Debit Card" option and select "Opayo" in the dropdown and enter your vendor name in the "vendor" field, and the username and password for the //new// user you created in Opayo (and **not** your "root" user) in the matching fields in the Foxy payment settings.
   - Your 3D Secure setting should match what's set in your Opayo account settings   - Your 3D Secure setting should match what's set in your Opayo account settings
   - Process a test transaction through your website using the Opayo test card numbers https://www.opayo.co.uk/support/12/36/test-card-details-for-your-test-transactions   - Process a test transaction through your website using the Opayo test card numbers https://www.opayo.co.uk/support/12/36/test-card-details-for-your-test-transactions
   - Perform a refund - before you can go Live you must refund one of your successful test transactions https://www.opayo.co.uk/support/test-your-integration/refund-your-test-transaction   - Perform a refund - before you can go Live you must refund one of your successful test transactions https://www.opayo.co.uk/support/test-your-integration/refund-your-test-transaction
-  - Going Live - As soon as your testing is complete and your acquiring bank has confirmed your Merchant ID, your account will automatically be set to Live. Opayo will let you know when this has happened. You will then need to direct your website from the Test server to our Live server. + 
 +==== Going Live ==== 
 + 
 +As soon as your testing is complete and your acquiring bank has confirmed your Merchant ID, your account will automatically be set to Live. Opayo will let you know when this has happened. You can then complete the final steps of integration: 
 + 
   - Login to Opayo (Live) using your original admin password. You'll only be able to access the Live portal once your Merchant ID is confirmed. https://live.sagepay.com/MySagePay    - Login to Opayo (Live) using your original admin password. You'll only be able to access the Live portal once your Merchant ID is confirmed. https://live.sagepay.com/MySagePay 
-  - If you haven't already, add the following IP addresses to your "Valid IP Address" section (or a comparably named section): \\ * **IP:** 54.152.220.165 \\ **Subnet Mask:** 255.255.255.255+  - If you haven't already, add the following IP addresses to your "Valid IP Address" section (or a comparably named section): \\ * **IP:** ''54.243.60.3'' \\ * **IP:** ''54.152.220.165'' \\ **Subnet Mask:** ''255.255.255.255'' 
 +  - As when testing, create a user in the Opayo administration in the "Settings" > "Users" section. For the "Account Privileges" select "View All Transactions", and for "My Sage Pay Access" select "Search". 
 +  - In the Foxy administration, on the "payments" section, switch the payment servers to "Live Servers" and re-enter your details again, including your vendor and the username and password for the new user you created in your account (again, **not** your root user).
   - Test your Live account - perform a transaction via your website using a real card.    - Test your Live account - perform a transaction via your website using a real card. 
   - Perform a refund as you did in your test... you are now ready to start accepting payments from your customers - congratulations!   - Perform a refund as you did in your test... you are now ready to start accepting payments from your customers - congratulations!
Line 37: Line 44:
 ===== Additional Configuration For Subscriptions & Customer-Not-Present Transactions ===== ===== Additional Configuration For Subscriptions & Customer-Not-Present Transactions =====
  
-<WRAP center round important 95%>+<WRAP center round important 90%>
 **Are you selling subscriptions or completing transactions on behalf of customers?** This additional configuration needs to be completed **Are you selling subscriptions or completing transactions on behalf of customers?** This additional configuration needs to be completed
 </WRAP> </WRAP>
Line 46: Line 53:
  
 Continuous Authority isn't always automatically enabled for your merchant account and your Opayo account though, so you will need to confirm with both your merchant account provider (usually your bank) and with Opayo support if your account has "//Continuous Authority//" enabled. If not, they will be able to assist you with getting it enabled with your merchant account provider and Opayo. Continuous Authority isn't always automatically enabled for your merchant account and your Opayo account though, so you will need to confirm with both your merchant account provider (usually your bank) and with Opayo support if your account has "//Continuous Authority//" enabled. If not, they will be able to assist you with getting it enabled with your merchant account provider and Opayo.
 +
 +<wrap hi>Failing to ensure your merchant and gateway accounts have Continuous Authority enabled will result in any transactions not initiated by the customer to error.</wrap>
 +
 +===== Special Consideration: Prepayment Webhook =====
 +
 +For Opayo, the [[v:2.0:pre_payment_webhook|prepayment webhook]] will be sent to your endpoint twice; once before the 3D Secure challenge, and once before the payment is attempted. You can identify the different triggers using the ''Foxy-Webhook-Event'' header values of ''validation/3ds'' and ''validation/payment''.
 +
 +You can decline the transaction from either trigger, but there are optional additional values you can return with a ''true'' response to alter how the 3D Secure challenge occurs with Opayo. Specifically you can pass an additional top level object in the response that looks like this:
 +
 +<code javascript>
 +"overrides": {
 +    "opayo": {
 +        "apply_3dsecure": 2,
 +        "threeds_exemption_indicator": "05"
 +    }
 +}
 +</code>
 +
 +The values for ''apply_3dsecure'' and ''threeds_exemption_indicator'' match up to the ''Apply3DSecure'' and ''ThreeDSExemptionIndicator'' attributes [[https://developer-eu.elavon.com/docs/opayo-direct/api-reference/transaction-registration-post|as described within Opayo's documentation here]]. Consult with Opayo support for the best values to use for your specific requirements.
 ===== Troubleshooting & Interpreting Response Codes ===== ===== Troubleshooting & Interpreting Response Codes =====
 Contact Opayo for info. <wrap help>Know more? Feel free to edit this page with info.</wrap> Contact Opayo for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>

Page Tools

Site Tools