{
"code": "BYRD901",
"description": "Transaction not found"
}
Transactions
Refund
When you want to refund values from a transaction, you need to send from your cash register to our API a request to do a refund value from the transaction.
The unique identifier that represents the new transaction that is created by the refund.
Example:
"fa1db27d-7869-403f-b9cf-4306bf0162d8"
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Paybyrd","colors":{"primary":"#6319F0","light":"#A4ADFF","dark":"#6319F0"},"logo":{"light":"https://mintcdn.com/paybyrd/X3OHHz6EJVWhNTO3/images/logo-light-full.png?fit=max\u0026auto=format\u0026n=X3OHHz6EJVWhNTO3\u0026q=85\u0026s=35a8f83493759c89b1ee80db71265676","dark":"https://mintcdn.com/paybyrd/X3OHHz6EJVWhNTO3/images/logo-dark-full.png?fit=max\u0026auto=format\u0026n=X3OHHz6EJVWhNTO3\u0026q=85\u0026s=7d1a41429a1708ce79ff23f45f296959"},"favicon":"https://mintcdn.com/paybyrd/GOPy9l9hDJ70VNa1/images/Avatar-Square.png?fit=max\u0026auto=format\u0026n=GOPy9l9hDJ70VNa1\u0026q=85\u0026s=78f2ae4b46f5e013c30d747f9889aa80","background":{"color":{"light":"#f2f2f2","dark":"#2e2e2e"}},"navbar":{"links":[{"href":"https://www.paybyrd.com/","label":"Paybyrd"},{"href":"https://status.paybyrd.com/","label":"Status"}],"primary":{"type":"button","label":"Get started with Paybyrd","href":"https://backoffice.paybyrd.com/"}},"footer":{"socials":{"website":"https://www.paybyrd.com/"},"links":[{"header":"Mobile","items":[{"label":"Get the dashboard app","href":"/get-started/start-building"}]}]},"fonts":{"family":"DM Sans","weight":400,"source":"https://fonts.gstatic.com/s/dmsans/v17/rP2Yp2ywxg089UriI5-g7M8btVsD8Ck0q7u0-K6z8GXhnU0.woff2","format":"woff2"},"icons":{"library":"lucide"},"integrations":{"ga4":{"measurementId":"G-7PQTSPLP9K"}},"contextual":{"options":["copy","view","vscode","chatgpt","claude","mcp","add-mcp"],"display":"toc"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"paybyrd","hasAudioNarration":false,"actualSubdomain":"paybyrd","customDomains":["docs.paybyrd.com"],"gitSource":{"type":"github","owner":"paybyrd","repo":"paybyrd-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adfac3b1ec88bdf5ff40127","collectionId":"99135064-27cc-4e8f-a205-a81518acd153","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adfac3b1ec88bdf5ff40127"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adfac3b1ec88bdf5ff40127","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":30},{"language":"default","tag":"Payments API","count":26},{"language":"default","tag":"Payments","count":23},{"language":"default","tag":"Integrations","count":14},{"language":"default","tag":"Accept Payments","count":13},{"language":"default","tag":"Get started","count":8},{"language":"default","tag":"Manage Payments","count":8},{"language":"default","tag":"Transactions","count":8},{"language":"default","tag":"Webhooks","count":8},{"language":"default","tag":"Point of Sale","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/transactions/refund","slug":"/api-reference/transactions/refund","pageMetadata":{"title":"Refund","description":"When you want to refund values from a transaction, you need to send from your cash register to our API a request to do a refund value from the transaction.","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/refund/{transactionId}","href":"/api-reference/transactions/refund","autogeneratedByOpenApi":true},"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: \"When you want to refund values from a transaction, you need to send from your cash register to our API a request to do a refund value from the 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}=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":"Refund","description":"When you want to refund values from a transaction, you need to send from your cash register to our API a request to do a refund value from the transaction.","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/refund/{transactionId}","href":"/api-reference/transactions/refund","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Transactions"],"summary":"Refund","description":"When you want to refund values from a transaction, you need to send from your cash register to our API a request to do a refund value from the transaction.","operationId":"api-transactions-refund","parameters":["1ac9cabf-0a7f-437c-91e3-e81435c0c542"],"requestBody":"826292fb-1fd7-4f75-b4a0-f92607cace09","responses":{"200":"61d22f11-bfa7-414f-b08b-231bd76581bc","202":"1dfa770c-d896-4dd6-9c79-23830793a839","400":"42073b51-9cde-4147-9866-2f5ebee4b797","404":"b2015195-eebe-46f6-92ac-3d0dd6af5d59"},"deprecated":false,"method":"post","type":"path","servers":["72fd1cc1-663b-467d-beb5-358ad27a2640"],"security":["25788e77-5004-4d78-a9a1-daae3364455d"],"path":"/api/v2/refund/{transactionId}","baseUrlOptions":["https://gateway.paybyrd.com"],"title":"Refund","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"1ac9cabf-0a7f-437c-91e3-e81435c0c542":{"name":"transactionId","in":"path","description":"The transaction identification to be refunded","schema":{"type":"string","isRequired":true,"description":"The transaction identification to be refunded","uniqueKey":"","typeLabel":"string"},"required":true}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["amount","isoAmount"],"properties":{"isoAmount":{"type":"integer","description":"The amount in ISO format, with the following pattern \"2500\"","format":"int64","isRequired":true,"uniqueKey":"isoAmount","typeLabel":"integer\u003cint64>"},"amount":{"type":"string","description":"Please use the 'isoAmount' field. This is essential due to our multi-currency support.","deprecated":true,"isRequired":true,"uniqueKey":"amount","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Request example":{"title":"Request example","value":{"isoAmount":100}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"61d22f11-bfa7-414f-b08b-231bd76581bc":{"description":"200","content":{"application/json":{"examples":{"Result":{"title":"Result","value":{"isoAmount":100,"amount":"1.00","code":"BYRD200","description":"Operation successfully completed","sourceTransaction":{"amount":"3.00","isoAmount":300,"refundedAmount":"1.00","isoRefundedAmount":100,"remainingAmount":"2.00","isoRemainingAmount":200,"transactionId":"c16ce479-319d-4e7b-a966-7735c34b2cc5"},"transactionId":"fa1db27d-7869-403f-b9cf-4306bf0162d8"}}},"schema":{"type":"object","properties":{"amount":{"type":"string","description":"The value that has been refunded.","example":"1.00","uniqueKey":"amount","typeLabel":"string"},"isoAmount":{"type":"integer","description":"The value that has been refunded.","example":100,"format":"int64","uniqueKey":"isoAmount","typeLabel":"integer\u003cint64>"},"code":{"type":"string","description":"Represents the Paybyrd code of the web request. To see more details check in [Return Codes](ref:appendix-return-codes) page.","example":"BYRD200","enum":["BYRD010","BYRD200","BYRD201","BYRD203","BYRD205","BYRD206","BYRD207","BYRD208","BYRD230","BYRD231","BYRD240","BYRD290","BYRD291","BYRD292","BYRD294","BYRD299","BYRD401","BYRD403","BYRD900","BYRD901","BYRD999"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"description":{"type":"string","example":"Operation successfully completed","description":"Represents a textually the description of the Paybyrd code of the web request. To see more details check in [Return Codes](ref:appendix-return-codes) page","enum":["Request accepted","Operation successfully completed","Payment being processed. Waiting for shopper","An error occurred while processing the payment. Please query the transaction to confirm its status","Operation rejected","Operation blocked by velocity","Pending redirect","Payment canceled by the shopper","Payment already refunded","The refund amount exceeds the remaining balance of the original payment","Token is expired","An error occurred while pre processing the transaction. Please review your request and try again","An error occurred during while preparing transaction for acquiring. Please review your request and try again","No payment methods available for this operation. Please contact Paybyrd's support","Transaction could not be updated. Please review your request and try again","Operation could not be completed. Please review your request and try again","Resource access is forbidden","Resource access unauthorized","Invalid input","Resource not found","Operation failed"],"uniqueKey":"description","typeLabel":"enum\u003cstring>"},"sourceTransaction":{"type":"object","properties":{"amount":{"type":"string","description":"The value of source transaction.","example":"3.00","uniqueKey":"sourceTransaction.amount","typeLabel":"string"},"isoAmount":{"type":"integer","description":"The value of source transaction.","example":300,"format":"int64","uniqueKey":"sourceTransaction.isoAmount","typeLabel":"integer\u003cint64>"},"refundedAmount":{"type":"string","example":"1.00","uniqueKey":"sourceTransaction.refundedAmount","typeLabel":"string"},"isoRefundedAmount":{"type":"integer","example":100,"uniqueKey":"sourceTransaction.isoRefundedAmount","typeLabel":"integer"},"remainingAmount":{"type":"string","example":"2.00","uniqueKey":"sourceTransaction.remainingAmount","typeLabel":"string"},"isoRemainingAmount":{"type":"integer","example":200,"uniqueKey":"sourceTransaction.isoRemainingAmount","typeLabel":"integer"},"transactionId":{"type":"string","description":"The refunded transaction identifier.","format":"guid","example":"c16ce479-319d-4e7b-a966-7735c34b2cc5","uniqueKey":"sourceTransaction.transactionId","typeLabel":"string\u003cguid>"}},"uniqueKey":"sourceTransaction","typeLabel":"object"},"transactionId":{"type":"string","description":"The unique identifier that represents the new transaction that is created by the refund.","example":"fa1db27d-7869-403f-b9cf-4306bf0162d8","uniqueKey":"transactionId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"1dfa770c-d896-4dd6-9c79-23830793a839":{"description":"202","content":{"application/json":{"examples":{"Result":{"title":"Result","value":{"code":"BYRD010","description":"Request accepted","links":{"href":"/api/v2/transactions?requestId=93ce3e62-82b9-4570-8248-45915e794fd0","rel":"transactions","type":"GET"}}}},"schema":{"type":"object","properties":{"code":{"type":"string","description":"BYRD010","uniqueKey":"code","typeLabel":"string"},"description":{"type":"string","description":"Request accepted","uniqueKey":"description","typeLabel":"string"},"links":{"type":"object","properties":{"href":{"type":"string","description":"The partial url to get the current process.","uniqueKey":"links.href","typeLabel":"string"},"rel":{"type":"string","description":"The related entity to the process.","uniqueKey":"links.rel","typeLabel":"string"},"type":{"type":"string","description":"The HTTP method which must be used in the partial url.","uniqueKey":"links.type","typeLabel":"string"}},"uniqueKey":"links","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"42073b51-9cde-4147-9866-2f5ebee4b797":{"description":"400","content":{"application/json":{"examples":{"Result":{"title":"Result","value":{"code":"BYRD230","description":"Payment already refunded"}}},"schema":{"type":"object","properties":{"code":{"type":"string","description":"Represents the Paybyrd code of the web request. To see more details check in [Return Codes](ref:appendix-return-codes) page.","example":"BYRD200","enum":["BYRD010","BYRD200","BYRD201","BYRD203","BYRD205","BYRD206","BYRD207","BYRD208","BYRD230","BYRD231","BYRD240","BYRD290","BYRD291","BYRD292","BYRD294","BYRD299","BYRD401","BYRD403","BYRD900","BYRD901","BYRD999"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"description":{"type":"string","example":"Operation successfully completed","description":"Represents a textually the description of the Paybyrd code of the web request. To see more details check in [Return Codes](ref:appendix-return-codes) page","enum":["Request accepted","Operation successfully completed","Payment being processed. Waiting for shopper","An error occurred while processing the payment. Please query the transaction to confirm its status","Operation rejected","Operation blocked by velocity","Pending redirect","Payment canceled by the shopper","Payment already refunded","The refund amount exceeds the remaining balance of the original payment","Token is expired","An error occurred while pre processing the transaction. Please review your request and try again","An error occurred during while preparing transaction for acquiring. Please review your request and try again","No payment methods available for this operation. Please contact Paybyrd's support","Transaction could not be updated. Please review your request and try again","Operation could not be completed. Please review your request and try again","Resource access is forbidden","Resource access unauthorized","Invalid input","Resource not found","Operation failed"],"uniqueKey":"description","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"b2015195-eebe-46f6-92ac-3d0dd6af5d59":{"description":"404","content":{"application/json":{"examples":{"Result":{"title":"Result","value":{"code":"BYRD901","description":"Transaction not found"}}},"schema":{"type":"object","properties":{"code":{"type":"string","description":"Represents the Paybyrd code of the web request. To see more details check in [Return Codes](ref:appendix-return-codes) page.","example":"BYRD200","enum":["BYRD010","BYRD200","BYRD201","BYRD203","BYRD205","BYRD206","BYRD207","BYRD208","BYRD230","BYRD231","BYRD240","BYRD290","BYRD291","BYRD292","BYRD294","BYRD299","BYRD401","BYRD403","BYRD900","BYRD901","BYRD999"],"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"description":{"type":"string","example":"Operation successfully completed","description":"Represents a textually the description of the Paybyrd code of the web request. To see more details check in [Return Codes](ref:appendix-return-codes) page","enum":["Request accepted","Operation successfully completed","Payment being processed. Waiting for shopper","An error occurred while processing the payment. Please query the transaction to confirm its status","Operation rejected","Operation blocked by velocity","Pending redirect","Payment canceled by the shopper","Payment already refunded","The refund amount exceeds the remaining balance of the original payment","Token is expired","An error occurred while pre processing the transaction. Please review your request and try again","An error occurred during while preparing transaction for acquiring. Please review your request and try again","No payment methods available for this operation. Please contact Paybyrd's support","Transaction could not be updated. Please review your request and try again","Operation could not be completed. Please review your request and try again","Resource access is forbidden","Resource access unauthorized","Invalid input","Resource not found","Operation failed"],"uniqueKey":"description","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"25788e77-5004-4d78-a9a1-daae3364455d":{"authByApiKey":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"authByApiKey"}}},"servers":{"72fd1cc1-663b-467d-beb5-358ad27a2640":{"url":"https://gateway.paybyrd.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"authByApiKey"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"authByApiKey","name":"x-api-key"}],"title":"authByApiKey"}]},"originalFileLocation":"openapi.yml"},"subdomain":"paybyrd","siteName":"Paybyrd","title":"Refund - Paybyrd","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T19:38:40.434Z","originalFileLocation":"api-reference/transactions/refund.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=\"description\" content=\"When you want to refund values from a transaction, you need to send from your cash register to our API a request to do a refund value from the transaction.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Paybyrd\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_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/paybyrd/ZQOx_ixbIt0VLR4c/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Refund - Paybyrd\">\u003cmeta data-mint-head property=\"og:description\" content=\"When you want to refund values from a transaction, you need to send from your cash register to our API a request to do a refund value from the transaction.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Paybyrd\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.paybyrd.com/api-reference/transactions/refund\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://paybyrd.mintlify.app/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Refund\u0026amp;description=When+you+want+to+refund+values+from+a+transaction%2C+you+need+to+send+from+your+cash+register+to+our+API+a+request+to+do+a+refund+value+from+the+transaction.\u0026amp;theme=482e40cfd6999bc2608c5e34\u0026amp;signature=97e336d5dd9982211cddbb4c6f85a1002b99703c492cbc1ac26d848855dea239\">\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 - Paybyrd\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"When you want to refund values from a transaction, you need to send from your cash register to our API a request to do a refund value from the transaction.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://paybyrd.mintlify.app/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Refund\u0026amp;description=When+you+want+to+refund+values+from+a+transaction%2C+you+need+to+send+from+your+cash+register+to+our+API+a+request+to+do+a+refund+value+from+the+transaction.\u0026amp;theme=482e40cfd6999bc2608c5e34\u0026amp;signature=97e336d5dd9982211cddbb4c6f85a1002b99703c492cbc1ac26d848855dea239\">\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/paybyrd/ZQOx_ixbIt0VLR4c/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Paybyrd\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6319F0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.paybyrd.com/api-reference/transactions/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/transactions/refund.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.paybyrd.com/#organization\",\"name\":\"Paybyrd\",\"url\":\"https://docs.paybyrd.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/paybyrd/X3OHHz6EJVWhNTO3/images/logo-light-full.png?fit=max\u0026auto=format\u0026n=X3OHHz6EJVWhNTO3\u0026q=85\u0026s=35a8f83493759c89b1ee80db71265676\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.paybyrd.com#website\",\"name\":\"Paybyrd\",\"url\":\"https://docs.paybyrd.com\",\"publisher\":{\"@id\":\"https://docs.paybyrd.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.paybyrd.com/api-reference/transactions/refund#webpage\",\"url\":\"https://docs.paybyrd.com/api-reference/transactions/refund\",\"name\":\"Refund\",\"description\":\"When you want to refund values from a transaction, you need to send from your cash register to our API a request to do a refund value from the transaction.\",\"dateModified\":\"2026-10-26T19:38:40.434Z\",\"isPartOf\":{\"@id\":\"https://docs.paybyrd.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.paybyrd.com/api-reference/transactions/refund#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.paybyrd.com/api-reference/transactions/refund#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Payments API\",\"item\":\"https://docs.paybyrd.com/api-reference/payments/create-payment\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Refund\",\"item\":\"https://docs.paybyrd.com/api-reference/transactions/refund\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.paybyrd.com/api-reference/transactions/refund#apireference\",\"headline\":\"Refund\",\"name\":\"Refund\",\"description\":\"When you want to refund values from a transaction, you need to send from your cash register to our API a request to do a refund value from the transaction.\",\"url\":\"https://docs.paybyrd.com/api-reference/transactions/refund\",\"mainEntityOfPage\":{\"@id\":\"https://docs.paybyrd.com/api-reference/transactions/refund#webpage\"},\"dateModified\":\"2026-10-26T19:38:40.434Z\",\"publisher\":{\"@id\":\"https://docs.paybyrd.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.paybyrd.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Paybyrd\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Paybyrd","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":"/introduction"}]},{"tab":"Payments","pages":[{"title":"Payments","href":"/accept-payments/how-it-works"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/embed/checkout"}]},{"tab":"API Reference","groups":[{"group":"API introduction","pages":[{"title":"API intro","href":"/api-reference/api-intro"},{"title":"Response code reference","href":"/api-reference/api-code-reference"},{"title":"Webhook API","href":"/api-reference/webhooks"}]},{"group":"Payments API","expanded":true,"pages":[{"group":"Payments","pages":[{"title":"Create Payment","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/payment","href":"/api-reference/payments/create-payment"},{"title":"Finish two-step card payment","description":"","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/payment/{transactionId}/pay","href":"/api-reference/payments/finish-two-step-card-payment"}]},{"group":"Transactions","pages":[{"title":"Refund","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/refund/{transactionId}","href":"/api-reference/transactions/refund"},{"title":"Release","description":"In order to release a reserved amount through a pre-authorization is necessary to send a request from your cash register to our API.","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/release/{transactionId}","href":"/api-reference/transactions/release"},{"title":"Capture","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/capture/{transactionId}","href":"/api-reference/transactions/capture"},{"title":"Cancel","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/cancel/{transactionId}","href":"/api-reference/transactions/cancel"},{"title":"Adjust","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/adjust/{transactionId}","href":"/api-reference/transactions/adjust"},{"title":"Query","deprecated":false,"version":null,"openapi":"/openapi.yml get /api/v2/transactions/{transactionId}","href":"/api-reference/transactions/query"},{"title":"Receipt","deprecated":false,"version":null,"openapi":"/openapi.yml get /api/v2/transactions/{transactionId}/receipt","href":"/api-reference/transactions/receipt"},{"title":"Query by acquirer custom identifier","deprecated":false,"version":null,"openapi":"/openapi.yml get /api/v2/transactions?acquirerCustomId=${customIdentifier}","href":"/api-reference/transactions/query-by-acquirer-custom-identifier"}]},{"group":"Webhooks","pages":[{"title":"Setup URL","deprecated":true,"version":null,"openapi":"/openapi.yml put /api/v1/webhook","href":"/api-reference/webhooks/setup-url"},{"title":"Gets a webhook settings by its Id","deprecated":null,"version":null,"openapi":"/openapi.yml get /api/v2/webhooks/{webhookId}","href":"/api-reference/webhooks/gets-a-webhook-settings-by-its-id"},{"title":"Gets all webhook settings","deprecated":null,"version":null,"openapi":"/openapi.yml get /api/v2/webhooks","href":"/api-reference/webhooks/gets-all-webhook-settings"},{"title":"Creates a new webhook setting","deprecated":null,"version":null,"openapi":"/openapi.yml post /api/v2/webhooks","href":"/api-reference/webhooks/creates-a-new-webhook-setting"},{"title":"Updates a webhook setting url","deprecated":null,"version":null,"openapi":"/openapi.yml patch /api/v2/webhooks/{webhookId}/url","href":"/api-reference/webhooks/updates-a-webhook-setting-url"},{"title":"Enables a webhook setting","deprecated":null,"version":null,"openapi":"/openapi.yml post /api/v2/webhooks/{webhookId}/enable","href":"/api-reference/webhooks/enables-a-webhook-setting"},{"title":"Disables a webhook setting","deprecated":null,"version":null,"openapi":"/openapi.yml post /api/v2/webhooks/{webhookId}/disable","href":"/api-reference/webhooks/disables-a-webhook-setting"},{"title":"Updates a webhook setting url","deprecated":null,"version":null,"openapi":"/openapi.yml patch /api/v2/webhooks/{webhookId}/credentials","href":"/api-reference/webhooks/updates-a-webhook-setting-url-1"}]},{"group":"Paybylink","pages":[{"title":"resend","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/paybylink/{orderId}/resend","href":"/api-reference/paybylink/resend"}]},{"group":"Subscription","pages":[{"title":"Create","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/subscriptions","href":"/api-reference/subscription/create"}]},{"group":"Orders","pages":[{"title":"Create Order","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/orders","href":"/api-reference/orders/create-order"},{"title":"Query Order","deprecated":false,"version":null,"openapi":"/openapi.yml get /api/v2/orders/{orderId}","href":"/api-reference/orders/query-order"},{"title":"Cancel Order","deprecated":false,"version":null,"openapi":"/openapi.yml delete /api/v2/orders/{orderId}","href":"/api-reference/orders/cancel-order"}]},{"group":"Tokenization","pages":[{"title":"Get Token by reference","deprecated":false,"version":null,"openapi":"/openapi.yml get /api/v2/tokens","href":"/api-reference/tokenization/get-token-by-reference"},{"title":"Create Token","deprecated":false,"version":null,"openapi":"/openapi.yml post /api/v2/tokens","href":"/api-reference/tokenization/create-token"},{"title":"Get Token By Id","deprecated":false,"version":null,"openapi":"/openapi.yml get /api/v2/tokens/{tokenId}","href":"/api-reference/tokenization/get-token-by-id"}]}]},{"group":"Settlements API","pages":[{"group":"Settlement files","pages":[{"title":"List settlement files","deprecated":null,"version":null,"openapi":"/settlements-api.yml get /api/v1/SettlementFiles","href":"/api-reference/settlement-files/list-settlement-files"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Refund - Paybyrd","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}