set-up-event-subscriptions

Automate event subscription setup with Payroc's API and CloudEvents 1.0 payloads.

1|Updated May 1, 2026
One-click install
npx skills add https://github.com/payroc/skills --skill set-up-event-subscriptions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: set-up-event-subscriptions
Source: https://github.com/payroc/skills/tree/main/plugins/payroc/notifications/skills/set-up-event-subscriptions
Command: npx skills add https://github.com/payroc/skills --skill set-up-event-subscriptions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires uuid, requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of setting up event subscriptions with Payroc's API, enabling real-time notifications for resource changes without the need for polling.

Core Features & Use Cases

  • Event Subscription Setup: Automates the creation, management, and deletion of event subscriptions.
  • Real-time Notifications: Receives real-time CloudEvents notifications when Payroc resources change.
  • Use Case: For developers who need to be notified immediately when a merchant's boarding status changes or when a terminal order ships, without polling the API.

Quick Start

Use the set-up-event-subscriptions skill to create an event subscription for processing account status changes.

Frequently Asked Questions about set-up-event-subscriptions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up real-time webhook notifications for Payroc API resource changes?

You can set up real-time webhook notifications by creating event subscriptions through the Payroc API. This automates subscription management and delivers CloudEvents 1.0 payloads to your webhook endpoint immediately when resources change, eliminating the need for polling.

What are CloudEvents 1.0 payloads and how does Payroc handle event subscription delivery?

CloudEvents 1.0 payloads provide a standardized specification for describing event data. The Payroc event subscription API delivers these structured payloads to your configured webhook endpoint, ensuring consistent parsing of real-time notifications for merchant boarding status or terminal order changes.

Do I need a specific webhook endpoint and API key to automate Payroc event subscriptions?

Yes, you need a valid Payroc API key and an active webhook endpoint configured to receive incoming HTTP requests. These prerequisites allow the event subscription automation scripts to authenticate with the Payroc API and successfully deliver real-time resource change notifications.

Can I manage and delete existing event subscriptions using the Payroc API?

Yes, you can manage and delete existing event subscriptions using the Payroc API. The automation scripts handle the full event subscription lifecycle, enabling you to create, update, and remove webhook subscriptions as your real-time notification requirements change.

What's the best way to stop polling the Payroc API for merchant boarding status updates?

The best way to stop polling is to set up event subscriptions that push real-time CloudEvents notifications to your webhook endpoint. This approach automates subscription creation via the Payroc API, immediately notifying you when a merchant's boarding status changes without continuous API requests.