The Adyen payments platform provides businesses with a single solution accepting payments anywhere in the world. Built-in house, Adyen is an end-to-end infrastructure connecting you directly to Visa, MasterCard and 250 other payment methods delivering frictionless payments across online, mobile and in-store.
With Adyen you replace multiple suppliers for the gateway, risk and acquiring, with one single solution, enabling you to streamline your operations and reduce costs.
Zuora’s integration to Adyen gives you the power to manage subscription payments and increase authorization rates for both credit cards and local payment methods like SEPA direct debit.
For any subscription based questions contact your Zuora account representative. For transaction and settlement questions, log into your Adyen back-office, email firstname.lastname@example.org, or contact your account manager.
Adyen supports the following payment methods:
There are some common fields you must complete for every gateway configuration. Zuora recommends reviewing Zuora recommends reviewing Setting Up Payment Gateways for information on these fields:
For the Adyen gateway, these fields are API authentication credentials. For information on how to get these credentials, see Get Adyen Credentials for API Authentication in the following section.
The Payout feature is integrated with Zuora thru the non-referenced refund operation using the BankTransfer and the CreditCardReference payment methods. Contact Adyen support to enable the Payout feature for your merchant account. See Payouts for more information.
The Gateway Reconciliation job for Adyen is scheduled to start at 11:00 pm (PST) every day.
See below for tips to consider when using gateway reconciliation.
For more information about this option, see Gateway Reconciliation.
Click save gateway information after entering the necessary information.
The Adyen credentials (Merchant Account, Username, and Password) are set up in the Adyen Customer Area (CA).
Carefully note the credentials you use to create the Adyen gateway in Zuora. First, the credentials entered in Zuora are not the same as those used to access the Zuora. First, the credentials entered in Zuora are not the same as those used to access the Adyen Customer Area, please see below on how to create the required Adyen user. Second, when entered, the credentials are not validated by Zuora when the Zuora when the Adyen gateway is set up. After setup is complete, we recommend creating or updating a new payment method to make sure the configuration is correct.
The ability to process API payments is not enabled in Adyen by default. Contact the Adyen Support Team (email@example.com) to have the following roles enabled: API PCI Payments role, API tokenise payment details, General API Payments role, Merchant PAL Webservice role, and Merchant Recurring role.
When enabled, this setting enables the ability to create Payment Methods which supports Adyen's Payouts using Zuora's Non-Referenced Refunds. The Payout functionality is set up as a 2-step process, with the first user initiating the action, and the second user confirming it. This means that after a payout is initiated it must be confirmed before it is executed. If a payout is not confirmed or fails, Adyen automatically reverses the request after 7 days.
To use the Payout feature, the merchant will need to contact Adyen support to provision three new users; one system user to execute the payout (submit), a second user to review the payout request (review) and an optional CA user to view and modify payouts through the Adyen Customer Area (CA).
If you already have a CA user, you can ask Adyen support to add the Payout view and modify the role for the designated CA user account.
The Payout API feature is not enabled by default, please contact Adyen Support to enable this feature. You will also need to configure Regular Submit workflow for your account.
Submit Payout Username and Password
The Adyen System User used to Store the Payout details and Submit a Payout request. This information is used as part of the Non-Referenced Refund transactions in Zuora.
The Adyen System User used to Review and Confirm a Payout request. This information is used as part of the Non-Referenced Refund transactions in Zuora.
The following payment methods support non-referenced refunds
Zuora supports Adyen tokens. Tokens are used for credit card reference transactions in Zuora. A reference transaction is simply a representation of a credit card payment method without having sensitive payment method information like the credit card number stored in Zuora. Please note that the token cannot be used with another gateway, which is why we recommend storing credit card information in Zuora whenever possible.Zuora. A reference transaction is simply a representation of a credit card payment method without having sensitive payment method information like the credit card number stored in Zuora. Please note that the token cannot be used with another gateway, which is why we recommend storing credit card information in Zuora whenever possible.
The Token ID and Second Token ID fields are required for credit card reference transactions. These fields correspond respectively to the shopperReference and recurringDetailReference fields in Adyen.
This feature is in Limited Availability. If you wish to have access to the feature, submit a request at Zuora Global Support.
See the following topics for more information about setting up credit card reference transactions in Zuora.Zuora.
The following SOAP API call can be used to create a payment method that represents an Adyen-stored credit card.
<ns1:create> <ns1:zObjects xsi:type="ns2:PaymentMethod"> <ns2:AccountId></ns2:AccountId> <ns2:SecondTokenId></ns2:SecondTokenId> <ns2:TokenId></ns2:TokenId> <ns2:Type>CreditCardReferenceTransaction</ns2:Type> </ns1:zObjects> </ns1:create>
When Enable gateway reconciliation is selected, Zuora will retrieve settlement information from Zuora will retrieve settlement information from Adyen on a daily basis. You will need to create report user credentials in the Adyen gateway to receive the settlement reports. Report users usually have the prefix report_ and are different than the credentials used for web service transactions. Contact Adyen if you need help creating report users and validating the credentials.
The following are tips to consider when configuring your Adyen Gateway with gateway reconciliation enabled:
Configuring the Server Communication Settings in the Adyen console are not a requirement of to use the Adyen Reconciliation feature implemented by Zuora.