API Overview

Webhooks Implementation Guide
- Limited Availability Release
- Recent Revisions to This Document
- VISA Platform Connect: Specifications and Conditions for Resellers/Partners

Introduction to Webhooks

How to Prepare Your System to Support Webhooks

How to Set Up Webhook Subscriptions

Supported Products and Event Types

Set Up Your Server Security

Create REST API Keys
- Create a Shared Secret Key Pair
- Create a P12 Certificate

Create a Digital Signature Key

Provide Your OAuth Credentials

Retrieve a List of Products and Events

Create a Webhook Subscription
- Create a Webhook Subscription Using Mutual Trust
- Create a Webhook Subscription Using OAuth
- Create a Webhook Subscription Using OAuth with JWT
- Examples of all Products and Event Types

Optional Set-Up Tasks
- Webhook Health Check URL and Automatic Revalidation
- Configure the Retry Policy
- Validate a Webhook Notification

Webhook Notification Header and Message Body Descriptions

Create a Sample Webhook Subscription

Manage Webhook Subscriptions Requests
- Retrieve the Details of a Webhook Subscription
- Retrieve all of an Organization's Subscriptions
- Update a Webhook Subscription
- Delete a Webhook Subscription
- Verify a Webhook Subscription's Configuration
- Activate a Webhook Subscription
- Deactivate a Webhook Subscription

Troubleshooting Webhook Subscriptions

On This Page

Set Up Your Server Security

Complete these tasks to configure your server to receive secure webhook notifications.

Allowlist

Add these IP addresses to your allowlist to permit Visa Acceptance Solutions to deliver your webhook notifications:

198.241.206.21

198.241.207.21

Trusting the Root Certificate

Download the Visa Corporate Root CA G2
certificate from the Visa Public Key Infrastructure webpage, and add it to your Java keystore:

http://enroll.visaca.com

Back to top