{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Canceling a Payout Request","description":"Tilia Wallet Developer Documentation","siteUrl":"https://thunes-tilia-docs.redocly.app/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"canceling-a-payout-request","__idx":0},"children":["Canceling a Payout Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There may be certain cases where you may need to cancel a payout transaction, for example, if the user changes their mind and wants to leave the funds in their wallet, or if they want to adjust the amount of the payout."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A previously created payout can be canceled if it has not yet been paid out."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only payouts with a status of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FUNDS-IN-ESCROW"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FUNDS-IN-ESCROW-ON-HOLD"]}," may be canceled."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"to-cancel-a-payout-request","__idx":1},"children":["To cancel a payout request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Canceling payout requests requires an API token with the scope ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["write_process_credits"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"curl --location --request DELETE 'https://invoicing.tilia-inc.com/v2/<account_id>/payout/<payout_status_id>' \\\n--header 'Authorization: Bearer <Access_Token>' \\\n--header 'Content-Type: application/json' \\\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Although you are using the DELETE method, the payout record is not deleted. Instead, the record is updated to reflect that the request has been canceled. A success response includes the payout object with updated status information."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note that the payout status has been updated to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUPPORT-REJECT-TRANSFER-INITIATED"]},", and credit status is now ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCELED"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": \"Success\",\n  \"messages\": [],\n  \"codes\": [],\n  \"payload\": [\n\t\t{\n            \"payout_status_id\": \"5771d366-dcbb-4c22-9d60-ecdeacf0d6e4\",\n            \"credit_id\": \"71043c7f-c20c-4ddb-af56-5dde3959e63d\",\n            \"account_id\": \"682c8d3e-75ad-4d10-8b1a-1e15768e5d61\",\n            \"status\": \"SUPPORT-REJECT-TRANSFER-INITIATED\",\n            \"created\": \"2020-08-07 19:16:07.477643\",\n            \"updated\": \"2020-08-07 20:35:21.748722\",\n            \"credit\": {\n                \"destination_payment_method_id\": \"adaeca29-eda4-4bc0-87cc-1b7956420553\",\n                \"amount\": 50,\n                \"currency\": \"USD\",\n                \"status\": \"CANCELED\"\n            }\n        }\n\t] \n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Upon cancellation of the payout, funds are returned to the source payment method (e.g., USD wallet balance)."]}]},"headings":[{"value":"Canceling a Payout Request","id":"canceling-a-payout-request","depth":1},{"value":"To cancel a payout request","id":"to-cancel-a-payout-request","depth":4}],"frontmatter":{"seo":{"title":"Canceling a Payout Request"}},"lastModified":"2026-02-05T18:12:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/cancel-payout-request","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}