# Worldpay

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FcwG3D8rPHAmAknKpeFY8%2FScreenshot%20from%202024-08-29%2019-26-29.png?alt=media&#x26;token=48c98187-6299-446a-80ef-4de5cd5c638c" alt=""><figcaption></figcaption></figure>

**STEP 1**

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

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FEwl09n2GzsyiMKD7SRzw%2Fimage.png?alt=media&#x26;token=d701d2b4-c808-4db4-8ee5-b4c18dd2142a" 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://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FeSMl4Yy0mcdFXLIYUKxH%2Fimage.png?alt=media&#x26;token=f9738b0e-e034-44f8-afa5-f93665e7afb9" 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.checkoutchamp.com/crm/gateway-setup/direct-api-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.checkoutchamp.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
```
