NodeRings Docs

Handle Webhook

Handle webhook events from payment providers (Stripe, PayPal, etc.) This endpoint receives webhook payloads and processes payment/subscription events Note: The actual implementation will read raw HTTP body and headers directly to support webhook signature verification

POST
/api/v1/webhooks/{provider}
Authorization<token>

Bearer token

In: header

X-Organization-ID<token>

Tenant or organization identifier

In: header

Path Parameters

providerstring

Payment provider identifier (e.g., "stripe", "paypal") Validated in implementation to ensure supported providers

payload?string

Response Body

application/json

curl -X POST "https://api.nrings.io/api/v1/webhooks/{provider}" \  -H "Authorization: Bearer {your_token}" \  -H "X-Organization-ID: {your_org_id}" \  -H "Content-Type: application/json" \  -d '{  "payload": "string"}'
{
  "success": true,
  "eventId": "string",
  "message": "string"
}