# Optional webhook recipe (/en/ai-integrations)



import { Bot, ExternalLink, MousePointerClick, Webhook, Shield, CreditCard } from 'lucide-react';

Optional guidance after connection [#optional-guidance-after-connection]

Start with [Connect with AI](/en/agent-kit) for the single prompt and account connection. This recipe helps an already connected assistant reuse a merchant's existing webhook and fulfillment logic. Reading it does not require installing another plugin or creating another account connection.

<Callout type="info">
  Any assistant that can read documentation can use the raw recipe. The Claude Code plugin below is an optional way to install the same guidance.
</Callout>

<Card title="Optional Claude Code plugin" description="Install the webhook recipe from the public Yolfi marketplace if your workflow uses plugins." icon={<MousePointerClick />} href="#optional-claude-code-installation" cta="Install" horizontal arrow className="border-fd-primary/40 bg-fd-primary/10" />

<Card title="View Webhook Integration Skill" description="Open the raw assistant instructions in a new tab." icon={<ExternalLink />} href="/skill/yolfi-webhook-integration" target="_blank" rel="noreferrer" cta="Open skill" horizontal />

***

<span id="install-in-claude-code" />

Optional Claude Code installation [#optional-claude-code-installation]

If you want the recipe installed as a plugin, run this command once in your terminal:

```bash
claude plugin marketplace add yolfinance/skill && claude plugin marketplace update yolfi && claude plugin install yolfi-webhook-integration@yolfi
```

If Claude Code is already open, run these slash commands instead:

```text
/plugin marketplace add yolfinance/skill
/plugin marketplace update yolfi
/plugin install yolfi-webhook-integration@yolfi
```

The skill is installed from the public Yolfi marketplace repository: `yolfinance/skill`.

***

When To Use It [#when-to-use-it]

Use the Yolfi webhook integration skill when you want an AI coding assistant to:

* Add Yolfi webhooks to an existing backend.
* Reuse a Stripe or Lemon Squeezy webhook flow through Yolfi adapters when safe.
* Add raw-body signature verification for `X-Yolfi-Signature`.
* Preserve existing order, subscription, entitlement, and fulfillment logic.
* Keep integration minimal: signature routing + payload compatibility, not business rewrites.
* Add tests or local checks proving valid webhooks pass and invalid signatures fail.

For adapter mode, the assistant should preserve your existing webhook pipeline first and only adapt the event envelope and auth path.

The skill should not replace the webhook docs. It loads the current docs before implementing so event names, payload shapes, adapter behavior, and signature rules stay sourced from the documentation.

***

Related Resources [#related-resources]

<Cards>
  <Card title="Connect with AI" description="The canonical one-message workflow for connecting an agent and implementing payments." icon={<Bot />} href="/en/agent-kit" />

  <Card title="Webhooks" description="Understand Yolfi webhook events, retries, and delivery behavior." icon={<Webhook />} href="/en/webhooks" />

  <Card title="Webhook Signatures" description="Verify incoming webhook requests with the raw body and endpoint signing secret." icon={<Shield />} href="/en/webhooks/webhook-signatures" />

  <Card title="Adapters" description="Reuse compatible Stripe or Lemon Squeezy webhook handlers." icon={<CreditCard />} href="/en/adapters" />

  <Card title="Raw Skill" description="Open the skill instructions without docs navigation or page chrome." icon={<Bot />} href="/skill/yolfi-webhook-integration" target="_blank" rel="noreferrer" />
</Cards>