Webhooks

Pine Labs supports webhooks to keep your systems in sync with real-time events.

Webhook Types

Feature	Transaction Webhooks	Catalog Webhooks	Balance Webhooks
Purpose	Payment status updates (Processing → Succesful / Failed)	Product catalog changes (products, options, categories, groups)	Eligible credits to your Pine Labs balance
Triggers	Transaction status changes	Catalog data created, updated, or deleted	Bank transfers and manual top-ups by Pine Labs
Setup	Dashboard: Developer > Webhooks > Settings	Dashboard: Developer > Webhooks > Settings	Dashboard: Developer › Webhooks › Balance Webhook

Implementation Details

Your webhook endpoint should be publicly reachable over HTTPS, acknowledge valid events with a 2xx response, and process events idempotently.

For payload schemas, security requirements, and retry behavior, use the API Reference pages below.

Guides

• Transaction Webhooks — Configure callback URLs for payment status notifications
• Catalog Webhooks — Receive real-time catalog change notifications
• Balance Webhooks — React when eligible funds are credited to your balance

Catalog SDK

Using the hosted Catalog SDK? See Catalog SDK Webhooks for SDK order outcome notifications.

API Reference

• Get Transaction Callback URL — Retrieve current transaction webhook configuration
• Set Transaction Callback URL — Configure transaction webhook URL
• Transaction Webhook Payload — Payload format, IP allowlist, field mapping
• Catalog Webhook Events — Event types, payload schema, signature verification
• Balance Webhook Events — Payload, signature verification, retries, and idempotency
• Balance Webhook Configuration — Configuration and delivery-log API endpoints