{
"message": "The given data was invalid.",
"errors": {
"name": [
"The name field is required."
]
}
}
Payins
Refund Payin
Issues a partial or full refund for a confirmed payin. Only supported payment methods can be refunded.
For bank wire payins, a bankaccount_id is required to specify the refund destination.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Truust","colors":{"primary":"#073963","light":"#058ed8","dark":"#073963"},"logo":{"light":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","dark":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","href":"https://truust.io"},"favicon":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","navbar":{"links":[{"href":"https://truust.io","label":"Truust Website"},{"href":"https://truust.io/contact/","label":"Contact Us"}]},"footer":{"socials":{"website":"https://truust.io"}},"contextual":{"options":["copy","chatgpt","claude","perplexity","grok","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"http://dashboard-sandbox.truust.io"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"socialpay","hasAudioNarration":false,"actualSubdomain":"socialpay","customDomains":["docs.truust.io"],"gitSource":{"type":"github","owner":"truust-io","repo":"docs.truust.io","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae89a23f8e61e223f91fd82","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":146},{"language":"default","tag":"Customers","count":13},{"language":"default","tag":"Orders","count":11},{"language":"default","tag":"Verifications","count":10},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Payins","count":7},{"language":"default","tag":"Bundles","count":6},{"language":"default","tag":"Account","count":5},{"language":"default","tag":"Wallets","count":5},{"language":"default","tag":"Platform","count":5}]},"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":"rbac-expansion","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":"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":"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":"editor-metadata","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":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"table td:first-child code{white-space:nowrap}"}],"page":{"pagePath":"api-reference/refund-payin","slug":"/api-reference/refund-payin","pageMetadata":{"title":"Refund Payin","openapi":"POST /payins/{id}/refund","description":"Issues a partial or full refund for a confirmed payin. Only supported payment methods can be refunded.\nFor bank wire payins, a `bankaccount_id` is required to specify the refund destination.\n","href":"/api-reference/refund-payin"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Issues a partial or full refund for a confirmed payin. Only supported payment methods can be refunded.\\nFor bank wire payins, a \", _jsx(_components.code, {\n children: \"bankaccount_id\"\n }), \" is required to specify the refund destination.\"]\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 Payin","openapi":"POST /payins/{id}/refund","description":"Issues a partial or full refund for a confirmed payin. Only supported payment methods can be refunded.\nFor bank wire payins, a `bankaccount_id` is required to specify the refund destination.\n","href":"/api-reference/refund-payin"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Refund payin","description":"Issues a partial or full refund for a confirmed payin. Only supported payment methods can be refunded.\nFor bank wire payins, a `bankaccount_id` is required to specify the refund destination.\n","operationId":"refundPayin","tags":["Payins"],"parameters":["94f1a28d-fb8e-4f2f-afd8-c493dcfb4159"],"requestBody":"6b2c4e4d-4769-4bef-aac0-0c2f382ca26f","responses":{"200":"483e0c6e-6c77-4be7-b2d4-935d3e3afc94","403":"03aaa7c2-0d13-4c21-ae7e-9718f6e8898c","422":"2062ef1c-7429-424a-a65d-a4c5f0c2a23b"},"method":"post","type":"path","servers":["0f42c800-8246-4ac3-9108-23b6b071ae36","82d02f21-f641-4af8-8110-3ba7289f1338"],"security":["ba798aec-ece0-4b40-af38-d7b7451a8091"],"path":"/payins/{id}/refund","baseUrlOptions":["https://{subdomain}.truust.io/2.0","https://{subdomain}-sandbox.truust.io/2.0"],"title":"Refund payin","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"94f1a28d-fb8e-4f2f-afd8-c493dcfb4159":{"name":"id","in":"path","required":true,"schema":{"type":"integer","isRequired":true,"description":"Payin ID.","uniqueKey":"","typeLabel":"integer"},"description":"Payin ID."}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","example":{"amount":2,"multipayin":0},"properties":{"amount":{"type":"number","minimum":0,"description":"Amount to refund. Defaults to full amount if not provided.","uniqueKey":"amount","typeLabel":"number"},"multipayin":{"type":"integer","enum":[0,1],"description":"Set to `1` to refund all payins associated with the order of this payin.","uniqueKey":"multipayin","typeLabel":"enum\u003cinteger>"},"bankaccount_id":{"type":"integer","description":"Required if the payin is of Bankwire type. Bank account ID to receive the refund.","uniqueKey":"bankaccount_id","typeLabel":"integer"},"tag":{"type":"string","maxLength":100,"uniqueKey":"tag","typeLabel":"string"},"metadata":{"type":"object","additionalProperties":true,"uniqueKey":"metadata","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"amount":2,"multipayin":0}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"483e0c6e-6c77-4be7-b2d4-935d3e3afc94":{"description":"Payin with refund details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"id","typeLabel":"integer"},"self":{"type":"string","example":"/2.0/payins/456","uniqueKey":"self","typeLabel":"string"},"reference":{"oneOf":[{"type":"string","description":"Provider's payment reference ID.","uniqueKey":"reference.oneOf.0","typeLabel":"string"},{"type":"null","description":"Provider's payment reference ID.","uniqueKey":"reference.oneOf.1","typeLabel":"null"}],"uniqueKey":"reference","typeLabel":"string | null"},"type":{"type":"string","description":"Payment method type (e.g. `CARD`, `BANKWIRE`, `WALLET`).","uniqueKey":"type","typeLabel":"string"},"subtype":{"oneOf":[{"type":"string","uniqueKey":"subtype.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"subtype.oneOf.1","typeLabel":"null"}],"uniqueKey":"subtype","typeLabel":"string | null"},"status":{"type":"string","enum":["CREATED","AUTHORIZED","CONFIRMED","DENIED","REFUNDED","CANCELLED"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"provider":{"type":"object","additionalProperties":true,"description":"Raw provider response data.","uniqueKey":"provider","typeLabel":"object"},"tag":{"oneOf":[{"type":"string","uniqueKey":"tag.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"tag.oneOf.1","typeLabel":"null"}],"uniqueKey":"tag","typeLabel":"string | null"},"direct_link":{"oneOf":[{"type":"string","format":"uri","description":"Payment page URL. Only present when status is `CREATED` or `AUTHORIZED`.","uniqueKey":"direct_link.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"Payment page URL. Only present when status is `CREATED` or `AUTHORIZED`.","uniqueKey":"direct_link.oneOf.1","typeLabel":"null"}],"uniqueKey":"direct_link","typeLabel":"string\u003curi> | null"},"created_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_at","typeLabel":"string\u003cdate-time> | null"},"confirmed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"confirmed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"confirmed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"confirmed_at","typeLabel":"string\u003cdate-time> | null"},"denied_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"denied_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"denied_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"denied_at","typeLabel":"string\u003cdate-time> | null"},"connections":{"type":"object","description":"Hypermedia links to related resources.","additionalProperties":{"type":"string","uniqueKey":"connections.additionalProperties","typeLabel":"string"},"uniqueKey":"connections","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":123,"self":"/2.0/payins/456","reference":"\u003cstring>","type":"\u003cstring>","subtype":"\u003cstring>","status":"CREATED","provider":{},"tag":"\u003cstring>","direct_link":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","confirmed_at":"2023-11-07T05:31:56Z","denied_at":"2023-11-07T05:31:56Z","connections":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"03aaa7c2-0d13-4c21-ae7e-9718f6e8898c":{"description":"Refunds not supported for this payment method","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"2062ef1c-7429-424a-a65d-a4c5f0c2a23b":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"The given data was invalid.","uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"example":{"name":["The name field is required."]},"uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"The given data was invalid.","errors":{"name":["The name field is required."]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ba798aec-ece0-4b40-af38-d7b7451a8091":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Use your account's **Secret Key** as the Bearer token.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"0f42c800-8246-4ac3-9108-23b6b071ae36":{"url":"https://{subdomain}.truust.io/2.0","description":"Production","variables":{"subdomain":{"default":"your-subdomain","description":"Your account subdomain"}}},"82d02f21-f641-4af8-8110-3ba7289f1338":{"url":"https://{subdomain}-sandbox.truust.io/2.0","description":"Sandbox","variables":{"subdomain":{"default":"your-subdomain","description":"Your account subdomain"}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Use your account's **Secret Key** as the Bearer token.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use your account's **Secret Key** as the Bearer token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"socialpay","siteName":"Truust","title":"Refund Payin - Truust","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-12T07:06:50.384Z","originalFileLocation":"api-reference/refund-payin.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=\"Issues a partial or full refund for a confirmed payin. Only supported payment methods can be refunded. For bank wire payins, a bankaccount_id is required to specify the refund destination.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Truust\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Refund Payin - Truust\">\u003cmeta data-mint-head property=\"og:description\" content=\"Issues a partial or full refund for a confirmed payin. Only supported payment methods can be refunded. For bank wire payins, a bankaccount_id is required to specify the refund destination.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Truust\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.truust.io/api-reference/refund-payin\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://socialpay.mintlify.site/_mintlify/api/og/v2?division=Payins\u0026amp;title=Refund+Payin\u0026amp;description=Issues+a+partial+or+full+refund+for+a+confirmed+payin.+Only+supported+payment+methods+can+be+refunded.%0AFor+bank+wire+payins%2C+a+%60bankaccount_id%60+is+required+to+s\u0026amp;theme=07ebb1876c42192d9d839b55\u0026amp;signature=77784abaeb1cb492ab9fe1a03902d373ed9f2b770b230130a7962a04065f32ca\">\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 Payin - Truust\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Issues a partial or full refund for a confirmed payin. Only supported payment methods can be refunded. For bank wire payins, a bankaccount_id is required to specify the refund destination.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://socialpay.mintlify.site/_mintlify/api/og/v2?division=Payins\u0026amp;title=Refund+Payin\u0026amp;description=Issues+a+partial+or+full+refund+for+a+confirmed+payin.+Only+supported+payment+methods+can+be+refunded.%0AFor+bank+wire+payins%2C+a+%60bankaccount_id%60+is+required+to+s\u0026amp;theme=07ebb1876c42192d9d839b55\u0026amp;signature=77784abaeb1cb492ab9fe1a03902d373ed9f2b770b230130a7962a04065f32ca\">\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/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Truust\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#073963\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.truust.io/api-reference/refund-payin\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/refund-payin.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.truust.io/#organization\",\"name\":\"Truust\",\"url\":\"https://docs.truust.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.truust.io#website\",\"name\":\"Truust\",\"url\":\"https://docs.truust.io\",\"publisher\":{\"@id\":\"https://docs.truust.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.truust.io/api-reference/refund-payin#webpage\",\"url\":\"https://docs.truust.io/api-reference/refund-payin\",\"name\":\"Refund Payin\",\"description\":\"Issues a partial or full refund for a confirmed payin. Only supported payment methods can be refunded. For bank wire payins, a bankaccount_id is required to specify the refund destination.\",\"dateModified\":\"2026-03-12T07:06:50.384Z\",\"isPartOf\":{\"@id\":\"https://docs.truust.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.truust.io/api-reference/refund-payin#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.truust.io/api-reference/refund-payin#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.truust.io/api-reference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Payins\",\"item\":\"https://docs.truust.io/api-reference/list-payins\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Refund Payin\",\"item\":\"https://docs.truust.io/api-reference/refund-payin\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.truust.io/api-reference/refund-payin#apireference\",\"headline\":\"Refund Payin\",\"name\":\"Refund Payin\",\"description\":\"Issues a partial or full refund for a confirmed payin. Only supported payment methods can be refunded. For bank wire payins, a bankaccount_id is required to specify the refund destination.\",\"url\":\"https://docs.truust.io/api-reference/refund-payin\",\"mainEntityOfPage\":{\"@id\":\"https://docs.truust.io/api-reference/refund-payin#webpage\"},\"dateModified\":\"2026-03-12T07:06:50.384Z\",\"publisher\":{\"@id\":\"https://docs.truust.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.truust.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Truust\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Truust","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"http://dashboard-sandbox.truust.io"}]},"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"API Reference","icon":"code","groups":[{"group":"API Reference","pages":[{"title":"API Reference","href":"/api-reference"},{"group":"Account","pages":[{"title":"Get Current Account","openapi":"GET /accounts/me","href":"/api-reference/get-account"},{"title":"Update Account","openapi":"PUT /accounts/me","href":"/api-reference/update-account"},{"title":"Create Account","openapi":"POST /accounts","href":"/api-reference/create-account"},{"title":"Get Account Fees","openapi":"GET /accounts/fees/{currency}","href":"/api-reference/get-account-fees"},{"title":"Verify Account","openapi":"POST /accounts/verify","href":"/api-reference/verify-account"}]},{"group":"Customers","pages":[{"title":"List Customers","openapi":"GET /customers","href":"/api-reference/list-customers"},{"title":"Create Customer","openapi":"POST /customers","href":"/api-reference/create-customer"},{"title":"Get Customer","openapi":"GET /customers/{uuid}","href":"/api-reference/get-customer"},{"title":"Update Customer","openapi":"PUT /customers/{uuid}","href":"/api-reference/update-customer"},{"title":"List Customer Wallets","openapi":"GET /customers/{uuid}/wallets","href":"/api-reference/list-customer-wallets"},{"title":"List Customer Cards","openapi":"GET /customers/{uuid}/cards","href":"/api-reference/list-customer-cards"},{"title":"Add Card to Customer","openapi":"POST /customers/{uuid}/cards","href":"/api-reference/create-card"},{"title":"List Customer Bank Accounts","openapi":"GET /customers/{uuid}/bankaccounts","href":"/api-reference/list-customer-bank-accounts"},{"title":"List Customer Addresses","openapi":"GET /customers/{uuid}/addresses","href":"/api-reference/list-customer-addresses"},{"title":"Add Address to Customer","openapi":"POST /customers/{uuid}/addresses","href":"/api-reference/create-customer-address"},{"title":"Get Customer Address","openapi":"GET /customers/{uuid}/addresses/{address_uuid}","href":"/api-reference/get-customer-address"},{"title":"Update Customer Address","openapi":"PUT /customers/{uuid}/addresses/{address_uuid}","href":"/api-reference/update-customer-address"},{"title":"List Customer Subscriptions","openapi":"GET /customers/{uuid}/subscriptions","href":"/api-reference/list-customer-subscriptions"}]},{"group":"Orders","pages":[{"title":"List Orders","openapi":"GET /orders","href":"/api-reference/list-orders"},{"title":"Create Order","openapi":"POST /orders","href":"/api-reference/create-order"},{"title":"Get Order","openapi":"GET /orders/{id}","href":"/api-reference/get-order"},{"title":"Update Order","openapi":"PUT /orders/{id}","href":"/api-reference/update-order"},{"title":"Get Order Payin","openapi":"GET /orders/{id}/payin","href":"/api-reference/get-order-payin"},{"title":"Get Order Payout","openapi":"GET /orders/{id}/payout","href":"/api-reference/get-order-payout"},{"title":"Accept Order","openapi":"POST /orders/{id}/accept","href":"/api-reference/accept-order"},{"title":"Cancel Order","openapi":"POST /orders/{id}/cancel","href":"/api-reference/cancel-order"},{"title":"Validate Order","openapi":"POST /orders/{id}/validate","href":"/api-reference/validate-order"},{"title":"Send Order Receipt","openapi":"POST /orders/{id}/receipt","href":"/api-reference/send-order-receipt"},{"title":"Reimburse Order","openapi":"POST /orders/{id}/reimburse","href":"/api-reference/reimburse-order"}]},{"group":"Payins","pages":[{"title":"List Payins","openapi":"GET /payins","href":"/api-reference/list-payins"},{"title":"Create Payin","openapi":"POST /payins","href":"/api-reference/create-payin"},{"title":"Get Payin","openapi":"GET /payins/{id}","href":"/api-reference/get-payin"},{"title":"Sync Payin Status","openapi":"PUT /payins/{id}","description":"Forces a status refresh by querying the payment provider. Useful for polling.","href":"/api-reference/sync-payin"},{"title":"Refund Payin","openapi":"POST /payins/{id}/refund","href":"/api-reference/refund-payin"},{"title":"Cancel Pre-Authorization","openapi":"POST /payins/{id}/cancelpreauth","description":"Cancels an `AUTHORIZED` (pre-authorized) payin without capturing funds.","href":"/api-reference/cancel-pre-auth"},{"title":"Request to Pay","openapi":"POST /payins/{id}/request","href":"/api-reference/request-to-pay"}]},{"group":"Payouts","pages":[{"title":"List Payouts","openapi":"GET /payouts","href":"/api-reference/list-payouts"},{"title":"Create Payout","openapi":"POST /payouts","href":"/api-reference/create-payout"},{"title":"Get Payout","openapi":"GET /payouts/{id}","href":"/api-reference/get-payout"},{"title":"Sync Payout Status","openapi":"POST /payouts/{id}/update","href":"/api-reference/sync-payout"}]},{"group":"Wallets","pages":[{"title":"List Wallets","openapi":"GET /wallets","href":"/api-reference/list-wallets"},{"title":"Create Wallet","openapi":"POST /wallets","href":"/api-reference/create-wallet"},{"title":"Get Wallet","openapi":"GET /wallets/{uuid}","href":"/api-reference/get-wallet"},{"title":"Update Wallet","openapi":"PUT /wallets/{uuid}","href":"/api-reference/update-wallet"},{"title":"List Wallet Transactions","openapi":"GET /wallets/{uuid}/transactions","href":"/api-reference/list-wallet-transactions"}]},{"group":"Bank Accounts","pages":[{"title":"Create Bank Account","openapi":"POST /bankaccounts","href":"/api-reference/create-bank-account"},{"title":"Get Bank Account","openapi":"GET /bankaccounts/{uuid}","href":"/api-reference/get-bank-account"},{"title":"Get Bank Account Validation","openapi":"GET /bankaccounts/validation","href":"/api-reference/get-bank-account-validation"}]},{"group":"Cards","pages":[{"title":"Get Card","openapi":"GET /cards/{uuid}","href":"/api-reference/get-card"},{"title":"Delete Card","openapi":"DELETE /cards/{uuid}","href":"/api-reference/delete-card"}]},{"group":"Subscriptions","pages":[{"title":"List Subscriptions","openapi":"GET /subscriptions","href":"/api-reference/list-subscriptions"},{"title":"Create Subscription","openapi":"POST /subscriptions","href":"/api-reference/create-subscription"},{"title":"Get Subscription","openapi":"GET /subscriptions/{id}","href":"/api-reference/get-subscription"},{"title":"Cancel Subscription","openapi":"PUT /subscriptions/{id}/cancel","href":"/api-reference/cancel-subscription"}]},{"group":"Verifications","pages":[{"title":"List Verifications","openapi":"GET /verifications","href":"/api-reference/list-verifications"},{"title":"Get Verification","openapi":"GET /verifications/{uuid}","href":"/api-reference/get-verification"},{"title":"Submit Verification (KYC)","openapi":"PUT /verifications/{uuid}","href":"/api-reference/submit-verification"},{"title":"Request Verification Review","openapi":"POST /verifications/{uuid}/request","href":"/api-reference/request-verification"},{"title":"Create KYC for a Customer","openapi":"POST /customers/{uuid}/verify","href":"/api-reference/create-customer-verification"},{"title":"Get KYC Verification for a Customer","openapi":"GET /customers/{uuid}/verification","href":"/api-reference/get-customer-verification"},{"title":"List Verification Documents","openapi":"GET /verifications/{uuid}/documents","href":"/api-reference/list-verification-documents"},{"title":"Upload Verification Document","openapi":"POST /verifications/{uuid}/documents","href":"/api-reference/upload-verification-document"},{"title":"Get Verification Document","openapi":"GET /verifications/{uuid}/documents/{document_uuid}","href":"/api-reference/get-verification-document"},{"title":"Update Verification Document","openapi":"PUT /verifications/{uuid}/documents/{document_uuid}","href":"/api-reference/update-verification-document"}]},{"group":"Bundles","pages":[{"title":"List Bundles","openapi":"GET /bundles","href":"/api-reference/list-bundles"},{"title":"Create Bundle","openapi":"POST /bundles","href":"/api-reference/create-bundle"},{"title":"List Expired Bundles","openapi":"GET /bundles/expired","href":"/api-reference/list-expired-bundles"},{"title":"Get Bundle","openapi":"GET /bundles/{bundle_id}","href":"/api-reference/get-bundle"},{"title":"Update Bundle","openapi":"PUT /bundles/{bundle_id}","href":"/api-reference/update-bundle"},{"title":"List Orders for a Bundle","openapi":"GET /bundles/{bundle_id}/orders","href":"/api-reference/list-bundle-orders"}]},{"group":"Refunds","pages":[{"title":"List Refunds","openapi":"GET /refunds","href":"/api-reference/list-refunds"},{"title":"Get Refund","openapi":"GET /refunds/{id}","href":"/api-reference/get-refund"}]}]}]}]},"basePath":"","title":"Refund Payin - Truust","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}