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 Payments dashboard.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"FunnelFox","colors":{"primary":"#e18535","light":"#e18535","dark":"#e18535"},"logo":{"light":"https://mintcdn.com/funnelfox/j1sUFlbSAuzPUvc1/logo2.png?fit=max\u0026auto=format\u0026n=j1sUFlbSAuzPUvc1\u0026q=85\u0026s=96e66e531e885dda9f0f968608e3d80a","dark":"https://mintcdn.com/funnelfox/j1sUFlbSAuzPUvc1/logo2.png?fit=max\u0026auto=format\u0026n=j1sUFlbSAuzPUvc1\u0026q=85\u0026s=96e66e531e885dda9f0f968608e3d80a"},"favicon":"https://mintcdn.com/funnelfox/j1sUFlbSAuzPUvc1/logo2.png?fit=max\u0026auto=format\u0026n=j1sUFlbSAuzPUvc1\u0026q=85\u0026s=96e66e531e885dda9f0f968608e3d80a","navbar":{"links":[],"primary":{"type":"button","label":"Dashboard","href":"https://app.funnelfox.com"}},"footer":{"socials":{"x":"https://x.com/Funnelfoxhq","linkedin":"https://linkedin.com/company/funnelfoxhq"}},"integrations":{"ga4":{"measurementId":"G-P77PNGGTRP"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"funnelfox","hasAudioNarration":false,"actualSubdomain":"funnelfox","customDomains":["funnelfox.com"],"gitSource":{"type":"github","owner":"adaptyteam","repo":"funnelfox-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae3550686c7ae22426db31e","collectionId":"2407e5a7-f4be-4b12-b595-25285a1d76a5","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae3550686c7ae22426db31e"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae3550686c7ae22426db31e","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"FunnelFox","count":127},{"language":"default","tag":"Developer Docs","count":87},{"language":"default","tag":"FunnelFox Payments","count":81},{"language":"default","tag":"API reference","count":48},{"language":"default","tag":"Release Notes","count":47},{"language":"default","tag":"Changelog","count":47},{"language":"default","tag":"Integrations","count":43},{"language":"default","tag":"Webhook reference","count":42},{"language":"default","tag":"2025","count":34},{"language":"default","tag":"Editor","count":33}],"searchSettings":{"maxResults":6}},"assistantConfig":{"enableStarterQuestions":false},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".psp-compare table td:nth-child(n+2),.psp-compare table th:nth-child(n+2){text-align:center;vertical-align:middle}.psp-compare table td:first-child,.psp-compare table th:first-child{text-align:left;white-space:nowrap}"}],"page":{"pagePath":"api-reference/webhook-reference/dispute","slug":"/api-reference/webhook-reference/dispute","pageMetadata":{"title":"Dispute","description":null,"version":null,"deprecated":null,"openapi":"/swagger/webhooks-billing.json webhook dispute","href":"/api-reference/webhook-reference/dispute","autogeneratedByOpenApi":true},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Dispute","description":null,"version":null,"deprecated":null,"openapi":"/swagger/webhooks-billing.json webhook dispute","href":"/api-reference/webhook-reference/dispute","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Webhook reference"],"requestBody":"abbb5c2a-5aab-4f7f-a962-cb94b8baf354","method":"post","type":"webhook","servers":["24aaaa9f-00d3-4a89-8e7b-9aca8ad5cb9c"],"security":[],"path":"dispute","baseUrlOptions":["https://api.funnelfox.io/public/v1"],"title":"","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExamples":[{"language":"json","filename":"Example","code":"{\n \"event_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"event_timestamp\": \"2023-11-07T05:31:56Z\",\n \"is_livemode\": true,\n \"subtype\": \"opened\",\n \"dispute_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"user\": {\n \"external_id\": \"\u003cstring>\",\n \"email\": \"\u003cstring>\",\n \"email_aliases\": [\n \"\u003cstring>\"\n ]\n },\n \"order\": {\n \"order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": 123,\n \"currency_code\": \"\u003cstring>\",\n \"external_id\": \"\u003cstring>\",\n \"user_uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"initial_order_metadata\": {},\n \"subs_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"oneoff_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"psp_store_id\": \"\u003cstring>\",\n \"retry_step\": 123,\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"decline_reason\": {\n \"message\": \"\u003cstring>\",\n \"type\": \"\u003cstring>\",\n \"code\": \"\u003cstring>\",\n \"decline_type\": \"\u003cstring>\"\n }\n },\n \"psp_dispute_id\": \"\u003cstring>\",\n \"subscription\": {\n \"subs_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"is_active\": true,\n \"price_point\": {\n \"ident\": \"\u003cstring>\",\n \"currency\": {\n \"code\": \"\u003cstring>\",\n \"minor_units\": 123,\n \"title\": \"\u003cstring>\",\n \"symbol\": \"\u003cstring>\"\n },\n \"features\": [\n {\n \"ident\": \"\u003cstring>\"\n }\n ],\n \"lifetime_price\": 123,\n \"intro_free_trial_period\": 123,\n \"intro_paid_trial_price\": 123,\n \"intro_paid_trial_period\": 123,\n \"next_price\": 123,\n \"next_period\": 123\n },\n \"status\": [\n \"\u003cstring>\"\n ],\n \"started_at\": \"2023-11-07T05:31:56Z\",\n \"current_period_starts_at\": \"2023-11-07T05:31:56Z\",\n \"current_period_ends_at\": \"2023-11-07T05:31:56Z\",\n \"next_check_at\": \"2023-11-07T05:31:56Z\",\n \"iteration\": 123,\n \"available_actions\": [],\n \"initial_order_metadata\": {},\n \"next_payment_at\": \"2023-11-07T05:31:56Z\",\n \"unused_premium_after_pause\": 123\n },\n \"oneoff\": {\n \"oneoff_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"is_active\": true,\n \"price_point\": {\n \"ident\": \"\u003cstring>\",\n \"currency\": {\n \"code\": \"\u003cstring>\",\n \"minor_units\": 123,\n \"title\": \"\u003cstring>\",\n \"symbol\": \"\u003cstring>\"\n },\n \"features\": [\n {\n \"ident\": \"\u003cstring>\"\n }\n ],\n \"lifetime_price\": 123,\n \"intro_free_trial_period\": 123,\n \"intro_paid_trial_price\": 123,\n \"intro_paid_trial_period\": 123,\n \"next_price\": 123,\n \"next_period\": 123\n },\n \"started_at\": \"2023-11-07T05:31:56Z\",\n \"initial_order_metadata\": {},\n \"order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"revoked_at\": \"2023-11-07T05:31:56Z\"\n }\n}"}],"requestExampleType":"webhook","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"Sent once when a dispute is opened on an order. Currently only one subtype is possible:\n\n- **OPENED** - A dispute was registered for an order. Triggered on dispute creation only; subsequent status changes do not produce additional webhook events.\n\nDelivery is configured using the **Webhook dispute events** toggle on the Settings page of the FunnelFox Payments dashboard.","content":{"application/json":{"schema":{"properties":{"event_type":{"enum":["subscription","oneoff","order","refund","user","dispute"],"title":"NotificationsTypesEnum","type":"string","isRequired":true,"uniqueKey":"event_type","typeLabel":"enum\u003cstring>"},"event_id":{"format":"uuid","title":"Event Id","type":"string","isRequired":true,"uniqueKey":"event_id","typeLabel":"string\u003cuuid>"},"event_timestamp":{"format":"date-time","title":"Event Timestamp","type":"string","isRequired":true,"uniqueKey":"event_timestamp","typeLabel":"string\u003cdate-time>"},"is_livemode":{"title":"Is Livemode","type":"boolean","isRequired":true,"uniqueKey":"is_livemode","typeLabel":"boolean"},"subtype":{"enum":["opened"],"title":"DisputeEvents","type":"string","isRequired":true,"uniqueKey":"subtype","typeLabel":"enum\u003cstring>"},"dispute_id":{"format":"uuid","title":"Dispute Id","type":"string","description":"FunnelFox internal dispute identifier","isRequired":true,"uniqueKey":"dispute_id","typeLabel":"string\u003cuuid>"},"order_id":{"format":"uuid","title":"Order Id","type":"string","description":"FunnelFox order identifier the dispute belongs to","isRequired":true,"uniqueKey":"order_id","typeLabel":"string\u003cuuid>"},"user":{"properties":{"external_id":{"title":"External Id","type":"string","isRequired":true,"uniqueKey":"user.external_id","typeLabel":"string"},"email":{"title":"Email","type":"string","isRequired":true,"uniqueKey":"user.email","typeLabel":"string"},"email_aliases":{"description":"Previous email addresses associated with this user","items":{"type":"string","uniqueKey":"user.email_aliases.items.[INDEX]","typeLabel":"string"},"title":"Email Aliases","type":"array","isRequired":true,"uniqueKey":"user.email_aliases","typeLabel":"string[]"}},"required":["external_id","email","email_aliases"],"type":"object","isRequired":true,"uniqueKey":"user","typeLabel":"object"},"order":{"oneOf":[{"type":"object","description":"Full order details, including initial_order_metadata","required":["order_id","amount","currency_code","external_id","user_uuid","initial_order_metadata","status"],"properties":{"order_id":{"format":"uuid","title":"Order Id","type":"string","isRequired":true,"uniqueKey":"order.oneOf.0.order_id","typeLabel":"string\u003cuuid>"},"amount":{"oneOf":[{"type":"number","title":"Amount","isRequired":true,"uniqueKey":"order.oneOf.0.amount.oneOf.0","typeLabel":"number"},{"type":"string","title":"Amount","isRequired":true,"uniqueKey":"order.oneOf.0.amount.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"order.oneOf.0.amount","typeLabel":"number | string"},"currency_code":{"title":"Currency Code","type":"string","isRequired":true,"uniqueKey":"order.oneOf.0.currency_code","typeLabel":"string"},"external_id":{"title":"External Id","type":"string","isRequired":true,"uniqueKey":"order.oneOf.0.external_id","typeLabel":"string"},"user_uuid":{"format":"uuid","title":"User Uuid","type":"string","isRequired":true,"uniqueKey":"order.oneOf.0.user_uuid","typeLabel":"string\u003cuuid>"},"initial_order_metadata":{"additionalProperties":true,"type":"object","isRequired":true,"uniqueKey":"order.oneOf.0.initial_order_metadata","typeLabel":"object"},"status":{"enum":["settled","declined","success"],"title":"OrderStatus","type":"string","isRequired":true,"uniqueKey":"order.oneOf.0.status","typeLabel":"enum\u003cstring>"},"subs_id":{"oneOf":[{"format":"uuid","type":"string","uniqueKey":"order.oneOf.0.subs_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"format":"uuid","type":"null","uniqueKey":"order.oneOf.0.subs_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"order.oneOf.0.subs_id","typeLabel":"string\u003cuuid> | null"},"oneoff_id":{"oneOf":[{"format":"uuid","type":"string","uniqueKey":"order.oneOf.0.oneoff_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"format":"uuid","type":"null","uniqueKey":"order.oneOf.0.oneoff_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"order.oneOf.0.oneoff_id","typeLabel":"string\u003cuuid> | null"},"psp":{"oneOf":[{"type":"string","title":"PspEnum","description":"PSP that processed the payment.","enum":["stripe","braintree","paypal","adyen","checkout","primer_processor","airwallex","unlimint"],"uniqueKey":"order.oneOf.0.psp.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"order.oneOf.0.psp.oneOf.1","typeLabel":"null"}],"uniqueKey":"order.oneOf.0.psp","typeLabel":"enum\u003cstring> | null"},"psp_store_id":{"oneOf":[{"type":"string","description":"Adyen store that processed the payment, as sent to Primer in `ff_adyen_shop_id_\u003cregion>`. Adyen only reports it in its notification, so it appears once that notification is processed.","uniqueKey":"order.oneOf.0.psp_store_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Adyen store that processed the payment, as sent to Primer in `ff_adyen_shop_id_\u003cregion>`. Adyen only reports it in its notification, so it appears once that notification is processed.","uniqueKey":"order.oneOf.0.psp_store_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"order.oneOf.0.psp_store_id","typeLabel":"string | null"},"retry_step":{"oneOf":[{"type":"integer","uniqueKey":"order.oneOf.0.retry_step.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"order.oneOf.0.retry_step.oneOf.1","typeLabel":"null"}],"uniqueKey":"order.oneOf.0.retry_step","typeLabel":"integer | null"},"created_at":{"oneOf":[{"format":"date-time","type":"string","uniqueKey":"order.oneOf.0.created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"format":"date-time","type":"null","uniqueKey":"order.oneOf.0.created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"order.oneOf.0.created_at","typeLabel":"string\u003cdate-time> | null"},"decline_reason":{"oneOf":[{"type":"object","required":["message","type","code","decline_type"],"properties":{"message":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0.message.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0.message.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0.message","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0.type.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0.type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0.type","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0.code.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0.code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0.code","typeLabel":"string | null"},"decline_type":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0.decline_type.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0.decline_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0.decline_type","typeLabel":"string | null"}},"uniqueKey":"order.oneOf.0.decline_reason.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"order.oneOf.0.decline_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"order.oneOf.0.decline_reason","typeLabel":"object | null"}},"uniqueKey":"order.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"order.oneOf.1","typeLabel":"null"}],"uniqueKey":"order","typeLabel":"object | null"},"psp_dispute_id":{"oneOf":[{"type":"string","description":"PSP-assigned dispute identifier (e.g. Primer's processorDisputeId)","uniqueKey":"psp_dispute_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"PSP-assigned dispute identifier (e.g. Primer's processorDisputeId)","uniqueKey":"psp_dispute_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"psp_dispute_id","typeLabel":"string | null"},"processor":{"oneOf":[{"type":"string","title":"PspEnum","description":"Underlying payment processor that issued the dispute","enum":["stripe","braintree","paypal","adyen","checkout","primer_processor","airwallex","unlimint"],"uniqueKey":"processor.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"processor.oneOf.1","typeLabel":"null"}],"uniqueKey":"processor","typeLabel":"enum\u003cstring> | null"},"subscription":{"oneOf":[{"type":"object","required":["subs_id","is_active","price_point","status","started_at","current_period_starts_at","current_period_ends_at","next_check_at","iteration","available_actions","initial_order_metadata"],"properties":{"subs_id":{"format":"uuid","title":"Subs Id","type":"string","isRequired":true,"uniqueKey":"subscription.oneOf.0.subs_id","typeLabel":"string\u003cuuid>"},"is_active":{"description":"Whether premium features are available","title":"Is Active","type":"boolean","isRequired":true,"uniqueKey":"subscription.oneOf.0.is_active","typeLabel":"boolean"},"price_point":{"properties":{"ident":{"title":"Ident","type":"string","isRequired":true,"uniqueKey":"subscription.oneOf.0.price_point.ident","typeLabel":"string"},"currency":{"properties":{"code":{"title":"Code","type":"string","isRequired":true,"uniqueKey":"subscription.oneOf.0.price_point.currency.code","typeLabel":"string"},"minor_units":{"title":"Minor Units","type":"integer","isRequired":true,"uniqueKey":"subscription.oneOf.0.price_point.currency.minor_units","typeLabel":"integer"},"title":{"title":"Title","type":"string","isRequired":true,"uniqueKey":"subscription.oneOf.0.price_point.currency.title","typeLabel":"string"},"symbol":{"title":"Symbol","type":"string","isRequired":true,"uniqueKey":"subscription.oneOf.0.price_point.currency.symbol","typeLabel":"string"}},"required":["code","minor_units","title","symbol"],"type":"object","isRequired":true,"uniqueKey":"subscription.oneOf.0.price_point.currency","typeLabel":"object"},"intro_type":{"enum":["no_intro","free_trial","paid_trial"],"title":"IntroTypeEnum","type":"string","isRequired":true,"uniqueKey":"subscription.oneOf.0.price_point.intro_type","typeLabel":"enum\u003cstring>"},"features":{"description":"Premium features included","items":{"properties":{"ident":{"title":"Ident","type":"string","isRequired":true,"uniqueKey":"subscription.oneOf.0.price_point.features.items.[INDEX].ident","typeLabel":"string"}},"required":["ident"],"type":"object","uniqueKey":"subscription.oneOf.0.price_point.features.items.[INDEX]","typeLabel":"object"},"title":"Features","type":"array","isRequired":true,"uniqueKey":"subscription.oneOf.0.price_point.features","typeLabel":"Features · object[]"},"lifetime_price":{"oneOf":[{"type":"number","title":"Lifetime Price","uniqueKey":"subscription.oneOf.0.price_point.lifetime_price.oneOf.0","typeLabel":"number"},{"type":"string","title":"Lifetime Price","uniqueKey":"subscription.oneOf.0.price_point.lifetime_price.oneOf.1","typeLabel":"string"},{"type":"null","uniqueKey":"subscription.oneOf.0.price_point.lifetime_price.oneOf.2","typeLabel":"null"}],"uniqueKey":"subscription.oneOf.0.price_point.lifetime_price","typeLabel":"number | string | null"},"intro_free_trial_period":{"oneOf":[{"type":"integer","uniqueKey":"subscription.oneOf.0.price_point.intro_free_trial_period.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"subscription.oneOf.0.price_point.intro_free_trial_period.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription.oneOf.0.price_point.intro_free_trial_period","typeLabel":"integer | null"},"intro_free_trial_period_duration":{"oneOf":[{"type":"string","title":"DurationEnum","enum":["minutes","days","weeks","months","years"],"uniqueKey":"subscription.oneOf.0.price_point.intro_free_trial_period_duration.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"subscription.oneOf.0.price_point.intro_free_trial_period_duration.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription.oneOf.0.price_point.intro_free_trial_period_duration","typeLabel":"enum\u003cstring> | null"},"intro_paid_trial_price":{"oneOf":[{"type":"number","title":"Intro Paid Trial Price","uniqueKey":"subscription.oneOf.0.price_point.intro_paid_trial_price.oneOf.0","typeLabel":"number"},{"type":"string","title":"Intro Paid Trial Price","uniqueKey":"subscription.oneOf.0.price_point.intro_paid_trial_price.oneOf.1","typeLabel":"string"},{"type":"null","uniqueKey":"subscription.oneOf.0.price_point.intro_paid_trial_price.oneOf.2","typeLabel":"null"}],"uniqueKey":"subscription.oneOf.0.price_point.intro_paid_trial_price","typeLabel":"number | string | null"},"intro_paid_trial_period":{"oneOf":[{"type":"integer","uniqueKey":"subscription.oneOf.0.price_point.intro_paid_trial_period.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"subscription.oneOf.0.price_point.intro_paid_trial_period.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription.oneOf.0.price_point.intro_paid_trial_period","typeLabel":"integer | null"},"intro_paid_trial_period_duration":{"oneOf":[{"type":"string","title":"DurationEnum","enum":["minutes","days","weeks","months","years"],"uniqueKey":"subscription.oneOf.0.price_point.intro_paid_trial_period_duration.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"subscription.oneOf.0.price_point.intro_paid_trial_period_duration.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription.oneOf.0.price_point.intro_paid_trial_period_duration","typeLabel":"enum\u003cstring> | null"},"next_price":{"oneOf":[{"type":"number","title":"Next Price","uniqueKey":"subscription.oneOf.0.price_point.next_price.oneOf.0","typeLabel":"number"},{"type":"string","title":"Next Price","uniqueKey":"subscription.oneOf.0.price_point.next_price.oneOf.1","typeLabel":"string"},{"type":"null","uniqueKey":"subscription.oneOf.0.price_point.next_price.oneOf.2","typeLabel":"null"}],"uniqueKey":"subscription.oneOf.0.price_point.next_price","typeLabel":"number | string | null"},"next_period":{"oneOf":[{"type":"integer","uniqueKey":"subscription.oneOf.0.price_point.next_period.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"subscription.oneOf.0.price_point.next_period.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription.oneOf.0.price_point.next_period","typeLabel":"integer | null"},"next_period_duration":{"oneOf":[{"type":"string","title":"DurationEnum","enum":["minutes","days","weeks","months","years"],"uniqueKey":"subscription.oneOf.0.price_point.next_period_duration.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"subscription.oneOf.0.price_point.next_period_duration.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription.oneOf.0.price_point.next_period_duration","typeLabel":"enum\u003cstring> | null"}},"required":["ident","currency","intro_type","features"],"type":"object","isRequired":true,"uniqueKey":"subscription.oneOf.0.price_point","typeLabel":"object"},"status":{"description":"Subscription status","items":{"type":"string","uniqueKey":"subscription.oneOf.0.status.items.[INDEX]","typeLabel":"string"},"title":"Status","type":"array","isRequired":true,"uniqueKey":"subscription.oneOf.0.status","typeLabel":"string[]"},"started_at":{"description":"When subscription started. For the first billing cycle, this equals current_period_starts_at.","format":"date-time","title":"Started At","type":"string","isRequired":true,"uniqueKey":"subscription.oneOf.0.started_at","typeLabel":"string\u003cdate-time>"},"current_period_starts_at":{"description":"When current billing period starts. May be in the future because we charge users 2 hours in advance.","format":"date-time","title":"Current Period Starts At","type":"string","isRequired":true,"uniqueKey":"subscription.oneOf.0.current_period_starts_at","typeLabel":"string\u003cdate-time>"},"current_period_ends_at":{"description":"When current billing period ends. May be in the past if the last charge failed.","format":"date-time","title":"Current Period Ends At","type":"string","isRequired":true,"uniqueKey":"subscription.oneOf.0.current_period_ends_at","typeLabel":"string\u003cdate-time>"},"next_check_at":{"oneOf":[{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"subscription.oneOf.0.next_check_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"format":"date-time","type":"null","isRequired":true,"uniqueKey":"subscription.oneOf.0.next_check_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"subscription.oneOf.0.next_check_at","typeLabel":"string\u003cdate-time> | null"},"iteration":{"description":"Billing cycle number","title":"Iteration","type":"integer","isRequired":true,"uniqueKey":"subscription.oneOf.0.iteration","typeLabel":"integer"},"available_actions":{"description":"Actions you can perform on this subscription","items":{"enum":["pause","resume","defer","disable_autorenew","enable_autorenew","create_discount","migration"],"title":"SubsAwailableActions","type":"string","uniqueKey":"subscription.oneOf.0.available_actions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"title":"Available Actions","type":"array","isRequired":true,"uniqueKey":"subscription.oneOf.0.available_actions","typeLabel":"enum\u003cstring>[]"},"initial_order_metadata":{"additionalProperties":true,"description":"Custom metadata from the initial order","type":"object","isRequired":true,"uniqueKey":"subscription.oneOf.0.initial_order_metadata","typeLabel":"object"},"next_payment_at":{"oneOf":[{"format":"date-time","type":"string","uniqueKey":"subscription.oneOf.0.next_payment_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"format":"date-time","type":"null","uniqueKey":"subscription.oneOf.0.next_payment_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription.oneOf.0.next_payment_at","typeLabel":"string\u003cdate-time> | null"},"unused_premium_after_pause":{"oneOf":[{"type":"integer","uniqueKey":"subscription.oneOf.0.unused_premium_after_pause.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"subscription.oneOf.0.unused_premium_after_pause.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription.oneOf.0.unused_premium_after_pause","typeLabel":"integer | null"}},"uniqueKey":"subscription.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"subscription.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription","typeLabel":"object | null"},"oneoff":{"oneOf":[{"type":"object","required":["oneoff_id","is_active","price_point","started_at","initial_order_metadata","order_id"],"properties":{"oneoff_id":{"format":"uuid","title":"Oneoff Id","type":"string","isRequired":true,"uniqueKey":"oneoff.oneOf.0.oneoff_id","typeLabel":"string\u003cuuid>"},"is_active":{"description":"Whether premium features are available","title":"Is Active","type":"boolean","isRequired":true,"uniqueKey":"oneoff.oneOf.0.is_active","typeLabel":"boolean"},"price_point":{"properties":{"ident":{"title":"Ident","type":"string","isRequired":true,"uniqueKey":"oneoff.oneOf.0.price_point.ident","typeLabel":"string"},"currency":{"properties":{"code":{"title":"Code","type":"string","isRequired":true,"uniqueKey":"oneoff.oneOf.0.price_point.currency.code","typeLabel":"string"},"minor_units":{"title":"Minor Units","type":"integer","isRequired":true,"uniqueKey":"oneoff.oneOf.0.price_point.currency.minor_units","typeLabel":"integer"},"title":{"title":"Title","type":"string","isRequired":true,"uniqueKey":"oneoff.oneOf.0.price_point.currency.title","typeLabel":"string"},"symbol":{"title":"Symbol","type":"string","isRequired":true,"uniqueKey":"oneoff.oneOf.0.price_point.currency.symbol","typeLabel":"string"}},"required":["code","minor_units","title","symbol"],"type":"object","isRequired":true,"uniqueKey":"oneoff.oneOf.0.price_point.currency","typeLabel":"object"},"intro_type":{"enum":["no_intro","free_trial","paid_trial"],"title":"IntroTypeEnum","type":"string","isRequired":true,"uniqueKey":"oneoff.oneOf.0.price_point.intro_type","typeLabel":"enum\u003cstring>"},"features":{"description":"Premium features included","items":{"properties":{"ident":{"title":"Ident","type":"string","isRequired":true,"uniqueKey":"oneoff.oneOf.0.price_point.features.items.[INDEX].ident","typeLabel":"string"}},"required":["ident"],"type":"object","uniqueKey":"oneoff.oneOf.0.price_point.features.items.[INDEX]","typeLabel":"object"},"title":"Features","type":"array","isRequired":true,"uniqueKey":"oneoff.oneOf.0.price_point.features","typeLabel":"Features · object[]"},"lifetime_price":{"oneOf":[{"type":"number","title":"Lifetime Price","uniqueKey":"oneoff.oneOf.0.price_point.lifetime_price.oneOf.0","typeLabel":"number"},{"type":"string","title":"Lifetime Price","uniqueKey":"oneoff.oneOf.0.price_point.lifetime_price.oneOf.1","typeLabel":"string"},{"type":"null","uniqueKey":"oneoff.oneOf.0.price_point.lifetime_price.oneOf.2","typeLabel":"null"}],"uniqueKey":"oneoff.oneOf.0.price_point.lifetime_price","typeLabel":"number | string | null"},"intro_free_trial_period":{"oneOf":[{"type":"integer","uniqueKey":"oneoff.oneOf.0.price_point.intro_free_trial_period.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"oneoff.oneOf.0.price_point.intro_free_trial_period.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneoff.oneOf.0.price_point.intro_free_trial_period","typeLabel":"integer | null"},"intro_free_trial_period_duration":{"oneOf":[{"type":"string","title":"DurationEnum","enum":["minutes","days","weeks","months","years"],"uniqueKey":"oneoff.oneOf.0.price_point.intro_free_trial_period_duration.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"oneoff.oneOf.0.price_point.intro_free_trial_period_duration.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneoff.oneOf.0.price_point.intro_free_trial_period_duration","typeLabel":"enum\u003cstring> | null"},"intro_paid_trial_price":{"oneOf":[{"type":"number","title":"Intro Paid Trial Price","uniqueKey":"oneoff.oneOf.0.price_point.intro_paid_trial_price.oneOf.0","typeLabel":"number"},{"type":"string","title":"Intro Paid Trial Price","uniqueKey":"oneoff.oneOf.0.price_point.intro_paid_trial_price.oneOf.1","typeLabel":"string"},{"type":"null","uniqueKey":"oneoff.oneOf.0.price_point.intro_paid_trial_price.oneOf.2","typeLabel":"null"}],"uniqueKey":"oneoff.oneOf.0.price_point.intro_paid_trial_price","typeLabel":"number | string | null"},"intro_paid_trial_period":{"oneOf":[{"type":"integer","uniqueKey":"oneoff.oneOf.0.price_point.intro_paid_trial_period.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"oneoff.oneOf.0.price_point.intro_paid_trial_period.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneoff.oneOf.0.price_point.intro_paid_trial_period","typeLabel":"integer | null"},"intro_paid_trial_period_duration":{"oneOf":[{"type":"string","title":"DurationEnum","enum":["minutes","days","weeks","months","years"],"uniqueKey":"oneoff.oneOf.0.price_point.intro_paid_trial_period_duration.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"oneoff.oneOf.0.price_point.intro_paid_trial_period_duration.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneoff.oneOf.0.price_point.intro_paid_trial_period_duration","typeLabel":"enum\u003cstring> | null"},"next_price":{"oneOf":[{"type":"number","title":"Next Price","uniqueKey":"oneoff.oneOf.0.price_point.next_price.oneOf.0","typeLabel":"number"},{"type":"string","title":"Next Price","uniqueKey":"oneoff.oneOf.0.price_point.next_price.oneOf.1","typeLabel":"string"},{"type":"null","uniqueKey":"oneoff.oneOf.0.price_point.next_price.oneOf.2","typeLabel":"null"}],"uniqueKey":"oneoff.oneOf.0.price_point.next_price","typeLabel":"number | string | null"},"next_period":{"oneOf":[{"type":"integer","uniqueKey":"oneoff.oneOf.0.price_point.next_period.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"oneoff.oneOf.0.price_point.next_period.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneoff.oneOf.0.price_point.next_period","typeLabel":"integer | null"},"next_period_duration":{"oneOf":[{"type":"string","title":"DurationEnum","enum":["minutes","days","weeks","months","years"],"uniqueKey":"oneoff.oneOf.0.price_point.next_period_duration.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"oneoff.oneOf.0.price_point.next_period_duration.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneoff.oneOf.0.price_point.next_period_duration","typeLabel":"enum\u003cstring> | null"}},"required":["ident","currency","intro_type","features"],"type":"object","isRequired":true,"uniqueKey":"oneoff.oneOf.0.price_point","typeLabel":"object"},"started_at":{"description":"When subscription started. For the first billing cycle, this equals current_period_starts_at.","format":"date-time","title":"Started At","type":"string","isRequired":true,"uniqueKey":"oneoff.oneOf.0.started_at","typeLabel":"string\u003cdate-time>"},"initial_order_metadata":{"additionalProperties":true,"description":"Custom metadata from the initial order","type":"object","isRequired":true,"uniqueKey":"oneoff.oneOf.0.initial_order_metadata","typeLabel":"object"},"order_id":{"format":"uuid","title":"Order Id","type":"string","isRequired":true,"uniqueKey":"oneoff.oneOf.0.order_id","typeLabel":"string\u003cuuid>"},"revoked_at":{"oneOf":[{"format":"date-time","type":"string","uniqueKey":"oneoff.oneOf.0.revoked_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"format":"date-time","type":"null","uniqueKey":"oneoff.oneOf.0.revoked_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneoff.oneOf.0.revoked_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"oneoff.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"oneoff.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneoff","typeLabel":"object | null"}},"required":["event_type","event_id","event_timestamp","is_livemode","subtype","dispute_id","order_id","user"],"title":"DisputeWebhookPayloadOut","type":"object","uniqueKey":"","typeLabel":"DisputeWebhookPayloadOut · object"},"examples":{"Example":{"title":"Example","value":{"event_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","event_timestamp":"2023-11-07T05:31:56Z","is_livemode":true,"subtype":"opened","dispute_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","order_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","user":{"external_id":"\u003cstring>","email":"\u003cstring>","email_aliases":["\u003cstring>"]},"order":{"order_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","amount":123,"currency_code":"\u003cstring>","external_id":"\u003cstring>","user_uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","initial_order_metadata":{},"subs_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","oneoff_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","psp_store_id":"\u003cstring>","retry_step":123,"created_at":"2023-11-07T05:31:56Z","decline_reason":{"message":"\u003cstring>","type":"\u003cstring>","code":"\u003cstring>","decline_type":"\u003cstring>"}},"psp_dispute_id":"\u003cstring>","subscription":{"subs_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","is_active":true,"price_point":{"ident":"\u003cstring>","currency":{"code":"\u003cstring>","minor_units":123,"title":"\u003cstring>","symbol":"\u003cstring>"},"features":[{"ident":"\u003cstring>"}],"lifetime_price":123,"intro_free_trial_period":123,"intro_paid_trial_price":123,"intro_paid_trial_period":123,"next_price":123,"next_period":123},"status":["\u003cstring>"],"started_at":"2023-11-07T05:31:56Z","current_period_starts_at":"2023-11-07T05:31:56Z","current_period_ends_at":"2023-11-07T05:31:56Z","next_check_at":"2023-11-07T05:31:56Z","iteration":123,"available_actions":[],"initial_order_metadata":{},"next_payment_at":"2023-11-07T05:31:56Z","unused_premium_after_pause":123},"oneoff":{"oneoff_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","is_active":true,"price_point":{"ident":"\u003cstring>","currency":{"code":"\u003cstring>","minor_units":123,"title":"\u003cstring>","symbol":"\u003cstring>"},"features":[{"ident":"\u003cstring>"}],"lifetime_price":123,"intro_free_trial_period":123,"intro_paid_trial_price":123,"intro_paid_trial_period":123,"next_price":123,"next_period":123},"started_at":"2023-11-07T05:31:56Z","initial_order_metadata":{},"order_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","revoked_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{},"security":{},"servers":{"24aaaa9f-00d3-4a89-8e7b-9aca8ad5cb9c":{"url":"https://api.funnelfox.io/public/v1"}}},"originalFileLocation":"swagger/webhooks-billing.json"},"subdomain":"funnelfox","siteName":"FunnelFox","title":"Dispute - FunnelFox","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T14:16:11.772Z","originalFileLocation":"api-reference/webhook-reference/dispute.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"FunnelFox\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/funnelfox/WR6O_i08dMvZ1LJb/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/funnelfox/WR6O_i08dMvZ1LJb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/funnelfox/WR6O_i08dMvZ1LJb/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/funnelfox/WR6O_i08dMvZ1LJb/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/funnelfox/WR6O_i08dMvZ1LJb/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/funnelfox/WR6O_i08dMvZ1LJb/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/funnelfox/WR6O_i08dMvZ1LJb/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/funnelfox/WR6O_i08dMvZ1LJb/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/funnelfox/WR6O_i08dMvZ1LJb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Dispute - FunnelFox\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FunnelFox\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://funnelfox.com/docs/api-reference/webhook-reference/dispute\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://funnelfox.mintlify.app/_mintlify/api/og/v2?division=Webhook+reference\u0026amp;title=Dispute\u0026amp;theme=255e85bca02bae65bbe41ad3\u0026amp;signature=04d0dc7547d3a9288ae4b4f8a5cd8104418a557e78c3bb2ef102c3df6b5e9af4\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Dispute - FunnelFox\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://funnelfox.mintlify.app/_mintlify/api/og/v2?division=Webhook+reference\u0026amp;title=Dispute\u0026amp;theme=255e85bca02bae65bbe41ad3\u0026amp;signature=04d0dc7547d3a9288ae4b4f8a5cd8104418a557e78c3bb2ef102c3df6b5e9af4\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/funnelfox/WR6O_i08dMvZ1LJb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FunnelFox\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#e18535\">\u003clink data-mint-head rel=\"canonical\" href=\"https://funnelfox.com/docs/api-reference/webhook-reference/dispute\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/webhook-reference/dispute.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://funnelfox.com/#organization\",\"name\":\"FunnelFox\",\"url\":\"https://funnelfox.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/funnelfox/j1sUFlbSAuzPUvc1/logo2.png?fit=max\u0026auto=format\u0026n=j1sUFlbSAuzPUvc1\u0026q=85\u0026s=96e66e531e885dda9f0f968608e3d80a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://funnelfox.com/docs#website\",\"name\":\"FunnelFox\",\"url\":\"https://funnelfox.com/docs\",\"publisher\":{\"@id\":\"https://funnelfox.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://funnelfox.com/docs/api-reference/webhook-reference/dispute#webpage\",\"url\":\"https://funnelfox.com/docs/api-reference/webhook-reference/dispute\",\"name\":\"Dispute\",\"dateModified\":\"2026-10-29T14:16:11.772Z\",\"isPartOf\":{\"@id\":\"https://funnelfox.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://funnelfox.com/docs/api-reference/webhook-reference/dispute#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://funnelfox.com/docs/api-reference/webhook-reference/dispute#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Webhook reference\",\"item\":\"https://funnelfox.com/docs/develop/webhooks-billing\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Webhook reference\",\"item\":\"https://funnelfox.com/docs/api-reference/webhook-reference/order\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Dispute\",\"item\":\"https://funnelfox.com/docs/api-reference/webhook-reference/dispute\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://funnelfox.com/docs/api-reference/webhook-reference/dispute#apireference\",\"headline\":\"Dispute\",\"name\":\"Dispute\",\"url\":\"https://funnelfox.com/docs/api-reference/webhook-reference/dispute\",\"mainEntityOfPage\":{\"@id\":\"https://funnelfox.com/docs/api-reference/webhook-reference/dispute#webpage\"},\"dateModified\":\"2026-10-29T14:16:11.772Z\",\"publisher\":{\"@id\":\"https://funnelfox.com/#organization\"},\"isPartOf\":{\"@id\":\"https://funnelfox.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FunnelFox\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"FunnelFox","nav":{"global":null,"tabs":[{"tab":"FunnelFox","pages":[{"title":"FunnelFox","href":"/getting-started"}]},{"tab":"FunnelFox Payments","pages":[{"title":"FunnelFox Payments","href":"/billing"}]},{"tab":"Market Radar","pages":[{"title":"Market Radar","href":"/radar/overview"}]},{"tab":"Developer Docs","anchors":[{"anchor":"FunnelFox","icon":"square-chevron-up","pages":[{"title":"FunnelFox","href":"/develop/api"}]},{"anchor":"FunnelFox Payments","icon":"square-chevron-down","groups":[{"group":"API reference","pages":[{"title":"FunnelFox Payments API","sidebarTitle":"FunnelFox Payments API","href":"/develop/api-billing"},{"group":"Payment management","pages":[{"title":"Refund an order","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /payment/refund","href":"/api-reference/payment-management/refund-an-order"},{"title":"Cancel an order","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /payment/cancel","href":"/api-reference/payment-management/cancel-an-order"},{"title":"Charge a custom amount to a saved card","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /payment/one_off_charge","href":"/api-reference/payment-management/charge-a-custom-amount-to-a-saved-card"}]},{"group":"Subscription management","pages":[{"title":"Enable subscription auto-renewal","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /subscription/enable_autorenew","href":"/api-reference/subscription-management/enable-subscription-auto-renewal"},{"title":"Disable subscription auto-renewal (cancel)","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /subscription/disable_autorenew","href":"/api-reference/subscription-management/disable-subscription-auto-renewal-cancel"},{"title":"Migrate a subscription to a new plan","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /subscription/migration","href":"/api-reference/subscription-management/migrate-a-subscription-to-a-new-plan"},{"title":"Apply a discount to a subscription","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /discount","href":"/api-reference/subscription-management/apply-a-discount-to-a-subscription"},{"title":"Defer a subscription's next charge","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /subscription/defer","href":"/api-reference/subscription-management/defer-a-subscriptions-next-charge"},{"title":"Pause a subscription","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /subscription/pause","href":"/api-reference/subscription-management/pause-a-subscription"},{"title":"Resume a paused subscription","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /subscription/resume","href":"/api-reference/subscription-management/resume-a-paused-subscription"},{"title":"Search and filter subscriptions","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /subscription/search","href":"/api-reference/subscription-management/search-and-filter-subscriptions"}]},{"group":"PricePoints","pages":[{"title":"List price points","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /price_points","href":"/api-reference/pricepoints/list-price-points"},{"title":"List price points with admin fields","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /pp/list","href":"/api-reference/pricepoints/list-price-points-with-admin-fields"},{"title":"Export price points as CSV","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /pp/export_csv","href":"/api-reference/pricepoints/export-price-points-as-csv"},{"title":"Import price points from CSV","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /pp/import_csv","href":"/api-reference/pricepoints/import-price-points-from-csv"},{"title":"Update a price point","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /pp/update","href":"/api-reference/pricepoints/update-a-price-point"},{"title":"Create a price point","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /pp/create","href":"/api-reference/pricepoints/create-a-price-point"},{"title":"Create a feature (offering)","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /feature/create","href":"/api-reference/pricepoints/create-a-feature-offering"},{"title":"List all features (offerings)","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /features","href":"/api-reference/pricepoints/list-all-features-offerings"}]},{"group":"Information","pages":[{"title":"List a user's subscriptions and one-off purchases","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /my_assets","href":"/api-reference/information/list-a-users-subscriptions-and-one-off-purchases"},{"title":"Return successful payments of user","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /payments_history","href":"/api-reference/information/return-successful-payments-of-user"},{"title":"Return all transactions","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /transaction_report","href":"/api-reference/information/return-all-transactions"},{"title":"Search user","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /search_users","href":"/api-reference/information/search-user"}]},{"group":"User management","pages":[{"title":"Update email of user","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /user/update_email","href":"/api-reference/user-management/update-email-of-user"}]},{"group":"Checkout","pages":[{"title":"Create a checkout session (client token)","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /checkout/create_client_session","href":"/api-reference/checkout/create-a-checkout-session-client-token"},{"title":"Create a simple checkout session","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /checkout/create_simple_client_session","href":"/api-reference/checkout/create-a-simple-checkout-session"},{"title":"Update a checkout session","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /checkout/update_client_session","href":"/api-reference/checkout/update-a-checkout-session"},{"title":"Complete payment for an order","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /checkout/create_payment","href":"/api-reference/checkout/complete-payment-for-an-order"},{"title":"Perform a one-click purchase","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /checkout/one_click","href":"/api-reference/checkout/perform-a-one-click-purchase"},{"title":"Resume a pending payment","deprecated":null,"version":null,"openapi":"/swagger/openapi-billing.json post /checkout/resume_payment","href":"/api-reference/checkout/resume-a-pending-payment"}]}]},{"group":"Webhook reference","pages":[{"title":"Subscription engine webhook events","sidebarTitle":"FunnelFox Payments webhooks","href":"/develop/webhooks-billing"},{"group":"Webhook reference","pages":[{"title":"Order","version":null,"deprecated":null,"openapi":"/swagger/webhooks-billing.json webhook order","href":"/api-reference/webhook-reference/order"},{"title":"Subscription","version":null,"deprecated":null,"openapi":"/swagger/webhooks-billing.json webhook subscription","href":"/api-reference/webhook-reference/subscription"},{"title":"Oneoff","version":null,"deprecated":null,"openapi":"/swagger/webhooks-billing.json webhook oneoff","href":"/api-reference/webhook-reference/oneoff"},{"title":"Refund","version":null,"deprecated":null,"openapi":"/swagger/webhooks-billing.json webhook refund","href":"/api-reference/webhook-reference/refund"},{"title":"User","description":null,"version":null,"deprecated":null,"openapi":"/swagger/webhooks-billing.json webhook user","href":"/api-reference/webhook-reference/user"},{"title":"Dispute","version":null,"deprecated":null,"openapi":"/swagger/webhooks-billing.json webhook dispute","href":"/api-reference/webhook-reference/dispute"}]}]},{"group":"Billing Web SDK","pages":[{"title":"Web SDK quickstart guide","sidebarTitle":"Quickstart","description":"Get started with the FunnelFox Payments Web SDK: install it, choose an integration, and render your first checkout.","href":"/develop/web-sdk-quickstart"},{"group":"SDK reference","pages":[{"group":"Methods","pages":[{"title":"configure(config)","sidebarTitle":"configure","href":"/develop/configure"},{"title":"Create checkout programmatically","sidebarTitle":"createCheckout","href":"/develop/create-checkout"},{"title":"initMethod(method, element, options)","sidebarTitle":"initMethod","href":"/develop/init-method"},{"title":"getAvailablePaymentMethods(params)","sidebarTitle":"getAvailablePaymentMethods","href":"/develop/get-available-payment-methods"},{"title":"silentPurchase(options)","sidebarTitle":"silentPurchase","href":"/develop/silent-purchase"},{"title":"createClientSession(params)","sidebarTitle":"createClientSession","href":"/develop/create-client-session"},{"title":"Stripe methods","sidebarTitle":"Billing.stripe","href":"/develop/stripe"}]},{"title":"CheckoutInstance","sidebarTitle":"CheckoutInstance","href":"/develop/checkout-instance"},{"title":"Web SDK events reference","sidebarTitle":"Events","href":"/develop/web-sdk-events"},{"title":"Types","sidebarTitle":"Types","href":"/develop/types"}]},{"title":"Error handling","sidebarTitle":"Error handling","href":"/develop/error-handling"},{"title":"Taxes in Web SDK","sidebarTitle":"Taxes","href":"/develop/web-sdk-taxes"},{"title":"Code examples \u0026 tutorials","sidebarTitle":"Examples","href":"/develop/examples"},{"title":"Checkout customization","sidebarTitle":"Checkout customization","href":"/develop/checkout-customization"},{"title":"Advanced SDK usage","sidebarTitle":"Advanced usage","href":"/develop/advanced-usage"}]}]}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes/changelog"}]}]},"basePath":"","title":"Dispute - FunnelFox","buildId":"dpl_4RHMRqtvdHvKgaEfTTjFqjzja3B6","deploymentId":"dpl_4RHMRqtvdHvKgaEfTTjFqjzja3B6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-D_4Sesi0.js","utils-DRHeK26p.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C6d-DUc2.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dex7slho.js","snippetPresets-BcCEBp0Z.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CufowNTX.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-A4lJSCIe.js","shallow-DqoHP7zn.js","getApiPlaygroundDisplay-Cku8AmtL.js","CodeSnippet-CtHQbNqc.js","CodeSnippets-CGo5Cslf.js","Page-BoJxk0m8.js","getPastedJson-M-bKdue4.js","icon-DEqCU4st.js","MethodPill-DnfSSXiJ.js","DuplicateIcon-BHu2PE8M.js","createIcon-BPsE5X7c.js","DynamicMarkdown-Dnt6YhtR.js","SectionHeading-6CtFWqMQ.js","axios-vUo_bRtp.js","Markdown-BoKe_1fI.js","clsx-DM5-sUNJ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CkIdkovK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-B3e6Nh_r.js"]}