# Worldpay

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2Fwyx1RYa0tP3lozFkTMhA%2FScreenshot%20from%202024-08-29%2019-26-29.png?alt=media&#x26;token=0c39733a-38e5-495e-a73d-32da93179d39" alt=""><figcaption></figcaption></figure>

**STEP 1**

Go to **Gateways** | **Gateway Integrations** and select the Worldpay tile. Click on **+Activate**.

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2Fsbwqh5MV8WtXHcvDaEco%2Fimage.png?alt=media&#x26;token=7e95a409-3650-4e96-b902-d145fcea5631" alt=""><figcaption></figcaption></figure>

Enter the following information specific to Worldpay:

* **merchantCode** - Obtained from Worldpay
* **username** - Obtained from Worldpay
* **password** - Obtained from Worldpay
* **rebillMerchantCode** - Obtained from Worldpay (required to process rebills)
* **rebillUsername** - Obtained from Worldpay (required to process rebills)
* **rebillPassword** - Obtained from Worldpay (required to process rebills)
* **secure3DS** - enable native 3D Secure processing
* **flexAPIKey** - Obtained from Worldpay (required if **secure3DS** is enabled)
* **flexAPIId -** Obtained from Worldpay (required if **secure3DS** is enabled)
* **flexOrgUnitId** - Obtained from Worldpay (required if **secure3DS** is enabled)

Click the green **Create Gateway** button to save your changes and create the gateway

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FsgKk77u2o9jdjiG7H7CM%2Fimage.png?alt=media&#x26;token=9943461f-27e0-4be3-b1c5-e7820f9be8d8" alt=""><figcaption></figcaption></figure>

**STEP 2**

Assign the gateway to campaign products

**STEP 3**

For Secure 3DS the checkout and upsell pages must support 3DS redirects

[Basic 3DS Instructions](https://help.konnektive.com/konnektive-crm/gateway-setup/basic-3ds-instructions)

**STEP 4**

**Worldpay Setup**

{% hint style="info" %}
Contact Worldpay support to enable these features on your account:

1. Return AVS & CVV as result code instead of result description in the API response
2. Tokenization
   {% endhint %}

**Worldpay Webhook Configuration**

{% hint style="info" %}
Webhooks are mandatory for Worldpay
{% endhint %}

**Merchant Channels**

```
Protocol: http
Active: yes
Content: xml
Address: https://api.konnektive.com/billers/worldpay/notification/
Method: POST
Client Certificate: no
Send Idempotency Key: no
```

**Merchant Channel Events**

Under "http", Please choose the following events.

```
CANCELLED
CAPTURED
CAPTURE_FAILED
```
