Skip to main content
WEBHOOK

Body

application/json

Sent once when a dispute is opened on an order. Currently only one subtype is possible:

  • OPENED - A dispute was registered for an order. Triggered on dispute creation only; subsequent status changes do not produce additional webhook events.

Delivery is configured using the Webhook dispute events toggle on the Settings page of the FunnelFox Billing dashboard.

event_type
enum<string>
required
Available options:
subscription,
oneoff,
order,
refund,
user,
dispute
event_id
string<uuid>
required
event_timestamp
string<date-time>
required
is_livemode
boolean
required
subtype
enum<string>
required
Available options:
opened
dispute_id
string<uuid>
required

FunnelFox internal dispute identifier

order_id
string<uuid>
required

FunnelFox order identifier the dispute belongs to

user
object
required
order
object | null

Full order details, including initial_order_metadata

psp_dispute_id
string | null

PSP-assigned dispute identifier (e.g. Primer's processorDisputeId)

processor
enum<string> | null

Underlying payment processor that issued the dispute

Available options:
stripe,
braintree,
paypal,
adyen,
checkout,
primer_processor
subscription
object | null
oneoff
object | null