Skip to main content

POST /webhooks/stripe

Endpoint​

POST /api/v1/webhooks/stripe

Caller​

Stripe only. This endpoint is not called by partner systems directly.

Required header​

HeaderRequiredDescription
stripe-signatureYesSignature generated by Stripe for webhook verification

Behavior​

  1. Verify Stripe signature using configured webhook secret.
  2. Parse Stripe event payload.
  3. Map event type to internal status.
  4. Resolve transaction by payment_intent identifier.
  5. Update transaction status and financial fields.
  6. Notify partner webhook URL with signed payload.

Success response example​

{
  "received": true,
  "clive_tx_id": "CLVTX_1739378102312_420",
  "status": "succeeded"
}

Ignored events​

If event type is not mapped, Clive returns accepted/ignored semantics:

{
  "message": "Ignored event payment_method.attached"
}

Common error codes​

  • STRIPE_SIGNATURE_MISSING
  • STRIPE_SIGNATURE_INVALID
  • INVALID_WEBHOOK_JSON
  • MISSING_INTENT_ID
  • PAYMENT_INTENT_NOT_FOUND