PlexySDK DOCS

Webhook Types

All available webhook event types and their payloads

Webhook Types

Reference for all webhook event types sent by Plexy.

Payment events

EventDescription
payment.createdA payment intent was created
payment.processingPayment is being processed
payment.succeededPayment completed successfully
payment.failedPayment failed
payment.canceledPayment was canceled
payment.requires_actionAdditional action required (e.g., 3DS)

payment.succeeded

{
  "id": "evt_1234567890",
  "type": "payment.succeeded",
  "created": 1679529600,
  "data": {
    "id": "pay_abc123",
    "amount": 5000,
    "currency": "USD",
    "status": "succeeded",
    "payment_method": {
      "type": "card",
      "card": {
        "brand": "visa",
        "last4": "4242"
      }
    },
    "metadata": {
      "order_id": "order_123"
    }
  }
}

Refund events

EventDescription
refund.createdA refund was initiated
refund.succeededRefund completed successfully
refund.failedRefund failed
refund.canceledRefund was canceled

refund.succeeded

{
  "id": "evt_2345678901",
  "type": "refund.succeeded",
  "created": 1679529700,
  "data": {
    "id": "ref_xyz789",
    "amount": 2500,
    "currency": "USD",
    "status": "succeeded",
    "payment_id": "pay_abc123",
    "reason": "customer_request"
  }
}

Dispute events

EventDescription
dispute.createdA dispute was opened
dispute.updatedDispute status changed
dispute.wonDispute resolved in your favor
dispute.lostDispute resolved against you
dispute.closedDispute was closed

dispute.created

{
  "id": "evt_3456789012",
  "type": "dispute.created",
  "created": 1679529800,
  "data": {
    "id": "dsp_def456",
    "amount": 5000,
    "currency": "USD",
    "status": "needs_response",
    "payment_id": "pay_abc123",
    "reason": "fraudulent",
    "evidence_due_by": 1680134400
  }
}

Payout events

EventDescription
payout.createdA payout was scheduled
payout.paidPayout was sent to bank
payout.failedPayout failed
payout.canceledPayout was canceled

Customer events

EventDescription
customer.createdA customer was created
customer.updatedCustomer details changed
customer.deletedCustomer was deleted

Payment method events

EventDescription
payment_method.attachedPayment method added to customer
payment_method.detachedPayment method removed from customer
payment_method.updatedPayment method details changed

Account events

EventDescription
account.updatedAccount settings changed
account.application.authorizedOAuth app authorized
account.application.deauthorizedOAuth app deauthorized

Subscription events

EventDescription
subscription.createdSubscription was created
subscription.updatedSubscription details changed
subscription.canceledSubscription was canceled
subscription.trial_will_endTrial ending soon (3 days)

See also

On this page