The Reference Docs Developer Hub

Welcome to the Reference Docs developer hub. You'll find comprehensive guides and documentation to help you start working with Reference Docs as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Gateway Specific Updates (PSD2)

To properly support the upcoming PSD2 Mandate, there may be changes required with your payment gateway's configuration. We've called out the changes needed as communicated to us per gateway on this page.

Adyen

Enable "Network Transaction Reference" Value Support

In order to properly support merchant-initiated transaction (MIT) exemptions, please be sure to enable support for "Network Transaction Reference" values within your Adyen Merchant Account configuration. This can be done under the "Acquirer" heading via the following: Account > API URLs > Additional Data Settings.

Once enabled, a new transaction ID value will be returned by Adyen when processing transaction requests, which you may see if you have a direct integration with Adyen (this new value will not be visible within Recurly).

Braintree

Recurly is not currently aware of any changes needed for Braintree gateway accounts. We will update this section if we do learn of required changes from our partners.

Cybersource

Enable 3D Secure 2 Support

Cybersource is partnering with Cardinal Commerce for 3D Secure challenges. This will need to be configured for your Cybersource account. Please contact your account manager or Cybersource's support team for assistance with getting this enabled for your gateway account.

Tokenize Credit Card Information with Recurly.js

Cybersource requires credit card tokenization via Recurly.js to ensure that the appropriate device data is pass along to your gateway. For more information, please be sure to review our documentation for more information on how to build the appropriate card form.

SagePay

Tokenize Credit Card Information with Recurly.js

SagePay requires credit card tokenization via Recurly.js to ensure that the appropriate device data is pass along to your gateway. For more information, please be sure to review our documentation for more information on how to build the appropriate card form.

Enable Support for MOTO Indicators

If your agents process billing information updates or submissions on behalf of your customers (such as billing info updates through the Recurly admin console), you will need to enable support for "MOTO" transaction indicators for your SagePay merchant account. Please contact your SagePay account manager or SagePay Support for assistance with enabling this feature on your SagePay account. Additional configuration in Recurly will also be required.

Stripe

Disable 3DS Settings for Stripe Radar

For merchants out of scope of the PSD2 Mandate, you will need to disable 3DS settings within your Radar configuration. This can be done via the following steps:

  1. From the Stripe portal home page, select "Radar".
  2. Under "Radar", select "Rules".
  3. For sections referencing "3D Secure", disable any options for enabled 3D Secure features.

Wirecard

September 2019

Recurly is currently awaiting 3D Secure 2 support to be released by the Wirecard team for all Wirecard gateway accounts. Recurly will be able to enable 3DS 2 support on our platform once this change by Wirecard has been completed.

Enable 3D Secure 2 Support

Wirecard requires support for 3D Secure 2 enrollment checks to be enabled on your gateway account before being able to support 3D Secure 2 challenges. Please contact your account manager or Wirecard's support team for assistance with getting this enabled for your gateway account. Please see September note above.

Enable Support for MOTO Indicators

If your agents process billing information updates or submissions on behalf of your customers (such as billing info updates through the Recurly admin console), you will need to enable support for "MOTO" transaction indicators for your Wirecard merchant account. Please contact your Wirecard account manager or Wirecard Support for assistance with enabling this feature. Additional configuration in Recurly will also be required.

WorldPay

Enable 3D Secure 2 Support

WorldPay is partnering with Cardinal Commerce for 3D Secure challenges. This will need to be configured for your WorldPay account. Please contact your account manager or WorldPay's support team for assistance with getting this enabled for your gateway account.

Tokenize Credit Card Information with Recurly.js

WorldPay requires credit card tokenization via Recurly.js to ensure that the appropriate device data is pass along to your gateway. For more information, please be sure to review our documentation for more information on how to build the appropriate card form.

Enable Order Notifications

WorldPay will provide enhanced order notifications to keep transaction statuses in Recurly up-to-date. You will need to enable these within your WorldPay account. Information on how to do this can be seen in WorldPay's documentation or by contacting your WorldPay account manager.

Enable Flexible Account Variables (Dynamic Interaction Type - MOTO)

If your agents process billing information updates or submissions on behalf of your customers (such as billing info updates through the Recurly admin console), you will need to enable "Flexible Account Variables" for your WorldPay merchant account and ensure that the "Dynamic Interaction Type" field supports the "MOTO" value. Please contact your WorldPay account manager or WorldPay Support for assistance with enabling this feature. Additional configuration in Recurly will also be required.

Updated 6 months ago

Gateway Specific Updates (PSD2)


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.