{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tabby","colors":{"primary":"#41A854","light":"#6CFF93","dark":"#41A854"},"logo":{"light":"https://mintcdn.com/tabby-5f40add6/1f-EIKwKexPNgWGm/logo/tabby-badge.svg?fit=max\u0026auto=format\u0026n=1f-EIKwKexPNgWGm\u0026q=85\u0026s=f9bf7cbe04bdae76df344b4746a6b12d","dark":"https://mintcdn.com/tabby-5f40add6/1f-EIKwKexPNgWGm/logo/tabby-badge.svg?fit=max\u0026auto=format\u0026n=1f-EIKwKexPNgWGm\u0026q=85\u0026s=f9bf7cbe04bdae76df344b4746a6b12d"},"favicon":"https://mintcdn.com/tabby-5f40add6/DEnsVYrXIrpLyZIh/favicon-new.png?fit=max\u0026auto=format\u0026n=DEnsVYrXIrpLyZIh\u0026q=85\u0026s=2f86273ef58d487ed55812e722f3db93","api":{"playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["curl","python","javascript","php","go","java","ruby"],"prefill":true}},"appearance":{"default":"light","strict":false},"navbar":{"primary":{"type":"button","label":"Register","href":"https://merchant.tabby.ai"}},"footer":{"socials":{"facebook":"https://www.facebook.com/tabbypay-100185885064531","instagram":"https://instagram.com/tabbypay","linkedin":"https://www.linkedin.com/company/tabbypay","x":"https://twitter.com/paywithtabby?lang=en"}},"styling":{"codeblocks":"dark","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","mcp"],"display":"header"},"navigation":{"languages":[{"language":"en","default":true,"href":"introduction/what-is-tabby"},{"language":"ar","href":"ar/marketing/toolkit"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tabby-5f40add6","hasAudioNarration":false,"actualSubdomain":"tabby-5f40add6","customDomains":["docs.tabby.ai"],"gitSource":{"type":"github","owner":"tabby-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb060cb8cee1c0eaa27a4e","collectionId":"5d6447fb-7b7d-4278-8447-65c492cc55b8","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb060cb8cee1c0eaa27a4e"},"feedback":{"issues":true,"edits":true,"thumbs":true},"entitlements":{},"buildId":"6adb060cb8cee1c0eaa27a4e","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"en","tag":"Documentation","count":36},{"language":"en","tag":"API Playground","count":28},{"language":"en","tag":"E-commerce Platforms","count":15},{"language":"en","tag":"Online Custom Integration","count":12},{"language":"en","tag":"Webhooks","count":7},{"language":"en","tag":"Disputes","count":6},{"language":"en","tag":"Payments","count":6},{"language":"en","tag":"Dispute Webhooks","count":5},{"language":"en","tag":"Introduction","count":5},{"language":"en","tag":"Shopify","count":3},{"language":"ar","tag":"مجموعة أدوات التسويق","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"@font-face{font-family:'Tabby Sans Display';src:url(/fonts/TabbySansDisplay-Bold.woff2) format('woff2');font-weight:100 900;font-style:normal;font-display:swap}@font-face{font-family:'Tabby Sans Text';src:url(/fonts/TabbySansText-Regular.woff2) format('woff2');font-weight:100 400;font-style:normal;font-display:swap}@font-face{font-family:'Tabby Sans Text';src:url(/fonts/TabbySansText-Medium.woff2) format('woff2');font-weight:500 600;font-style:normal;font-display:swap}@font-face{font-family:'Tabby Sans Text';src:url(/fonts/TabbySansText-Bold.woff2) format('woff2');font-weight:700 900;font-style:normal;font-display:swap}.font-sans,body{font-family:'Tabby Sans Text',ui-sans-serif,system-ui,-apple-system,sans-serif!important}h1,h2,h3,h4{font-family:'Tabby Sans Display','Tabby Sans Text',sans-serif;letter-spacing:normal!important}img.product-shot,video.product-shot{display:block;margin:1.5rem auto;border-radius:1rem;border:1px solid rgb(10 10 10/.1);box-shadow:0 10px 25px -5px rgb(0 0 0/.12),0 4px 10px -6px rgb(0 0 0/.1)}.dark img.product-shot,.dark video.product-shot{border-color:rgb(255 255 255/.15);box-shadow:0 10px 25px -5px rgb(0 0 0/.45)}img.framed-shot,img.snippet-shot{display:block;margin:1.5rem auto}img.framed-shot{width:min(520px,100%);border-radius:12px}li img.framed-shot{width:min(520px,calc(100% - 38px))}div.product-shot-figure{margin:1.5rem auto;text-align:center}div.product-shot-figure img.product-shot{margin:1.5rem auto 0}p.product-shot-caption{margin-top:.75rem;font-size:.875rem;color:rgb(107 114 128)}html[lang=ar] #content,html[lang=ar] .mdx-content{direction:rtl}html[lang=ar] #header{direction:rtl;text-align:right}html[lang=ar] #content :is(ul, ol)>li{padding-left:6px;padding-right:32px}html[lang=ar] #content :is(ul, ol)>li::before{left:auto;right:8px}html[lang=ar] #content a svg.rotate-0.overflow-visible,html[lang=ar] #content svg.lucide-arrow-right,html[lang=ar] #content svg.lucide-arrow-up-right,html[lang=ar] #content svg.lucide-chevron-right{transform:scaleX(-1)}html[lang=ar] #content .absolute:has(>svg.lucide-arrow-up-right){right:auto;left:1.25rem}html[lang=ar] #content blockquote{border-left-width:0}#content-area .mdx-content,#content-container .mdx-content{max-width:80ch}@media (min-width:1280px){.max-w-8xl,div:has(>#content-container){max-width:100rem!important}}button[data-component-part=code-block-footer-button]{color:#6cff93!important;font-weight:600}button[data-component-part=code-block-footer-button]:hover{text-decoration:underline}.messaging-table table td:first-child,.messaging-table table th:first-child{width:1%;min-width:0;white-space:nowrap}:root:not(.dark) span[data-badge=true][data-color=gray]{background-color:#f5f4f2!important;color:#1a1919!important}:root:not(.dark) span[data-badge=true][data-color=blue]{background-color:#dfecf7!important;color:#3380c0!important}:root:not(.dark) span[data-badge=true][data-color=green]{background-color:#daf0df!important;color:#238e3b!important}:root:not(.dark) span[data-badge=true][data-color=yellow]{background-color:#fcedb8!important;color:#d66a1e!important}:root:not(.dark) span[data-badge=true][data-color=orange]{background-color:#ffe6cc!important;color:#d66a1e!important}:root:not(.dark) span[data-badge=true][data-color=red]{background-color:#ffe1de!important;color:#d44c3b!important}:root:not(.dark) span[data-badge=true][data-color=purple]{background-color:#f5defa!important;color:#a55ab8!important}:root:not(.dark) .callout[data-callout-type=info],:root:not(.dark) .callout[data-callout-type=note]{background-color:#dfecf7!important;border-color:#c4dcef!important}:root:not(.dark) .callout[data-callout-type=info] [data-component-part=callout-content],:root:not(.dark) .callout[data-callout-type=info] [data-component-part=callout-icon],:root:not(.dark) .callout[data-callout-type=note] [data-component-part=callout-content],:root:not(.dark) .callout[data-callout-type=note] [data-component-part=callout-icon]{color:#3380c0!important}:root:not(.dark) .callout[data-callout-type=check],:root:not(.dark) .callout[data-callout-type=tip]{background-color:#daf0df!important;border-color:#bfe4c9!important}:root:not(.dark) .callout[data-callout-type=check] [data-component-part=callout-content],:root:not(.dark) .callout[data-callout-type=check] [data-component-part=callout-icon],:root:not(.dark) .callout[data-callout-type=tip] [data-component-part=callout-content],:root:not(.dark) .callout[data-callout-type=tip] [data-component-part=callout-icon]{color:#238e3b!important}:root:not(.dark) .callout[data-callout-type=danger]{background-color:#ffe1de!important;border-color:#ffc7c1!important}:root:not(.dark) .callout[data-callout-type=danger] [data-component-part=callout-content],:root:not(.dark) .callout[data-callout-type=danger] [data-component-part=callout-icon]{color:#d44c3b!important}:root:not(.dark) .callout[data-callout-type=warning]{background-color:#fcedb8!important;border-color:#f5de8e!important}:root:not(.dark) .callout[data-callout-type=warning] [data-component-part=callout-content],:root:not(.dark) .callout[data-callout-type=warning] [data-component-part=callout-icon]{color:#d66a1e!important}.dark span[data-badge=true][data-color=gray]{background-color:rgb(245 244 242/.12)!important;color:#e8e6e3!important}.dark span[data-badge=true][data-color=blue]{background-color:rgb(51 128 192/.22)!important;color:#dfecf7!important}.dark span[data-badge=true][data-color=green]{background-color:rgb(35 142 59/.22)!important;color:#daf0df!important}.dark span[data-badge=true][data-color=yellow]{background-color:rgb(214 106 30/.22)!important;color:#fcedb8!important}.dark span[data-badge=true][data-color=orange]{background-color:rgb(214 106 30/.22)!important;color:#ffe6cc!important}.dark span[data-badge=true][data-color=red]{background-color:rgb(212 76 59/.22)!important;color:#ffe1de!important}.dark span[data-badge=true][data-color=purple]{background-color:rgb(165 90 184/.22)!important;color:#f5defa!important}.dark .callout[data-callout-type=info],.dark .callout[data-callout-type=note]{background-color:rgb(51 128 192/.18)!important;border-color:rgb(51 128 192/.45)!important}.dark .callout[data-callout-type=info] [data-component-part=callout-content],.dark .callout[data-callout-type=info] [data-component-part=callout-icon],.dark .callout[data-callout-type=note] [data-component-part=callout-content],.dark .callout[data-callout-type=note] [data-component-part=callout-icon]{color:#dfecf7!important}.dark .callout[data-callout-type=check],.dark .callout[data-callout-type=tip]{background-color:rgb(35 142 59/.18)!important;border-color:rgb(35 142 59/.45)!important}.dark .callout[data-callout-type=check] [data-component-part=callout-content],.dark .callout[data-callout-type=check] [data-component-part=callout-icon],.dark .callout[data-callout-type=tip] [data-component-part=callout-content],.dark .callout[data-callout-type=tip] [data-component-part=callout-icon]{color:#daf0df!important}.dark .callout[data-callout-type=danger]{background-color:rgb(212 76 59/.18)!important;border-color:rgb(212 76 59/.45)!important}.dark .callout[data-callout-type=danger] [data-component-part=callout-content],.dark .callout[data-callout-type=danger] [data-component-part=callout-icon]{color:#ffe1de!important}.dark .callout[data-callout-type=warning]{background-color:rgb(214 106 30/.18)!important;border-color:rgb(214 106 30/.45)!important}.dark .callout[data-callout-type=warning] [data-component-part=callout-content],.dark .callout[data-callout-type=warning] [data-component-part=callout-icon]{color:#fcedb8!important}.callout [data-component-part=callout-icon] svg{color:inherit!important}#content a.cta-button{display:inline-flex;align-items:center;gap:.5rem;padding:.75rem 1.5rem;border-radius:9999px;background-color:#41a854;color:#fff!important;font-weight:600;font-size:1rem;line-height:1.25;text-decoration:none!important;transition:background-color .15s ease,transform .15s ease}#content a.cta-button::after{content:\"↗\";font-size:1.05em;line-height:1}#content a.cta-button:hover{background-color:#2f8b41;transform:translateY(-1px)}.dark #content a.cta-button{background-color:#6cff93;color:#0a0a0a!important}.dark #content a.cta-button:hover{background-color:#8cffab}html[lang=ar] #content a.cta-button::after{content:\"↖\"}[id^=body-] [data-component-part=field-meta-post]{background-color:#fcedb8!important;color:#d66a1e!important}.dark [id^=body-] [data-component-part=field-meta-post]{background-color:rgba(252,237,184,.12)!important;color:#fcedb8!important}"},{"filePath":"swagger/swagger-ui.css","href":"/_mintlify/custom/tabby-5f40add6/7e77e8f2d6246341/swagger/swagger-ui.css"}],"page":{"pagePath":"api-reference/disputes/approve-disputes","slug":"/api-reference/disputes/approve-disputes","pageMetadata":{"openapi":"post /api/v1/disputes/approve","title":"Approve disputes","description":"Approve disputes (refund money to the customer). Only 20 disputes can be approved within a single request.","href":"/api-reference/disputes/approve-disputes"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Approve disputes (refund money to the customer). Only 20 disputes can be approved within a single request.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"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":{"codeStyling":"dark","config":{},"pageMetadata":{"openapi":"post /api/v1/disputes/approve","title":"Approve disputes","description":"Approve disputes (refund money to the customer). Only 20 disputes can be approved within a single request.","href":"/api-reference/disputes/approve-disputes"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/tabby-5f40add6/9f2b5ecdf0f199ba/eslint.config.js","/_mintlify/custom/tabby-5f40add6/b8a8460aa1a4fa11/swagger/swagger-ui-bundle.js","/_mintlify/custom/tabby-5f40add6/19a31c3b1620a182/swagger/swagger-ui-standalone-preset.js","/_mintlify/custom/tabby-5f40add6/316fd6bc989c58f1/swagger/swagger-ui.js","/_mintlify/custom/tabby-5f40add6/b26a86079cee90e6/next.config.js"],"openApiReferenceData":{"operation":{"tags":["Disputes"],"summary":"Approve disputes","description":"Approve disputes (refund money to the customer). Only 20 disputes can be approved within a single request.","operationId":"postDisputesApprove","security":["82d16eb4-f2b0-4357-b657-fd242448543d"],"requestBody":"bc7fdde6-512d-4f08-9dae-cb49f33a9fc0","responses":{"200":"107b0293-3ba0-4bac-8297-8c2cb33ad3bf","400":"879885ec-dda0-43b3-885b-1ce919d77729","401":"324e2292-0fd7-43a2-829e-e3b8419b9d57","404":"210d5118-8ba9-4664-b88b-27ed8f551b68","500":"b91a5f27-612d-45d1-a552-3591b84859a3"},"method":"post","type":"path","servers":["35ab46d6-a8c8-48ff-838d-a5ce415aefb3","7e6a38e2-efc3-4f4e-8a4b-34581d062f60"],"path":"/api/v1/disputes/approve","baseUrlOptions":["https://api.tabby.ai/","https://api.tabby.sa/"],"title":"Approve disputes","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","php","go","java","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.dispute_ids.items.0":"dispute id, uuid format"}]},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dispute_ids":{"type":"array","items":{"type":"string","format":"uuid","example":"dispute id, uuid format","uniqueKey":"dispute_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"description":"Array of dispute ids. Only 20 disputes can be approved within a single request.","isRequired":true,"uniqueKey":"dispute_ids","typeLabel":"string\u003cuuid>[]"}},"required":["dispute_ids"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"dispute_ids":["dispute id, uuid format"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"107b0293-3ba0-4bac-8297-8c2cb33ad3bf":{"description":"Success. Disputes were approved.","content":{"application/json":{"schema":{"type":"object","properties":{"disputes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"dispute id, uuid format","readOnly":true,"description":"ID of the dispute.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"attachments":{"oneOf":[{"type":"array","items":{"type":"string","example":"attachment_1","uniqueKey":"disputes.items.[INDEX].attachments.oneOf.0.items.[INDEX]","typeLabel":"string"},"readOnly":true,"description":"Array of links to images which were uploaded by customer.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].attachments.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","example":"attachment_1"},"readOnly":true,"description":"Array of links to images which were uploaded by customer.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].attachments.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"disputes.items.[INDEX].attachments","typeLabel":"string[] | null"},"payment_id":{"type":"string","format":"uuid","example":"payment id, uuid format","readOnly":true,"description":"ID of the payment.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].payment_id","typeLabel":"string\u003cuuid>"},"amount":{"type":"string","example":"100.00","description":"Total disputed amount.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].amount","typeLabel":"string"},"currency":{"type":"string","enum":["AED","SAR"],"example":"AED","description":"The currency of the dispute. It's always equal to the currency of the payment.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].currency","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","readOnly":true,"example":"2018-10-17T00:00:00.000Z","description":"Date and time the Dispute was created, in UTC, and displayed in ISO 8601 datetime format.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].created_at","typeLabel":"string"},"expired_at":{"type":"string","readOnly":true,"example":"2018-10-17T00:00:00.000Z","description":"Date and time of the expiration of the Dispute, in UTC, and displayed in ISO 8601 datetime format.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].expired_at","typeLabel":"string"},"status":{"type":"string","readOnly":true,"enum":["new","declined","cancelled","refunded","in_progress","evidence_merchant","evidence_customer"],"example":"new","description":"The current status of the dispute:\n - `new` - dispute pending merchant approval for refund or initiate a challenge\n - `declined` - dispute was declined by Tabby support\n - `cancelled` - dispute was canceled by customer\n - `refunded` - dispute was approved or the order was refunded via Payments API\n - `in_progress` - merchant challenged dispute and need a response from Tabby support\n - `evidence_merchant` - waiting for evidence from the merchant\n - `evidence_customer` - waiting for evidence from the customer\n","isRequired":true,"uniqueKey":"disputes.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"reason":{"type":"string","readOnly":true,"enum":["unreceived_refund","identity_theft","product_issue","not_delivered"],"example":"unreceived_refund","description":"Cause of the dispute was created (selected by customer). There are only four reasons:\n - `unreceived_refund` - a refund not received\n - `identity_theft` - I did not place this order (also known as identity theft)\n - `product_issue` - there was a problem with the product\n - `not_delivered` - the order was not delivered\n","isRequired":true,"uniqueKey":"disputes.items.[INDEX].reason","typeLabel":"enum\u003cstring>"},"days_left":{"type":"integer","format":"uint16","description":"How many days left before dispute will be automatically approved.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].days_left","typeLabel":"integer\u003cuint16>"},"items":{"type":"array","items":{"type":"object","properties":{"reference_id":{"type":"string","example":"payment id","description":"Reference id from payment.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].\\items.items.[INDEX].reference_id","typeLabel":"string"},"title":{"type":"string","example":"Order item title","description":"Order item title.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].\\items.items.[INDEX].title","typeLabel":"string"},"unit_price":{"type":"string","example":"100.00","description":"Order item unit price.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].\\items.items.[INDEX].unit_price","typeLabel":"string"}},"required":["reference_id","title","unit_price"],"uniqueKey":"disputes.items.[INDEX].\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"disputes.items.[INDEX].\\items","typeLabel":"object[]"},"order_number":{"type":"string","example":"#1234","description":"Merchant-assigned order number.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].order_number","typeLabel":"string"},"comment":{"type":"string","example":"additional comments","description":"The customer additional comments on the causes of the dispute.","isRequired":true,"uniqueKey":"disputes.items.[INDEX].comment","typeLabel":"string"}},"required":["id","attachments","payment_id","amount","currency","created_at","expired_at","status","reason","days_left","items","order_number","comment"],"uniqueKey":"disputes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"disputes","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"disputes":[{"id":"dispute id, uuid format","attachments":["attachment_1"],"payment_id":"payment id, uuid format","amount":"100.00","currency":"AED","created_at":"2018-10-17T00:00:00.000Z","expired_at":"2018-10-17T00:00:00.000Z","status":"new","reason":"unreceived_refund","days_left":123,"items":[{"reference_id":"payment id","title":"Order item title","unit_price":"100.00"}],"order_number":"#1234","comment":"additional comments"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"879885ec-dda0-43b3-885b-1ce919d77729":{"description":"One of the required fields is missing or request is not formatted correctly.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"error","uniqueKey":"status","typeLabel":"string"},"errorType":{"type":"string","example":"bad_data","uniqueKey":"errorType","typeLabel":"string"},"error":{"type":"string","example":"bad_request","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","errorType":"bad_data","error":"bad_request"}}},"exampleType":"generated"}},"exampleType":"generated"},"324e2292-0fd7-43a2-829e-e3b8419b9d57":{"description":"The request cannot be authorized.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"error","uniqueKey":"status","typeLabel":"string"},"errorType":{"type":"string","example":"not_authorized","uniqueKey":"errorType","typeLabel":"string"},"error":{"type":"string","example":"invalid secret key","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","errorType":"not_authorized","error":"invalid secret key"}}},"exampleType":"generated"}},"exampleType":"generated"},"210d5118-8ba9-4664-b88b-27ed8f551b68":{"description":"You are using an incorrect ID.","content":{"application/json":{"schema":{"type":"string","example":"404 page not found","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"404 page not found"}},"exampleType":"generated"}},"exampleType":"generated"},"b91a5f27-612d-45d1-a552-3591b84859a3":{"description":"Something bad happened. We're notified.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"error","uniqueKey":"status","typeLabel":"string"},"errorType":{"type":"string","example":"internal","uniqueKey":"errorType","typeLabel":"string"},"error":{"type":"string","example":"Internal Server Error","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","errorType":"internal","error":"Internal Server Error"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"82d16eb4-f2b0-4357-b657-fd242448543d":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003csecret_key>`, where `\u003csecret_key>` is your `secret_key`.\n","scopes":["secret_key"]}}},"servers":{"35ab46d6-a8c8-48ff-838d-a5ce415aefb3":{"url":"https://api.tabby.ai/","description":"Production (UAE)"},"7e6a38e2-efc3-4f4e-8a4b-34581d062f60":{"url":"https://api.tabby.sa/","description":"Production (KSA)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003csecret_key>`, where `\u003csecret_key>` is your `secret_key`.\n","scopes":["secret_key"]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003csecret_key>`, where `\u003csecret_key>` is your `secret_key`.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"tabby-5f40add6","siteName":"Tabby","title":"Approve disputes - Tabby","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/disputes/approve-disputes","matchLevel":0},"ar":{"href":"/ar/marketing/toolkit","matchLevel":4}}},"lastModified":"2026-01-27T19:03:15.060Z","originalFileLocation":"api-reference/disputes/approve-disputes.mdx","locale":"en"},"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=\"light\"}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=\"description\" content=\"Approve disputes (refund money to the customer). Only 20 disputes can be approved within a single request.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tabby\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tabby-5f40add6/Lsj-1o9eEOnU_rir/_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=\"/mintlify-assets/_mintlify/favicons/tabby-5f40add6/Lsj-1o9eEOnU_rir/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tabby-5f40add6/Lsj-1o9eEOnU_rir/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tabby-5f40add6/Lsj-1o9eEOnU_rir/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tabby-5f40add6/Lsj-1o9eEOnU_rir/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tabby-5f40add6/Lsj-1o9eEOnU_rir/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tabby-5f40add6/Lsj-1o9eEOnU_rir/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tabby-5f40add6/Lsj-1o9eEOnU_rir/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tabby-5f40add6/Lsj-1o9eEOnU_rir/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Approve disputes - Tabby\">\u003cmeta data-mint-head property=\"og:description\" content=\"Approve disputes (refund money to the customer). Only 20 disputes can be approved within a single request.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tabby\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tabby.ai/api-reference/disputes/approve-disputes\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tabby-5f40add6.mintlify.app/_mintlify/api/og/v2?division=Disputes\u0026amp;title=Approve+disputes\u0026amp;description=Approve+disputes+%28refund+money+to+the+customer%29.+Only+20+disputes+can+be+approved+within+a+single+request.\u0026amp;theme=a18093f88c8f4a84a1db7bcf\u0026amp;signature=39ebc242fd99434ec12ed7e2c6f07602dc64c5202b6df27b620aa777a55229ef\">\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=\"Approve disputes - Tabby\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Approve disputes (refund money to the customer). Only 20 disputes can be approved within a single request.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tabby-5f40add6.mintlify.app/_mintlify/api/og/v2?division=Disputes\u0026amp;title=Approve+disputes\u0026amp;description=Approve+disputes+%28refund+money+to+the+customer%29.+Only+20+disputes+can+be+approved+within+a+single+request.\u0026amp;theme=a18093f88c8f4a84a1db7bcf\u0026amp;signature=39ebc242fd99434ec12ed7e2c6f07602dc64c5202b6df27b620aa777a55229ef\">\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=\"/mintlify-assets/_mintlify/favicons/tabby-5f40add6/Lsj-1o9eEOnU_rir/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tabby\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#41A854\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tabby.ai/api-reference/disputes/approve-disputes\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/disputes/approve-disputes.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tabby.ai/#organization\",\"name\":\"Tabby\",\"url\":\"https://docs.tabby.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tabby-5f40add6/1f-EIKwKexPNgWGm/logo/tabby-badge.svg?fit=max\u0026auto=format\u0026n=1f-EIKwKexPNgWGm\u0026q=85\u0026s=f9bf7cbe04bdae76df344b4746a6b12d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tabby.ai#website\",\"name\":\"Tabby\",\"url\":\"https://docs.tabby.ai\",\"publisher\":{\"@id\":\"https://docs.tabby.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tabby.ai/api-reference/disputes/approve-disputes#webpage\",\"url\":\"https://docs.tabby.ai/api-reference/disputes/approve-disputes\",\"name\":\"Approve disputes\",\"description\":\"Approve disputes (refund money to the customer). Only 20 disputes can be approved within a single request.\",\"dateModified\":\"2026-01-27T19:03:15.060Z\",\"isPartOf\":{\"@id\":\"https://docs.tabby.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tabby.ai/api-reference/disputes/approve-disputes#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tabby.ai/api-reference/disputes/approve-disputes#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Disputes\",\"item\":\"https://docs.tabby.ai/api-reference/disputes/get-disputes-list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Approve disputes\",\"item\":\"https://docs.tabby.ai/api-reference/disputes/approve-disputes\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tabby.ai/api-reference/disputes/approve-disputes#apireference\",\"headline\":\"Approve disputes\",\"name\":\"Approve disputes\",\"description\":\"Approve disputes (refund money to the customer). Only 20 disputes can be approved within a single request.\",\"url\":\"https://docs.tabby.ai/api-reference/disputes/approve-disputes\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tabby.ai/api-reference/disputes/approve-disputes#webpage\"},\"dateModified\":\"2026-01-27T19:03:15.060Z\",\"publisher\":{\"@id\":\"https://docs.tabby.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tabby.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tabby\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Tabby","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction/what-is-tabby"}]},{"tab":"API Playground","groups":[{"group":"API Playground","pages":[{"title":"API Reference Documentation","href":"/api-reference/overview"},{"title":"API Error Codes","sidebarTitle":"Error codes","href":"/api-reference/response-codes"}]},{"group":"Checkout","pages":[{"openapi":"post /api/v2/checkout","title":"Create a session","href":"/api-reference/checkout/create-a-session"},{"title":"Session creation payload model","href":"/api-reference/checkout/session-payload-model"}]},{"group":"Payments","pages":[{"openapi":"get /api/v2/payments/{id}","title":"Retrieve a payment","href":"/api-reference/payments/retrieve-a-payment"},{"openapi":"put /api/v2/payments/{id}","title":"Update a payment","href":"/api-reference/payments/update-a-payment"},{"openapi":"post /api/v2/payments/{id}/captures","title":"Capture a payment","href":"/api-reference/payments/capture-a-payment"},{"openapi":"post /api/v2/payments/{id}/refunds","title":"Refund a payment","href":"/api-reference/payments/refund-a-payment"},{"openapi":"post /api/v2/payments/{id}/close","title":"Close a payment","href":"/api-reference/payments/close-a-payment"},{"openapi":"get /api/v2/payments","title":"List of all payments","href":"/api-reference/payments/list-of-all-payments"}]},{"group":"Webhooks","pages":[{"openapi":"post /api/v1/webhooks","title":"Register a webhook","href":"/api-reference/webhooks/register-a-webhook"},{"openapi":"get /api/v1/webhooks","title":"Retrieve all webhooks","href":"/api-reference/webhooks/retrieve-all-webhooks"},{"openapi":"get /api/v1/webhooks/{id}","title":"Retrieve a webhook","href":"/api-reference/webhooks/retrieve-a-webhook"},{"openapi":"put /api/v1/webhooks/{id}","title":"Update a webhook","href":"/api-reference/webhooks/update-a-webhook"},{"openapi":"delete /api/v1/webhooks/{id}","title":"Remove a webhook","href":"/api-reference/webhooks/remove-a-webhook"}]},{"group":"Dispute Webhooks","pages":[{"openapi":"post /api/v1/dispute-webhooks","title":"Register a dispute webhook","href":"/api-reference/dispute-webhooks/register-a-dispute-webhook"},{"openapi":"get /api/v1/dispute-webhooks","title":"Retrieve all dispute webhooks","href":"/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks"},{"openapi":"get /api/v1/dispute-webhooks/{id}","title":"Retrieve a dispute webhook","href":"/api-reference/dispute-webhooks/retrieve-a-dispute-webhook"},{"openapi":"put /api/v1/dispute-webhooks/{id}","title":"Update a dispute webhook","href":"/api-reference/dispute-webhooks/update-a-dispute-webhook"},{"openapi":"delete /api/v1/dispute-webhooks/{id}","title":"Remove a dispute webhook","href":"/api-reference/dispute-webhooks/remove-a-dispute-webhook"}]},{"group":"Disputes","pages":[{"openapi":"get /api/v1/disputes","title":"Get disputes list","href":"/api-reference/disputes/get-disputes-list"},{"openapi":"get /api/v1/disputes/{disputeId}","title":"Get dispute by id","href":"/api-reference/disputes/get-dispute-by-id"},{"openapi":"post /api/v1/disputes/{disputeId}/provide-evidence","title":"Provide evidence for a dispute","description":"Provide evidence (text and/or attachments) for a dispute. Used by the merchant to submit proof in response to an evidence request.","href":"/api-reference/disputes/provide-evidence"},{"openapi":"post /api/v1/disputes/approve","title":"Approve disputes","href":"/api-reference/disputes/approve-disputes"},{"openapi":"post /api/v1/disputes/challenge","title":"Challenge disputes","description":"Challenge disputes (request Tabby support to take a look at the case). Only 20 disputes can be challenged within a single request. Only disputes with status 'new' might be challenged.","href":"/api-reference/disputes/challenge-disputes"},{"openapi":"post /api/v1/disputes/attachments/upload","title":"Upload attachment","href":"/api-reference/disputes/upload-attachment"}]}]},{"tab":"Marketing Toolkit","pages":[{"title":"Marketing Toolkit","href":"/marketing/toolkit"}]}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/marketing/toolkit"}]}]},"title":"Approve disputes - Tabby","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}