Search

Are you looking for test card numbers?

Would you like to contact support?

Plugin icon

Set up the extension

Set up the extension in your Customer Area and in Oracle Commerce Cloud.

Step 1: Set up the Adyen Customer Area

Set up an API key

To set up an API key in the Adyen Customer Area:

  1. In the Adyen Customer Area, go to Account > Users.
  2. From the drop-down menu in the first column, select System.
  3. Click the ws user (ws@Company.[YourCompanyAccount]).
    This opens a page with the settings for this web service (ws) user.
  4. In the Authentication pane, click Generate New API Key.
  5. Copy the API key and store it securely in your system.
  6. Click Save Generated API Key.

Set up the capture delay

To set up the capture delay in the Adyen Customer Area:

  1. In the Adyen Customer Area, go to Account > Users.
  2. In the Capture Delay drop-down menu, set the field to immediate (if not already set). In immediate captures, payments are captured immediately after authorisation.
  3. Click Submit.

Currently Oracle Commerce Cloud does not support manual captures needed for asynchronous payment methods like Boleto. When an order is submitted using Boleto, you cannot manually capture the payment in the Oracle Commerce Cloud. You need to do so in your order management system.

Step 2: Configure the extension

You need to configure the extension in your Oracle Commerce Cloud for your test environment (Preview). When you move to your live environment (Storefront or Agent), set these fields with your live configuration values.

Field Action
Payment Methods Select the payment methods that you will provide.
Merchant Account Enter your merchant account name.
API Key Enter the API Key that you set up in the Adyen Customer Area.
Stored Payment Methods Select if your shoppers can store their payment details for one-click or recurring payments (or both).
Environment Set to Test or Live, depending on your integration.
Enable installments Select this option to enable installments. If you enable installments, enter the Installments option code that you get from the installments option wizard.
Boleto Validity (Fill in this field only if you're providing Boleto as a payment method). Specify the number of days the Boleto is valid for payment.
Boleto payment instructions (Fill in this field only if you're providing Boleto as a payment method). Enter the text that will be shown in the Boleto payment instructions.

Set up Generic Payment Function API

The Generic Payment URL can be used to send authorisation requests externally. The Oracle Commerce Cloud uses webhooks to send JSON notifications to specified URLs every time an event occurs, for example, every time a shopper completes an order.

  1. Go to Settings > Web APIs.
  2. In the Webhook tab, go to the Function APIs section and open the Generic Payment - Preview entry.
  3. Fill in the following:
Field Value
URL Your web store URL followed by /ccstorex/custom/adyen/v1/payments. The URL must use HTTPS.
Username Choose any username for this field.
Password Choose any password for this field.

Optional configuration: Installments

To provide installments in your Oracle Commerce Cloud integration, you need to use an external tool to set your perferred installment rules. You can currently provide installments to your shoppers if your ecommerce store is in Brazil and Mexico.

Define installments

To define your installments:

  1. Go to the Adyen Oracle Commerce Cloud installments options wizard.
  2. Click Create.
  3. Add the installment options you want to offer to your shoppers. For each installment, specify:
    • Amount Range: Minimum value that the installment can apply to.
    • Number of installments: The number of installments that the payment is split into.
    • Allowed credit card types: Check the credit card types you want to accept this installment with.
  4. After adding all the installment options, click Done.
  5. You now have the Installments option code. Copy this code and enter it in the Installment options code field in Oracle Commerce Cloud.

Change your installment preferences

  1. Log into Oracle Commerce Cloud administration area.
  2. Navigate to Settings > Payment Processing > Payment Gateways tab.
  3. Under Service Types, select Adyen.
  4. Copy the Installment options code from the configuration you want to change.
  5. In the Adyen Oracle Commerce Cloud installments options wizard, go to the Edit section, enter your installment options code, and click Edit.
  6. Make the desired changes and once you are happy with the installment preferences, press the copy button above and enter it in the Installment options code field.

Next steps