---
title: Checkout NAS Platform Dispute Webhook
slug: checkout-nas-platform-dispute-webhook
docTags: 
createdAt: 2026-06-01T13:20:13.044Z
---

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

## Required Keys

1. Public Key
2. Secret Key

:::::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 (**the value that starts with pay\_ ) to the `processorTransactionId` field in your **Order API** 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**

Log into your Checkout.com account and go to the "Developer" section from your homepage. In this section, click on the **Create Keys** button to generate unique keys for your webhook. You should receive both a **Public key** and a **Secret key** value.

::Image[]{src="https://api.archbee.com/api/optimize/dYhsqkppjaUNAqFmds_Ny-a4cAZ4SWYPCWMhzCTMxeY-20250722-132315.png" size="60" width="1558" height="1220" darkWidth="1558" darkHeight="1220" position="flex-start" showCaption="false"}
:::

:::WorkflowBlockItem
**Create a Notification**

Click on the Notifications tab of your main Dashboard under "Settings"

::Image[]{src="https://api.archbee.com/api/optimize/dYhsqkppjaUNAqFmds_Ny-UnazldVAXJDyV3UyM2Y7Z-20250722-132334.png" size="50" width="510" height="1252" darkWidth="510" darkHeight="1252" position="flex-start" showCaption="false"}

Select the "New Notification" option and provide a descriptive name for the webhook in the "Name" field (i.e. "Disputes for Forter")

![](https://images.archbee.com/dYhsqkppjaUNAqFmds_Ny-XNXRuSlrLix24lYUE1-h2-20250613-161843.png)
:::

:::WorkflowBlockItem
**Select Events**

In the events selection, go to the **Disputes** box and click on the "Select all Disputes" checkbox.

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

:::WorkflowBlockItem
**Add your Forter and Checkout keys**

In the **URL** field, add your Forter 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/).

In the **Authorization header key** field, copy and paste your secret key from the [Credentials section of Forter Portal](https://portal.forter.com/app/integration/credentials/).

In the **Signature Key** section copy and paste the Checkout Secret key you generated in the Developer section in Step 2.

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

:::WorkflowBlockItem
**Upload your secret key**

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](https://portal.forter.com/app/integration/docs/secure-file-transfer). 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
**Select Entities**

The webhook will send notifications for ALL of your entities by default, but if you only want to send Forter notifications for a specific store/or entity, you can check these in the "Entities" section

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

:::WorkflowBlockItem
**Finalize your new webhook**

Click on the Create notification button at the bottom of the page to finalize the new dispute notification webhook. This will publish your Notification webhook and allow Forter to receive dynamic dispute updates going forward.

![](https://images.archbee.com/dYhsqkppjaUNAqFmds_Ny-pEGN8evE__1K-odfgLWmD-20250613-161847.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 claims API, a csv file, or manual update in the Forter portal.