--- title: "Set up the extension" description: "Set up the extension in your Customer Area and in Oracle Commerce Cloud." url: "https://docs.adyen.com/plugins/oracle-commerce-cloud/set-up-the-extension" source_url: "https://docs.adyen.com/plugins/oracle-commerce-cloud/set-up-the-extension.md" canonical: "https://docs.adyen.com/plugins/oracle-commerce-cloud/set-up-the-extension" last_modified: "2020-02-27T11:44:00+01:00" language: "en" --- # Set up the extension Set up the extension in your Customer Area and in Oracle Commerce Cloud. [View source](/plugins/oracle-commerce-cloud/set-up-the-extension.md) **Deprecated**\ This Oracle Commerce Cloud extension is deprecated and we are no longer accepting integrations with it.\ We are working on a new extension for 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. Log in to your [Customer Area](https://ca-test.adyen.com/) and select your **Company** account. 2. Go to **Developers** > **API credentials**. 3. Select the **Payments** or **Platforms** tab, depending on your integration type. 4. Select the credential username. 5. Under **Server settings** > **Authentication** select the **API key** tab. 6. Select **Generate API key**. 7. Select the copy icon **and store your API key securely in your system. You cannot copy the API key again after you leave the page. 8. Select **Save changes**. ### Set up the capture delay To set up the capture delay in the Adyen Customer Area: 1. In the Adyen [Customer Area](https://ca-test.adyen.com/), go to **Settings** > **Account settings**. 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. Select **Submit**. 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](#set-up-an-api-key) that you set up in the Adyen [Customer Area](https://ca-test.adyen.com/). | | Client Key | Enter the [client key](/development-resources/client-side-authentication#get-your-client-key) you set up in the Adyen [Customer Area](https://ca-test.adyen.com/). | | 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](#installments). If you enable installments, enter the [Installments option code](#define-installments) that you get from the installments option wizard. | | Boleto Validity | (Fill in this field only if you are 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 are providing Boleto as a payment method). Enter the text that will be shown in the Boleto payment instructions. | | Enable card holder name | Select this option to show the card holder name field for card payments. If shown, the card holder name is a required field. | | Country Code | Fill in this field with the two-letter country code. This is a required field for some payment methods, for example Klarna, iDEAL, or Boleto. Format: the two-letter [ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code. Exception: **QZ** (Kosovo). | ### 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 preferred installment rules. You can 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. Select **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: Select the credit card types you want to accept this installment with. 4. After adding all the installment options, select **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](#configure-the-extension). ### Change your installment preferences 1. Log in to 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 select **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](#configure-the-extension). ## Next steps ##### [Test and go live](/plugins/oracle-commerce-cloud/test-and-go-live) [Test your integration, and configure your live account, so you can start processing live transactions.](/plugins/oracle-commerce-cloud/test-and-go-live)