Overview

Required plan

This payment gateway or setting is available to all customers on any Recurly subscription plan.

Prerequisites

• An active Recurly account with Argentine Peso (ARS) currency support.
• WorldPay payment gateway configured for ARS transactions.
• Established commercial agreements with WorldPay and Ebanx to facilitate local transactions.
  • WorldPay also supports dLocal but is not provisioning new accounts for that relationship. For merchants that do not already have a dLocal account, connect with Worldpay on an Ebanx solution.
• A WorldPay merchant account optimized for handling ARS and capable of performing Zero Dollar Authorizations (ZDA).

Limitations

• The Tarjeta Naranja card brand does not support ZDA; verifications for this card are processed with a one-dollar charge.
• Transactions require the submission of a CUIT (tax ID) with each transaction in Argentina.
• Check if your business is on Worldpay's list of Prohibited Business types.

🚧

Warning

If you have a Vantiv/Litle Merchant ID, use these directions instead.

Definition

Expand your business globally and in the dynamic Latin American e-commerce sector with Recurly's integration with WorldPay and Ebanx/dLocal. This solution offers a seamless way to navigate complex payment ecosystems, supporting local currencies, card brands, and distinct regional payment preferences. WorldPay facilitates international transactions with configurable merchant accounts, while WorldPay LATAM, via partnerships with Ebanx/dLocal, caters specifically to Latin American markets, optimizing payment processes by accommodating local currencies like the Argentine Peso (ARS) and the widely recognized card brand, Tarjeta Naranja.

For a global reach, WorldPay allows merchants to configure their accounts for international processing, including IP allowlisting, capture delay settings, and callback configurations for seamless transaction synchronization. Recurly's integration ensures merchants can support a broad range of currencies and card types, including the application of Zero Dollar Authorizations if needed. With WorldPay's asynchronous processing for voids and refunds, and Recurly's commitment to submitting comprehensive transaction information, businesses are equipped to offer a robust and adaptable payment processing experience worldwide and specifically in the Latin American market.

Note: Visit our guide on testing your gateway configurations in Recurly to ensure your payment processes are set up correctly.

Key details

Credentials

Worldpay Payment Gateway (WPG) requires you to enter XML credentials obtained from Worldpay.

Voids and refunds

Void (also known as 'cancel') and Refund order modifications are processed asynchronously by WorldPay. There is a remote chance that WorldPay may reject a Void or Refund request 5 to 45 minutes after receiving it.

Billing address

At Recurly, we want to submit as much information (including the billing address) to WorldPay as possible. WorldPay, however, requires four mandatory fields - Address line1, City, Postal code and Country. If not provided, Recurly may use default values for these fields.

For example: If a customer has only provided a postal code we will submit the provided Postal code, use the country from their IP address, and default the City to “city” and Address line1 to “address”. If we don't have the Country (or can’t derive the country from the IP address) a billing address will not be submitted for the transaction.

Navigating the LATAM ecommerce landscape

Recurly has forged collaborations with WorldPay, Ebanx, and dLocal (no new dLocal accounts provisioned by Worldpay), endeavoring to offer merchants unparalleled support in Latin America, a region harboring a booming ecommerce market amidst a complex payment ecosystem.
Find additional guidance in the technical documentation, where the billing information block references the CUIT. This vigilant approach ensures a smooth, compliant transaction process, embracing the specific needs of the Latin American market.

Configuring WorldPay WPG for international processing

1. Initiate the setup by contacting WorldPay to adjust your merchant account for international transactions.
2. Access the WorldPay portal to authorize Recurly's IP addresses. Refer to our IP Allowlist documentation for a comprehensive list of IPs to include.
3. While in the WorldPay platform, adjust the Capture delay setting to 1-Day.
   a. Implement callback configurations using the URLs https://callbacks.recurly.com/worldpay for notifications you wish to receive. For those with data in European Union (EU) data centers, utilize https://callbacks.eu.recurly.com/worldpay instead.
4. It's advisable to set up WorldPay to forward notifications to Recurly, ensuring alignment between Recurly's transaction records and WorldPay's.

Configuration in Recurly

1. Navigate to the “Payment Gateways” section within your Recurly application. Select “Add Payment Gateway” and choose WorldPay as your gateway.
2. Input your WorldPay Merchant Code, XML Username, and XML Password. Note: The Username and Password for this setup differ from your WorldPay account login credentials.
3. If you are utilizing 3D Secure, input your Issuer ID, Unit ID, HMAC Key, and Challenge URL.
4. Specify the currencies and card types you plan to accept.
5. Optional: Designate which card types should undergo Zero Dollar Authorizations.
6. If you are using Worldpay in a Back Office “MOTO” environment, check the Enable MOTO Transactions checkbox.
7. Finalize your setup by clicking "Add Payment Gateway".
8. Validate your configuration by selecting the “Test Configuration” feature for the gateway to ensure proper setup.

Enable gateway for LATAM

Leveraging the WorldPay LATAM gateway for your business involves a streamlined process. Follow the detailed steps below to enable this gateway seamlessly:

1. Enable ARS currency on your Recurly site
   • Log in to your Recurly account.
   • Navigate to the currency settings and enable Argentine Peso (ARS) as a supported currency.
2. Configure WorldPay as your payment Gateway
   • Still in your Recurly dashboard, go to payment gateways.
   • Select and configure WorldPay as your payment gateway, ensuring it's set up to accept ARS.
3. Enable Tarjeta Naranja
   • Within your WorldPay gateway settings in Recurly, find and toggle on the option to accept payments through Tarjeta Naranja.
4. Establish commercial relationships
   • Set up commercial relationships with both WorldPay and either Ebanx or dLocal. If necessary, contact [email protected] for introductions.

Settings on the Gateway Side

Setting up your WorldPay account correctly is crucial in ensuring smooth transactions. Here’s how you can go about it:

1. Initiate WorldPay integration
   • Reach out to the WorldPay integration team to kickstart the setup process for your WorldPay account.
2. Enable local currencies and zero dollar authorizations
   • Ensure that your WorldPay account is configured to support local currencies, including enabling zero-dollar authorizations (ZDA).
   • Understand the specifics about ZDA, especially in relation to Tarjeta Naranja, which does not support ZDA and processes verifications with a one-dollar charge.
3. Integration with Ebanx or dLocal
   • Establish a functioning relationship with Ebanx or dLocal, integrating them appropriately with your WorldPay account. You do not need to integrate directly to Ebanx or dLocal.
4. Setting up transaction details
   • Be prepared to collect the CUIT (tax ID) from your Argentine customers during the initial transactions.
   • Configure your system to include fields for the tax identifier and its type during the payment process, aligning it to send this information correctly with each transaction to comply with the Argentine regulations.
5. Testing

• Before going live, rigorously test the setup to ensure all elements work harmoniously and comply with the regional requirements.

By carefully following this step-by-step process, you will have the WorldPay LATAM gateway up and running, ready to facilitate transactions in the Latin American market efficiently. Ensure to refer to the technical documentation for any technical assistance during the setup.