Implementing the Verification Webhook as a new Stripe Endpoint

This guide covers how to add the Webhook Event to your Stripe API Endpoints. This is the second-last step in setting up Bidder Verification with us, once we receive your Stripe API Details (Publishable and Secret Keys), we’ll send through a Webhook that must be added to your Stripe account to link the Verification module from on your Portal to your Stripe.

Enabling the Stripe Developer Workbench

If you haven’t done so already, you’ll need to enable the Developer Workbench before proceeding with this guide. Here’s how:

After logging into your Stripe account, you’ll land on the Stripe Dashboard Home page. Look to the top-right of the page and click on the Settings icon here:

This will open the Account Settings page, click on the top-right option labelled Developers, if this is your first time using the Workbench, make sure you tick the Enable Workbench checkbox at the centre of your screen:

Implementing the Stripe Verification Webhook

You will have received an email from us with a secure file attached, this file will contain the Webhook data we need you to add to your Stripe API Endpoints via the Developer Workbench. This Webhook establishes a three-way connection between your Portal, the Bidder Registration server and your Stripe API, allowing all three to communicate during the Verification process.

This Webhook must be in place in order for us to begin testing and certifying your Verification module.

Step 1 – Accessing the Stripe Developer Workbench

Once you’re logged into Stripe, you’ll land on the Home, look to the bottom-left of your screen and click on the Developers button:

A list of options will expand upwards, click on the second option from the top labelled Webhooks:

Step 2 – Selecting an Event

After clicking Webhooks, the Developer Workbench will pop-up from the bottom of your screen with the Webhooks tab open, click the + Add destination button to proceed:

You’ll now see a list of options, starting with “Events from” and API version. Leave both options as-is (Both should be set to Your account and Your current version by default):

Scroll down the All Events list and click the arrow next to the Payment Method option. Here you’ll find 4 checkbox options, tick only the first option labelled payment_method.attached then click the purple Continue button at the bottom-right of the list:

Step 3 – Inserting the Webhook

After clicking Continue, you’ll now see the Choose Destination Type options, click the option labelled Webhook endpoint, then click Continue:

You’ll now see the Configure your destination menu, with three options inside:

1. Destination name
2. Endpoint URL
3. Description

We recommend leaving the Destination name as-is, Stripe will allocate a secure gibberish name for you. Copy the Webhook from the file we sent you and paste it into the Endpoint URL field:

Description is optional, if you would like to provide future reference for your Staff or Developers, you can add “Webhook for Bidder Verification” in the description field, either way click Create destination to finalise adding the Webhook:

Step 4 – Copying the WHSec Key

After clicking Create Destination, you’ll now see your new Webhook active inside the Developer Workbench. Look to the right-hand side of Workbench for the section titled Signing Secret, then click on the Eye icon to reveal your Signing Secret WHSec key. Click on the Clipboard icon to copy it:

Please send through the WHSec Key to us as soon as possible. Once we have the WHSec Key in place, the Webhook connection will be confirmed and we will begin our Verification Certification and Testing checklist.