What happens when the AML check flags a payment, and how the funds go back to the payer.
Every incoming payment is screened by our AML check. When the check flags a
payment, the invoice ends in high_risk: the payment is not credited to
your balance, and the funds stay on the invoice’s deposit address until they
are returned to the payer. You receive a high_risk webhook like for any
other final status.
Direct refund
A flagged payment can be refunded with no identity verification of the
payer — to the address it was sent from by default, or to another address on
the same network. Either side can start it:
The payer, on the invoice’s payment page. It is the payment_url from
the create response, or https://pawpayments.com/checkout/{external_id}
with the external_id from the webhook. The refund to the sending address
works even if the payer never opened the page before, for example when they
paid to an address you displayed on your own site. Choosing another address
on the page is possible only from the browser the payer opened it in before
paying; otherwise refund to another address through the API or the
dashboard.
You, through the API (below) or with Refund on the invoice in your
dashboard (another address there asks for your two-factor code, like a
withdrawal).
The network fee for the refund is deducted from the refunded amount. The
direct refund is available for 30 days after the payment was flagged. The
invoice then moves to refunding and, once the transaction is on chain, to
refunded; both changes are delivered as webhooks.
If the payer sent the funds directly from an exchange account, a refund to the
sending address may not reach them: exchanges often send from shared
addresses. Refund such payments to the payer’s own wallet address instead.
Some addresses cannot receive a direct refund — for example an address you
have withdrawn your balance to. The refund then answers
REFUND_ADDRESS_NOT_ALLOWED; use another address or the sending address.
Refund through the API
POST /api/v2/invoices/{invoice_id}/refund with an optional JSON body. Send
no body (or {}) to refund to the sending address, or name the destination:
refund_address in the answer is where the funds are sent. A refund to
another address than the sender follows the same rule as payouts: the request
must come from an IP in your account’s allowed subnets, otherwise it answers
PAYOUTS_DISABLED. A refund to the sending address works from anywhere. The
endpoint is not available with sandbox keys (SANDBOX_UNSUPPORTED).
Error code
HTTP
Meaning
REFUND_UNAVAILABLE
403
This payment can only be refunded through our compliance team.
REFUND_EXPIRED
403
More than 30 days have passed since the payment was flagged.
REFUND_ADDRESS_NOT_ALLOWED
403
This address cannot receive the refund; use another one or the sending address.
INVALID_ADDRESS
400
refund_address is not a valid address on the payment’s network.
PAYOUTS_DISABLED
403
refund_address is not the sender and the request does not come from an allowed subnet.
REFUND_RETRY_LATER
503
The refund could not be started right now; nothing was sent, try again in a few minutes.
INVALID_STATUS
409
The invoice is not high_risk.
REFUND_IN_PROGRESS
409
A refund of this payment has already been started.
ALREADY_REFUNDED
409
The payment has already been refunded.
NOT_FOUND
404
No invoice with this id belongs to your account.
When compliance handles the refund
Some flagged payments cannot be refunded directly, for example an unusually
large amount or a network on which the refund cannot be sent without our
team. For a specific payment we do not disclose why. The API answers
REFUND_UNAVAILABLE, and the payment page asks the payer to email
aml@pawpayments.com with their order ID; our
compliance team takes it from there.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"PawPayments API","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#6366F1"},"logo":{"light":"https://mintcdn.com/pawpaymentsinc/GvUEHrxVBBZGqu1B/logo/light.png?fit=max\u0026auto=format\u0026n=GvUEHrxVBBZGqu1B\u0026q=85\u0026s=e63c9c4d933201f4ef804ee6b424f0df","dark":"https://mintcdn.com/pawpaymentsinc/GvUEHrxVBBZGqu1B/logo/dark.png?fit=max\u0026auto=format\u0026n=GvUEHrxVBBZGqu1B\u0026q=85\u0026s=329208374dd84350bd253aac43332e16","href":"https://pawpayments.com"},"favicon":"https://mintcdn.com/pawpaymentsinc/GvUEHrxVBBZGqu1B/favicon.png?fit=max\u0026auto=format\u0026n=GvUEHrxVBBZGqu1B\u0026q=85\u0026s=f1058fcf9d51a71711e5de8f50095260","navbar":{"links":[{"href":"/plugins/overview","label":"Plugins \u0026 SDKs"},{"href":"https://pawpayments.com","label":"Dashboard"}],"primary":{"type":"button","label":"Get an API key","href":"https://pawpayments.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pawpaymentsinc","hasAudioNarration":false,"actualSubdomain":"pawpaymentsinc","customDomains":["docs.pawpayments.com"],"gitSource":{"type":"github","owner":"pawpayments","repo":"docs","deployBranch":"main","isPrivate":false,"contentDirectory":"","mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af4bfb1775e4ad0c10ecd70","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":20},{"language":"default","tag":"API Reference","count":20},{"language":"default","tag":"Plugins \u0026 SDKs","count":8},{"language":"default","tag":"Introduction","count":7},{"language":"default","tag":"Migrate from another provider","count":5},{"language":"default","tag":"Invoices","count":5},{"language":"default","tag":"Payouts","count":4},{"language":"default","tag":"Permanent addresses","count":4},{"language":"default","tag":"Catalog","count":2},{"language":"default","tag":"Merchant","count":2}]},"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":"custom-rbac-roles","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":"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":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"refunds","slug":"/refunds","pageMetadata":{"title":"Flagged payments and refunds","description":"What happens when the AML check flags a payment, and how the funds go back to the payer.","href":"/refunds"},"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: \"What happens when the AML check flags a payment, and how the funds go back to the payer.\"\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={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Every incoming payment is screened by our AML check. When the check flags a\npayment, the invoice ends in `,_jsx(_components.code,{children:`high_risk`}),`: the payment is `,_jsx(_components.strong,{children:`not`}),` credited to\nyour balance, and the funds stay on the invoice’s deposit address until they\nare returned to the payer. You receive a `,_jsx(_components.code,{children:`high_risk`}),` webhook like for any\nother final status.`]}),`\n`,_jsx(Heading,{level:`2`,id:`direct-refund`,children:`Direct refund`}),`\n`,_jsxs(_components.p,{children:[`A flagged payment can be refunded with `,_jsx(_components.strong,{children:`no identity verification`}),` of the\npayer — to the address it was sent from by default, or to another address on\nthe same network. Either side can start it:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The payer`}),`, on the invoice’s payment page. It is the `,_jsx(_components.code,{children:`payment_url`}),` from\nthe create response, or `,_jsx(_components.code,{children:`https://pawpayments.com/checkout/{external_id}`}),`\nwith the `,_jsx(_components.code,{children:`external_id`}),` from the webhook. The refund to the sending address\nworks even if the payer never opened the page before, for example when they\npaid to an address you displayed on your own site. Choosing another address\non the page is possible only from the browser the payer opened it in before\npaying; otherwise refund to another address through the API or the\ndashboard.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`You`}),`, through the API (below) or with `,_jsx(_components.strong,{children:`Refund`}),` on the invoice in your\ndashboard (another address there asks for your two-factor code, like a\nwithdrawal).`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The network fee for the refund is deducted from the refunded amount. The\ndirect refund is available for 30 days after the payment was flagged. The\ninvoice then moves to `,_jsx(_components.code,{children:`refunding`}),` and, once the transaction is on chain, to\n`,_jsx(_components.code,{children:`refunded`}),`; both changes are delivered as webhooks.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`If the payer sent the funds directly from an exchange account, a refund to the\nsending address may not reach them: exchanges often send from shared\naddresses. Refund such payments to the payer’s own wallet address instead.`})}),`\n`,_jsxs(_components.p,{children:[`Some addresses cannot receive a direct refund — for example an address you\nhave withdrawn your balance to. The refund then answers\n`,_jsx(_components.code,{children:`REFUND_ADDRESS_NOT_ALLOWED`}),`; use another address or the sending address.`]}),`\n`,_jsx(Heading,{level:`3`,id:`refund-through-the-api`,children:`Refund through the API`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`POST /api/v2/invoices/{invoice_id}/refund`}),` with an optional JSON body. Send\nno body (or `,_jsx(_components.code,{children:`{}`}),`) to refund to the sending address, or name the destination:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.pawpayments.com/api/v2/invoices/65f1c3a4e8b1c2d3a4b5c6e0/refund`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$PAW_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"refund_address\": \"TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf\"}'`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ok\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"result\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"refunding\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"refund_address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`refund_address`}),` in the answer is where the funds are sent. A refund to\nanother address than the sender follows the same rule as payouts: the request\nmust come from an IP in your account’s allowed subnets, otherwise it answers\n`,_jsx(_components.code,{children:`PAYOUTS_DISABLED`}),`. A refund to the sending address works from anywhere. The\nendpoint is not available with sandbox keys (`,_jsx(_components.code,{children:`SANDBOX_UNSUPPORTED`}),`).`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Error code`}),_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`REFUND_UNAVAILABLE`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:`This payment can only be refunded through our compliance team.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`REFUND_EXPIRED`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:`More than 30 days have passed since the payment was flagged.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`REFUND_ADDRESS_NOT_ALLOWED`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:`This address cannot receive the refund; use another one or the sending address.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_ADDRESS`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`refund_address`}),` is not a valid address on the payment’s network.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PAYOUTS_DISABLED`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`refund_address`}),` is not the sender and the request does not come from an allowed subnet.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`REFUND_RETRY_LATER`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:`The refund could not be started right now; nothing was sent, try again in a few minutes.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_STATUS`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsxs(_components.td,{children:[`The invoice is not `,_jsx(_components.code,{children:`high_risk`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`REFUND_IN_PROGRESS`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:`A refund of this payment has already been started.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ALREADY_REFUNDED`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:`The payment has already been refunded.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_FOUND`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:`No invoice with this id belongs to your account.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`when-compliance-handles-the-refund`,children:`When compliance handles the refund`}),`\n`,_jsxs(_components.p,{children:[`Some flagged payments cannot be refunded directly, for example an unusually\nlarge amount or a network on which the refund cannot be sent without our\nteam. For a specific payment we do not disclose why. The API answers\n`,_jsx(_components.code,{children:`REFUND_UNAVAILABLE`}),`, and the payment page asks the payer to email\n`,_jsx(_components.a,{href:`mailto:aml@pawpayments.com`,children:`aml@pawpayments.com`}),` with their order ID; our\ncompliance team takes it from there.`]})]})}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":"Flagged payments and refunds","description":"What happens when the AML check flags a payment, and how the funds go back to the payer.","href":"/refunds"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Direct refund","slug":"direct-refund","depth":2,"children":[{"title":"Refund through the API","slug":"refund-through-the-api","depth":3,"children":[]}]},{"title":"When compliance handles the refund","slug":"when-compliance-handles-the-refund","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"pawpaymentsinc","siteName":"PawPayments API","title":"Flagged payments and refunds - PawPayments API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T20:49:10.186Z","originalFileLocation":"refunds.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=\"What happens when the AML check flags a payment, and how the funds go back to the payer.\">\u003cmeta data-mint-head name=\"application-name\" content=\"PawPayments API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pawpaymentsinc/MC7gd2QKlNekXMRK/_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/pawpaymentsinc/MC7gd2QKlNekXMRK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pawpaymentsinc/MC7gd2QKlNekXMRK/_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/pawpaymentsinc/MC7gd2QKlNekXMRK/_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/pawpaymentsinc/MC7gd2QKlNekXMRK/_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/pawpaymentsinc/MC7gd2QKlNekXMRK/_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/pawpaymentsinc/MC7gd2QKlNekXMRK/_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/pawpaymentsinc/MC7gd2QKlNekXMRK/_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/pawpaymentsinc/MC7gd2QKlNekXMRK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Flagged payments and refunds - PawPayments API\">\u003cmeta data-mint-head property=\"og:description\" content=\"What happens when the AML check flags a payment, and how the funds go back to the payer.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PawPayments API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.pawpayments.com/refunds\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pawpaymentsinc.mintlify.site/_mintlify/api/og/v2?division=Introduction\u0026amp;title=Flagged+payments+and+refunds\u0026amp;description=What+happens+when+the+AML+check+flags+a+payment%2C+and+how+the+funds+go+back+to+the+payer.\u0026amp;theme=e8ae6fe84fd0496427904623\u0026amp;signature=2f19b1bf2db37000fcd49dd047b0cd860810799594ee9115ac137ee39700aa02\">\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=\"Flagged payments and refunds - PawPayments API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What happens when the AML check flags a payment, and how the funds go back to the payer.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pawpaymentsinc.mintlify.site/_mintlify/api/og/v2?division=Introduction\u0026amp;title=Flagged+payments+and+refunds\u0026amp;description=What+happens+when+the+AML+check+flags+a+payment%2C+and+how+the+funds+go+back+to+the+payer.\u0026amp;theme=e8ae6fe84fd0496427904623\u0026amp;signature=2f19b1bf2db37000fcd49dd047b0cd860810799594ee9115ac137ee39700aa02\">\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/pawpaymentsinc/MC7gd2QKlNekXMRK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PawPayments API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.pawpayments.com/refunds\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/refunds.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.pawpayments.com/#organization\",\"name\":\"PawPayments API\",\"url\":\"https://docs.pawpayments.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pawpaymentsinc/GvUEHrxVBBZGqu1B/logo/light.png?fit=max\u0026auto=format\u0026n=GvUEHrxVBBZGqu1B\u0026q=85\u0026s=e63c9c4d933201f4ef804ee6b424f0df\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.pawpayments.com#website\",\"name\":\"PawPayments API\",\"url\":\"https://docs.pawpayments.com\",\"publisher\":{\"@id\":\"https://docs.pawpayments.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.pawpayments.com/refunds#webpage\",\"url\":\"https://docs.pawpayments.com/refunds\",\"name\":\"Flagged payments and refunds\",\"description\":\"What happens when the AML check flags a payment, and how the funds go back to the payer.\",\"dateModified\":\"2026-11-05T20:49:10.186Z\",\"isPartOf\":{\"@id\":\"https://docs.pawpayments.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.pawpayments.com/refunds#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.pawpayments.com/refunds#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Introduction\",\"item\":\"https://docs.pawpayments.com/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Flagged payments and refunds\",\"item\":\"https://docs.pawpayments.com/refunds\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.pawpayments.com/refunds#article\",\"headline\":\"Flagged payments and refunds\",\"name\":\"Flagged payments and refunds\",\"description\":\"What happens when the AML check flags a payment, and how the funds go back to the payer.\",\"url\":\"https://docs.pawpayments.com/refunds\",\"mainEntityOfPage\":{\"@id\":\"https://docs.pawpayments.com/refunds#webpage\"},\"dateModified\":\"2026-11-05T20:49:10.186Z\",\"publisher\":{\"@id\":\"https://docs.pawpayments.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.pawpayments.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PawPayments API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"PawPayments API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/refunds.md","siteName":"PawPayments API","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Introduction","pages":[{"title":"Overview","href":"/overview"},{"title":"Authentication","href":"/authentication"},{"title":"Sandbox","href":"/sandbox"},{"title":"Billing types","href":"/billing-type"},{"title":"Webhooks","description":"Outgoing webhook format, delivery semantics, and signature verification.","href":"/webhooks"},{"title":"Flagged payments and refunds","href":"/refunds"},{"title":"Errors","description":"Error envelope and common error codes.","href":"/errors"}]},{"group":"Migrate from another provider","pages":[{"title":"Migrate from another provider","href":"/compat/overview"},{"title":"Cryptomus","href":"/compat/cryptomus"},{"title":"Heleket","href":"/compat/heleket"},{"title":"NowPayments","href":"/compat/nowpayments"},{"title":"CoinPayments","href":"/compat/coinpayments"}]},{"group":"Plugins \u0026 SDKs","pages":[{"title":"Plugins \u0026 SDKs","href":"/plugins/overview"},{"title":"PHP SDK","href":"/plugins/php-sdk"},{"title":"Python SDK","href":"/plugins/python-sdk"},{"title":"Node.js SDK","href":"/plugins/node-sdk"},{"title":"WooCommerce","href":"/plugins/woocommerce"},{"title":"WHMCS","href":"/plugins/whmcs"},{"title":"Blesta","href":"/plugins/blesta"},{"title":"BillManager","href":"/plugins/billmanager"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/catalog/list-supported-assets"}]}]},"basePath":"","title":"Flagged payments and refunds - PawPayments API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}