---
title: Checkout HUB Dispute Webhook
slug: checkout-hub-dispute-webhook
docTags: 
createdAt: 2026-06-01T13:20:13.044Z
---

How to provide Forter access to your CheckoutHUB Dispute Webhooks. To enable Forter to process your chargebacks, please integrate your PSP with Forter by following these steps.

:::::WorkflowBlock
::::WorkflowBlockItem
**Include the Checkout.com Request Payment ID value in payment auth details**

A unique identifier is generated by the Checkout.com that differs from your orderId. This is required to map the dispute back to the original transaction. Map the [Checkout.com Payment ID](https://www.checkout.com/docs/payments/manage-payments/get-payment-details) (the value that starts with pay\_ ) to the `processorTransactionId` field in your Order or Order Status API request, when you send Forter the payment authorization details.

:::CodeblockTabs
Partial code example

```json
 "payment": [
    {
      "billingDetails": {},
      "creditCard": {
        "nameOnCard": "Jane Smith",
        "bin": "442757",
        "lastFourDigits": "5149",
        "expirationMonth": "11",
        "expirationYear": "2024",
        "verificationResults": {},
        "cardType": "DEBIT",
        "countryOfIssuance": "USA",
        "paymentprocessorData": {
          "processorName": "Checkout.com",
          "processorTransactionId": "pay_f2ws3hn4ijquzbytp3v5lsfxge" // Unique ID assigned by Checkout.com
        }
      }
    }
  ]
```
:::
::::

:::WorkflowBlockItem
**Create your Checkout.com secret key**

In your Checkout.com dashboard, click Developers -> Keys and create a key.

![](https://images.archbee.com/dYhsqkppjaUNAqFmds_Ny-eyVUu76JaaTHWm64Pkowo-20250613-161840.png)

Save the Public key and Secret key credentials to a .txt file with the file naming convention "JCBR-yourSiteName-processorName" (e.g. "JCBR-TShirtsExpress-Checkout") and upload it securely to your S3 folder. Please notify your Forter Implementation Engineer once you have uploaded these files. Your Forter Implementation Engineer will securely add your secret key to the Forter database and let you know when this step is complete.
:::

:::WorkflowBlockItem
**Create a new webhook**

Log back into your Checkout.com dashboard and click Developers -> Webhooks. Create a new Webhook using the following information:

- Endpoint URL: `https://api.forter-secure.com/webhooks/checkoutcom/<your-forter-site-id>` using the site ID from the [Credentials section of Forter Portal](https://portal.forter.com/app/integration/credentials/).
- Authorization header key: Use the secret key from the [Credentials section of Forter Portal](https://portal.forter.com/app/integration/credentials/).
- Signature key: Copy and paste the Checkout Secret key you generated in the previous step.
- Events: Select all events related to disputes:
  - Dispute evidence required
  - Dispute expired
  - Dispute lost
  - Dispute won
  - Dispute resolved
  - Request for information received
- Entities and processing channels: Select all relevant channels
- Click Create Webook.

![](https://api.archbee.com/api/optimize/dYhsqkppjaUNAqFmds_Ny-nNWbv7K5wtAliUqSMOzh7-20250722-132144.png)
:::

:::WorkflowBlockItem
**Test the Checkout Dispute Webhook**

To simulate a chargeback with the checkout.com webhook, please reference checkout.com's full list of test cards and scenarios.
:::
:::::

**Multiple Checkout Accounts for a single Forter site**

Currently, Forter only supports 1 checkout account to 1 portal site. This means that if you have multiple checkout accounts pointing to a single portal site, you will only be able to set up a dispute webhook for one account. Remaining accounts will need to provide chargebacks via an alternate method such as the Forter Dispute API, a csv file, or manual update in the Forter portal.