The Refund API allows the merchant to reverse a transaction, sending the funds back to the customer’s payment method.
This API is typically used in scenarios such as order cancellations, product returns, or when a customer disputes a charge.
Refunds can be partial or full, depending on the amount specified in the refund request. If a partial amount is refunded, the remaining balance of the original transaction is still valid.
A JSON object containing details of the transaction.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DAS Gateway Documentation","description":"DAS Gateway Documentation – Payment Options","colors":{"primary":"#FFAB31","light":"#FFAB31","dark":"#F18A00"},"logo":{"light":"https://mintcdn.com/dasdoc/kfo25CLU3J6KbVVp/logo/logo_light.svg?fit=max\u0026auto=format\u0026n=kfo25CLU3J6KbVVp\u0026q=85\u0026s=1f64203e269639be1755143448350fbb","dark":"https://mintcdn.com/dasdoc/kfo25CLU3J6KbVVp/logo/logo_dark.svg?fit=max\u0026auto=format\u0026n=kfo25CLU3J6KbVVp\u0026q=85\u0026s=6fbde73fd21acab73c5c855d6ba4b797"},"favicon":"https://mintcdn.com/dasdoc/NIfdTDr2rgRx_fiM/favicon.svg?fit=max\u0026auto=format\u0026n=NIfdTDr2rgRx_fiM\u0026q=85\u0026s=f60dbe0773d392063369684cd1f7d184","appearance":{"default":"light","strict":true},"navbar":{"links":[{"href":"https://me.paymentoptions.com/onboarding/choose-account","label":"Create an Account"}],"primary":{"type":"button","label":"Sign in","href":"https://me.paymentoptions.com"}},"footer":{"socials":{"website":"https://www.paymentoptions.com","linkedin":"https://www.linkedin.com/company/payment-options"}},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"documentation/overview"},{"language":"jp","href":"jp/documentation/overview"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dasdoc","hasAudioNarration":false,"actualSubdomain":"dasdoc","customDomains":["docs.paymentoptions.com"],"gitSource":{"type":"github","owner":"paymentoptions","repo":"das-docs-v2","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae442b7f81dcd442ea46734","collectionId":"f7b3e2ad-76a3-4607-97bd-02202c8dc7f1","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae442b7f81dcd442ea46734"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae442b7f81dcd442ea46734","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"en","tag":"API Reference","count":29},{"language":"jp","tag":"APIリファレンス","count":29},{"language":"en","tag":"API Endpoints","count":21},{"language":"en","tag":"Documentation","count":21},{"language":"jp","tag":"APIエンドポイント","count":21},{"language":"jp","tag":"ドキュメント","count":21},{"language":"en","tag":"Server To Server","count":9},{"language":"en","tag":"Support","count":9},{"language":"jp","tag":"サーバー間通信","count":9},{"language":"jp","tag":"サポート","count":9},{"language":"en","tag":"Payment Methods","count":7},{"language":"jp","tag":"決済方法","count":7},{"language":"en","tag":"Subscriptions","count":6},{"language":"en","tag":"Payments","count":6},{"language":"jp","tag":"サブスクリプション","count":6},{"language":"jp","tag":"決済","count":6},{"language":"en","tag":"Get Started","count":4},{"language":"jp","tag":"スタートガイド","count":4},{"language":"en","tag":"Getting Started","count":3},{"language":"jp","tag":"入門","count":3}]},"assistantConfig":{},"basePath":"","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},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/en/server-to-server/refund","slug":"/api-reference/en/server-to-server/refund","pageMetadata":{"title":"Refund API","openapi":"api-reference/en/open-api-config/server-to-server/refund.json POST /api/v1/server-to-server-interface/refund","description":"The Refund API is used to return funds to the customer after a successful purchase or capture transaction.","href":"/api-reference/en/server-to-server/refund"},"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: \"The Refund API is used to return funds to the customer after a successful purchase or capture transaction.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Info,OptimizedImage,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:`Note: Refunds are not supported for the following payment methods: PayPay, Pay-Easy, and Konbini.`}),`\n`,_jsx(Heading,{level:`3`,id:`key-points`,children:`Key Points`}),`\n`,_jsx(Info,{children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`The Refund API allows the merchant to reverse a transaction, sending the funds back to the customer’s payment method.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`This API is typically used in scenarios such as order cancellations, product returns, or when a customer disputes a charge.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Refunds can be partial or full, depending on the amount specified in the refund request. If a partial amount is refunded, the remaining balance of the original transaction is still valid.`}),`\n`]}),`\n`]})}),`\n`,_jsx(Heading,{level:`2`,id:`flow-diagram`,children:`Flow diagram`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/dasdoc/kfo25CLU3J6KbVVp/images/timeline-diagram/flows-API-refund.svg?fit=max\u0026auto=format\u0026n=kfo25CLU3J6KbVVp\u0026q=85\u0026s=72426062fc5200bb88aec9f200e21824`,alt:`Flow diagram image`,\"data-og-width\":`1997`,width:`1997`,\"data-og-height\":`868`,height:`868`,\"data-path\":`images/timeline-diagram/flows-API-refund.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/dasdoc/kfo25CLU3J6KbVVp/images/timeline-diagram/flows-API-refund.svg?w=280\u0026fit=max\u0026auto=format\u0026n=kfo25CLU3J6KbVVp\u0026q=85\u0026s=bfba0721450c91fcda414c485a8cc094 280w, https://mintcdn.com/dasdoc/kfo25CLU3J6KbVVp/images/timeline-diagram/flows-API-refund.svg?w=560\u0026fit=max\u0026auto=format\u0026n=kfo25CLU3J6KbVVp\u0026q=85\u0026s=01e82e6fa5e85c7997c4695930030fe7 560w, https://mintcdn.com/dasdoc/kfo25CLU3J6KbVVp/images/timeline-diagram/flows-API-refund.svg?w=840\u0026fit=max\u0026auto=format\u0026n=kfo25CLU3J6KbVVp\u0026q=85\u0026s=fd44aaa0dcfeeff0918253727a5aef8c 840w, https://mintcdn.com/dasdoc/kfo25CLU3J6KbVVp/images/timeline-diagram/flows-API-refund.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=kfo25CLU3J6KbVVp\u0026q=85\u0026s=c50b60aba584ae3e1544bff39ad38aaa 1100w, https://mintcdn.com/dasdoc/kfo25CLU3J6KbVVp/images/timeline-diagram/flows-API-refund.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=kfo25CLU3J6KbVVp\u0026q=85\u0026s=d03cd110d4837390e0ee59fd82eb8db5 1650w, https://mintcdn.com/dasdoc/kfo25CLU3J6KbVVp/images/timeline-diagram/flows-API-refund.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=kfo25CLU3J6KbVVp\u0026q=85\u0026s=49c07008910975c948d3647d451fee5e 2500w`}),`\n`,_jsx(Heading,{level:`2`,id:`api-parameters`,children:`Api Parameters`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Refund API","openapi":"api-reference/en/open-api-config/server-to-server/refund.json POST /api/v1/server-to-server-interface/refund","description":"The Refund API is used to return funds to the customer after a successful purchase or capture transaction.","href":"/api-reference/en/server-to-server/refund"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Key Points","slug":"key-points","depth":3,"children":[]},{"title":"Flow diagram","slug":"flow-diagram","depth":2,"children":[]},{"title":"Api Parameters","slug":"api-parameters","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Refund a Transaction","description":"The Refund API is used to return funds to the customer after a successful purchase or capture transaction.","operationId":"refundTransaction","requestBody":"8844d090-1770-4a21-add3-d8956728b782","responses":{"201":"d6b3c8fd-eedc-49ac-b1e2-dae07042d72c"},"method":"post","type":"path","servers":["f8ed5131-22c3-4ced-8685-758d2aed3417"],"security":["089ff7f3-cce5-4999-8288-0caf4d706cc3"],"path":"/api/v1/server-to-server-interface/refund","baseUrlOptions":["https://api-dev.paymentoptions.com"],"title":"Refund a Transaction","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"The request payload to refund a transaction.","required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"transactionId":{"type":"string","description":"The original transaction ID of the authorized transaction.","example":"9dfd39ec-eb4a-4f8b-a526-17abf140a717","maxLength":36,"isRequired":true,"uniqueKey":"transactionId","typeLabel":"string"},"amount":{"type":"integer","description":"The amount to be refunded. This should not exceed the amount captured or purchased. Amount limit depends on the bank.","example":1000,"isRequired":true,"uniqueKey":"amount","typeLabel":"integer"},"merchant_id":{"type":"string","description":"The merchant ID (DASMID).","example":"\u003c Merchant ID >","maxLength":10,"isRequired":true,"uniqueKey":"merchant_id","typeLabel":"string"},"notes":{"type":"string","description":"The reference of the refund transaction (optional).","example":"Refund amount captured/purchased","maxLength":128,"uniqueKey":"notes","typeLabel":"string"}},"required":["transactionId","amount","merchant_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"transactionId":"9dfd39ec-eb4a-4f8b-a526-17abf140a717","amount":1000,"merchant_id":"\u003c Merchant ID >","notes":"Refund amount captured/purchased"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d6b3c8fd-eedc-49ac-b1e2-dae07042d72c":{"description":"Transaction refunded successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"True on successful transaction, false on failure.","example":true,"uniqueKey":"success","typeLabel":"boolean"},"status_code":{"type":"integer","description":"The status code of the transaction.","example":201,"uniqueKey":"status_code","typeLabel":"integer"},"is_live":{"type":"boolean","description":"True if live transaction, false if test transaction.","example":false,"uniqueKey":"is_live","typeLabel":"boolean"},"transaction_type":{"type":"string","description":"The transaction type (e.g., REFUND).","example":"REFUND","uniqueKey":"transaction_type","typeLabel":"string"},"gateway_response":{"type":"object","description":"A JSON object containing the response from the gateway.","properties":{"version":{"type":"string","description":"The version of the gateway.","example":"1","uniqueKey":"gateway_response.version","typeLabel":"string"},"type":{"type":"string","description":"Type of response (e.g., INFO).","example":"INFO","uniqueKey":"gateway_response.type","typeLabel":"string"},"message":{"type":"string","description":"The message response from the gateway.","example":"Amount successfully refunded.","uniqueKey":"gateway_response.message","typeLabel":"string"},"code":{"type":"string","description":"Message code of the response.","example":"INFO0002","uniqueKey":"gateway_response.code","typeLabel":"string"}},"uniqueKey":"gateway_response","typeLabel":"object"},"merchant_details":{"type":"object","description":"A JSON object containing the details of the merchant.","properties":{"legal_name":{"type":"string","description":"The merchant’s legal name.","example":"Tink15 Factory","uniqueKey":"merchant_details.legal_name","typeLabel":"string"},"mid":{"type":"string","description":"The merchant ID (DASMID).","example":"\u003c Merchant ID >","uniqueKey":"merchant_details.mid","typeLabel":"string"},"merchant_txn_ref":{"type":"string","description":"The merchant transaction reference.","example":"qwe","uniqueKey":"merchant_details.merchant_txn_ref","typeLabel":"string"}},"uniqueKey":"merchant_details","typeLabel":"object"},"payment_details":{"type":"object","description":"A JSON object containing the payment details of the transaction.","properties":{"amount":{"type":"number","description":"The amount value of the transaction.","example":1000,"uniqueKey":"payment_details.amount","typeLabel":"number"},"response_code":{"type":"integer","description":"The acquirer response code.","example":0,"uniqueKey":"payment_details.response_code","typeLabel":"integer"},"auth_code":{"type":"string","description":"The acquirer authorization code.","example":"264302","uniqueKey":"payment_details.auth_code","typeLabel":"string"},"currency":{"type":"string","description":"The currency of the transaction.","example":"JPY","uniqueKey":"payment_details.currency","typeLabel":"string"},"payment_method":{"type":"string","description":"The payment card type (e.g., Credit Card or Debit Card).","example":"ECMC-SSL","uniqueKey":"payment_details.payment_method","typeLabel":"string"},"scheme":{"type":"string","description":"The card brand scheme (e.g., MASTERCARD).","example":"MASTERCARD","uniqueKey":"payment_details.scheme","typeLabel":"string"},"card":{"type":"object","description":"A JSON object containing details of the card.","properties":{"name":{"type":"string","description":"The cardholder’s name on the card.","example":"John Doe","uniqueKey":"payment_details.card.name","typeLabel":"string"},"number":{"type":"string","description":"The card number (masked).","example":"5200000000001005","uniqueKey":"payment_details.card.number","typeLabel":"string"},"exp_month":{"type":"string","description":"The expiry month of the card.","example":"12","uniqueKey":"payment_details.card.exp_month","typeLabel":"string"},"exp_year":{"type":"string","description":"The expiry year of the card.","example":"29","uniqueKey":"payment_details.card.exp_year","typeLabel":"string"}},"uniqueKey":"payment_details.card","typeLabel":"object"},"additional_data":{"type":"object","description":"A JSON object containing additional data.","properties":{"payment_data_source":{"type":"object","description":"A JSON object containing payment data source.","properties":{"type":{"type":"string","description":"The type of payment data source (e.g., Card, GooglePay, ApplePay).","example":"card","uniqueKey":"payment_details.additional_data.payment_data_source.type","typeLabel":"string"}},"uniqueKey":"payment_details.additional_data.payment_data_source","typeLabel":"object"}},"uniqueKey":"payment_details.additional_data","typeLabel":"object"}},"uniqueKey":"payment_details","typeLabel":"object"},"transaction_details":{"type":"object","description":"A JSON object containing details of the transaction.","properties":{"id":{"type":"string","description":"The transaction ID of the transaction.","example":"626fa81d-9819-4947-bb9b-b0f11e00a50e","uniqueKey":"transaction_details.id","typeLabel":"string"},"ref":{"type":"integer","description":"The authorization code of the transaction.","example":74824,"uniqueKey":"transaction_details.ref","typeLabel":"integer"},"timestamp":{"type":"string","description":"Date and time of the transaction.","example":"2024-11-25T08:51:52.000Z","uniqueKey":"transaction_details.timestamp","typeLabel":"string"},"merchant_txn_ref":{"type":"string","description":"The merchant transaction reference ID.","example":"qwe","uniqueKey":"transaction_details.merchant_txn_ref","typeLabel":"string"}},"uniqueKey":"transaction_details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"status_code":201,"is_live":false,"transaction_type":"REFUND","gateway_response":{"version":"1","type":"INFO","message":"Amount successfully refunded.","code":"INFO0002"},"merchant_details":{"legal_name":"Tink15 Factory","mid":"\u003c Merchant ID >","merchant_txn_ref":"qwe"},"payment_details":{"amount":1000,"response_code":0,"auth_code":"264302","currency":"JPY","payment_method":"ECMC-SSL","scheme":"MASTERCARD","card":{"name":"John Doe","number":"5200000000001005","exp_month":"12","exp_year":"29"},"additional_data":{"payment_data_source":{"type":"card"}}},"transaction_details":{"id":"626fa81d-9819-4947-bb9b-b0f11e00a50e","ref":74824,"timestamp":"2024-11-25T08:51:52.000Z","merchant_txn_ref":"qwe"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"089ff7f3-cce5-4999-8288-0caf4d706cc3":{"apiKeyAuth":{"type":"apiKey","name":"Authorization","in":"header","description":"API Key for Authorization. Format: 'Basic YOUR_API_KEY_HERE'","scopes":[]},"xApiKeyAuth":{"type":"apiKey","name":"x-api-key","in":"header","description":"API Key specific to x-api-key.","scopes":[]}}},"servers":{"f8ed5131-22c3-4ced-8685-758d2aed3417":{"url":"https://api-dev.paymentoptions.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","name":"Authorization","in":"header","description":"API Key for Authorization. Format: 'Basic YOUR_API_KEY_HERE'","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"API Key for Authorization. Format: 'Basic YOUR_API_KEY_HERE'","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"Authorization"},{"scheme":{"type":"apiKey","name":"x-api-key","in":"header","description":"API Key specific to x-api-key.","scopes":[]},"schema":{"title":"x-api-key","type":"string","description":"API Key specific to x-api-key.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"xApiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth \u0026 xApiKeyAuth"}]},"originalFileLocation":"api-reference/en/open-api-config/server-to-server/refund.json"},"subdomain":"dasdoc","siteName":"DAS Gateway Documentation","title":"Refund API - DAS Gateway Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/en/server-to-server/refund","matchLevel":0},"jp":{"href":"/api-reference/jp/server-to-server/refund","matchLevel":1}}},"lastModified":"2026-03-20T06:00:56.734Z","originalFileLocation":"api-reference/en/server-to-server/refund.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"The Refund API is used to return funds to the customer after a successful purchase or capture transaction.\">\u003cmeta data-mint-head name=\"application-name\" content=\"DAS Gateway Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dasdoc/hSwsXoA5BQlwi3mM/_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/dasdoc/hSwsXoA5BQlwi3mM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dasdoc/hSwsXoA5BQlwi3mM/_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/dasdoc/hSwsXoA5BQlwi3mM/_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/dasdoc/hSwsXoA5BQlwi3mM/_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/dasdoc/hSwsXoA5BQlwi3mM/_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/dasdoc/hSwsXoA5BQlwi3mM/_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/dasdoc/hSwsXoA5BQlwi3mM/_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/dasdoc/hSwsXoA5BQlwi3mM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Refund API - DAS Gateway Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"The Refund API is used to return funds to the customer after a successful purchase or capture transaction.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DAS Gateway Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.paymentoptions.com/api-reference/en/server-to-server/refund\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dasdoc.mintlify.app/_mintlify/api/og/v2?division=Server+To+Server\u0026amp;title=Refund+API\u0026amp;description=The+Refund+API+is+used+to+return+funds+to+the+customer+after+a+successful+purchase+or+capture+transaction.\u0026amp;theme=bf7f232f7392ec92b8c12904\u0026amp;signature=735e52b26b847449a6225db48320aad657e143a796a77da7e46ec6058f926ecf\">\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=\"Refund API - DAS Gateway Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The Refund API is used to return funds to the customer after a successful purchase or capture transaction.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dasdoc.mintlify.app/_mintlify/api/og/v2?division=Server+To+Server\u0026amp;title=Refund+API\u0026amp;description=The+Refund+API+is+used+to+return+funds+to+the+customer+after+a+successful+purchase+or+capture+transaction.\u0026amp;theme=bf7f232f7392ec92b8c12904\u0026amp;signature=735e52b26b847449a6225db48320aad657e143a796a77da7e46ec6058f926ecf\">\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/dasdoc/hSwsXoA5BQlwi3mM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DAS Gateway Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FFAB31\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.paymentoptions.com/api-reference/en/server-to-server/refund\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/en/server-to-server/refund.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.paymentoptions.com/api-reference/en/server-to-server/refund\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.paymentoptions.com/api-reference/jp/server-to-server/refund\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.paymentoptions.com/api-reference/en/server-to-server/refund\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.paymentoptions.com/#organization\",\"name\":\"DAS Gateway Documentation\",\"url\":\"https://docs.paymentoptions.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dasdoc/kfo25CLU3J6KbVVp/logo/logo_light.svg?fit=max\u0026auto=format\u0026n=kfo25CLU3J6KbVVp\u0026q=85\u0026s=1f64203e269639be1755143448350fbb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.paymentoptions.com#website\",\"name\":\"DAS Gateway Documentation\",\"url\":\"https://docs.paymentoptions.com\",\"publisher\":{\"@id\":\"https://docs.paymentoptions.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.paymentoptions.com/api-reference/en/server-to-server/refund#webpage\",\"url\":\"https://docs.paymentoptions.com/api-reference/en/server-to-server/refund\",\"name\":\"Refund API\",\"description\":\"The Refund API is used to return funds to the customer after a successful purchase or capture transaction.\",\"dateModified\":\"2026-03-20T06:00:56.734Z\",\"isPartOf\":{\"@id\":\"https://docs.paymentoptions.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.paymentoptions.com/api-reference/en/server-to-server/refund#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.paymentoptions.com/api-reference/en/server-to-server/refund#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Endpoints\",\"item\":\"https://docs.paymentoptions.com/api-reference/en/server-to-server/purchase\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Server To Server\",\"item\":\"https://docs.paymentoptions.com/api-reference/en/server-to-server/purchase\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Refund API\",\"item\":\"https://docs.paymentoptions.com/api-reference/en/server-to-server/refund\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.paymentoptions.com/api-reference/en/server-to-server/refund#apireference\",\"headline\":\"Refund API\",\"name\":\"Refund API\",\"description\":\"The Refund API is used to return funds to the customer after a successful purchase or capture transaction.\",\"url\":\"https://docs.paymentoptions.com/api-reference/en/server-to-server/refund\",\"mainEntityOfPage\":{\"@id\":\"https://docs.paymentoptions.com/api-reference/en/server-to-server/refund#webpage\"},\"dateModified\":\"2026-03-20T06:00:56.734Z\",\"publisher\":{\"@id\":\"https://docs.paymentoptions.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.paymentoptions.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DAS Gateway Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"DAS Gateway Documentation","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/documentation/overview"}]},{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/api-reference/en/introduction"},{"title":"Authentication","href":"/api-reference/en/authentication"},{"title":"Merchant Details","href":"/api-reference/en/merchant-details"}]},{"group":"API Endpoints","pages":[{"group":"Server To Server","pages":[{"group":"Purchase","pages":[{"title":"Purchase API (v1)","openapi":"api-reference/en/open-api-config/server-to-server/purchase.json POST /api/v1/server-to-server-interface/payment","href":"/api-reference/en/server-to-server/purchase"},{"title":"Purchase API (v2)","openapi":"api-reference/en/open-api-config/server-to-server/purchasev2.json POST /api/v1/server-to-server-interface/paymentv2","href":"/api-reference/en/server-to-server/purchasev2"},{"title":"3D Secure Integration","openapi":"api-reference/en/open-api-config/server-to-server/purchase.json POST /api/v1/server-to-server-interface/paymentv2","href":"/api-reference/en/server-to-server/3dsecure"}]},{"group":"Authorisation","pages":[{"title":"Authorization API (v1)","openapi":"api-reference/en/open-api-config/server-to-server/authorization.json POST /api/v1/server-to-server-interface/authorization","href":"/api-reference/en/server-to-server/authorization"},{"title":"Authorization API (v2)","openapi":"api-reference/en/open-api-config/server-to-server/authorizationv2.json POST /api/v1/server-to-server-interface/authorizationv2","href":"/api-reference/en/server-to-server/authorizationv2"}]},{"title":"Capture API","openapi":"api-reference/en/open-api-config/server-to-server/capture.json POST /api/v1/server-to-server-interface/capture","description":"The Capture API is used to finalize a payment by transferring the funds that were previously authorised via the Authorsation API.","href":"/api-reference/en/server-to-server/capture"},{"title":"Refund API","openapi":"api-reference/en/open-api-config/server-to-server/refund.json POST /api/v1/server-to-server-interface/refund","href":"/api-reference/en/server-to-server/refund"},{"title":"Void Authorization API","openapi":"api-reference/en/open-api-config/server-to-server/void-authorization.json POST /api/v1/server-to-server-interface/void","description":"The Void Authorization API is used to cancel a previously authorized payment before the funds are captured, releasing the hold on the customer’s account.","href":"/api-reference/en/server-to-server/void-authorization"},{"title":"Transaction Status API","openapi":"api-reference/en/open-api-config/server-to-server/transaction-status.json GET /api/v1/server-to-server-interface/transaction/status/{transactionId}","href":"/api-reference/en/server-to-server/transaction-status"}]},{"group":"Tokenization","pages":[{"title":"Generate Token API","openapi":"api-reference/en/open-api-config/tokenization/generate-token.json POST /api/v1/server-to-server-interface/payment","href":"/api-reference/en/tokenization/generate-token"},{"title":"Use Token API","openapi":"api-reference/en/open-api-config/tokenization/use-token.json POST /api/v1/server-to-server-interface/payment","href":"/api-reference/en/tokenization/use-token"}]},{"group":"Subscriptions","pages":[{"title":"Create Subscription API","openapi":"api-reference/en/open-api-config/subscription/create-subscription.json POST /api/v1/server-to-server-interface/subscription/payment","href":"/api-reference/en/subscription/create-subscription"},{"title":"Cancel Subscription API","openapi":"api-reference/en/open-api-config/subscription/cancel-subscription.json POST /api/v1/server-to-server-interface/subscription/{subscription_id}/cancel","href":"/api-reference/en/subscription/cancel-subscription"},{"title":"Pause Subscription API","openapi":"api-reference/en/open-api-config/subscription/pause-subscription.json POST /api/v1/server-to-server-interface/subscription/{subscription_id}/pause","href":"/api-reference/en/subscription/pause-subscription"},{"title":"Resume Subscription API","openapi":"api-reference/en/open-api-config/subscription/resume-subscription.json POST /api/v1/server-to-server-interface/subscription/{subscription_id}/resume","href":"/api-reference/en/subscription/resume-subscription"},{"title":"Subscription List API","openapi":"api-reference/en/open-api-config/subscription/subscription-list.json GET /api/v1/server-to-server-interface/subscription/list","href":"/api-reference/en/subscription/subscription-list"},{"title":"Subscription Details API","openapi":"api-reference/en/open-api-config/subscription/subscription-details.json GET /api/v1/server-to-server-interface/subscription/{subscription_id}","href":"/api-reference/en/subscription/subscription-details"}]},{"group":"Wallet","pages":[{"title":"E-Wallet","openapi":"api-reference/en/open-api-config/wallet/e-wallet.json POST /api/v1/server-to-server-interface/payment","href":"/api-reference/en/wallet/wallet"},{"title":"QR Payment","openapi":"api-reference/en/open-api-config/wallet/qr-payment.json POST /api/v1/server-to-server-interface/payment","href":"/api-reference/en/wallet/wallet-2"}]},{"group":"Hosted Payment Page","pages":[{"title":"Hosted Payment Page","openapi":"api-reference/en/open-api-config/hpp/generate-link.json POST /api/v1/server-to-server-interface/hpp/generate/link","href":"/api-reference/en/hpp/generate-link"},{"title":"Tokenization","openapi":"api-reference/en/open-api-config/hpp/generate-link-token.json POST /api/v1/server-to-server-interface/hpp/generate/link","href":"/api-reference/en/hpp/generate-link-tokenization"}]}]},{"group":"Error and Response","pages":[{"title":"HTTP Response","href":"/api-reference/en/error-and-response/httpresponse"},{"title":"Response Codes","href":"/api-reference/en/error-and-response/responsecodes"},{"title":"Gateway Error Codes","href":"/api-reference/en/error-and-response/gatewayerrors"}]},{"group":"Webhook","pages":[{"title":"Webhook Handler","href":"/api-reference/en/webhook-handler"},{"title":"Webhook Sample Response","href":"/api-reference/en/webhook-handler-2"}]}]},{"tab":"Change Logs","pages":[{"title":"Change Logs","href":"/releases/revisions"}]},{"tab":"Support","pages":[{"title":"Support","href":"/support/plugins-woocommerce"}]}]},{"language":"jp","pages":[{"title":"jp","href":"/api-reference/jp/server-to-server/refund"}]}]},"basePath":"","title":"Refund API - DAS Gateway Documentation","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a74be98ba7","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","zoom-image-lightbox-B4-wUcHm.js","lightbox-handle-r17bVUz3.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}