{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml","api-docs-apis/openapi.yaml":"api-docs-apis/openapi.yaml"},"props":{"metadata":{"markdoc":{"tagList":["replay-openapi","openapi-response-sample"]},"type":"markdown"},"seo":{"title":"ParadisePay Docs","description":"ParadisePay is the groundbreaking payment gateway that lets you integrate with the future of payments."},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"send-a-payout","__idx":0},"children":["Send a payout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A payout is an ACH credit: money moves from the merchant to a bank account. It is the opposite direction from everything else in this section."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach for it when you owe someone money that is not tied to a specific earlier transaction — paying a seller on a marketplace, settling a vendor invoice, disbursing a claim. When you are returning money from a transaction you already took, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/after-the-payment/cancel-void-and-refund"},"children":["refund it"]}," instead, so the two records stay linked."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":1},"children":["Before you start"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Api-Key"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Client-Id"]}," — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/get-started/authentication"},"children":["Authentication"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A processor integration configured for ACH"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The recipient's routing and account numbers"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"send-the-payout","__idx":2},"children":["Send the payout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/transactions"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT"]},"."]},{"$$mdtype":"Tag","name":"ReplayOpenApi","attributes":{"descriptionFile":"api-docs-apis/openapi.yaml","operationId":"createTransaction","exampleKey":"payout","parameters":{},"options":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request shape is the same as an ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/accept-an-ach-payment"},"children":["ACH debit"]}," — same required fields, same SEC codes, same 30-character ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}," of which only the first 10 reach the statement. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Change ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SALE"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT"]}," and the direction reverses."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CCD"]}," is the SEC code for a business-to-business payment, which most payouts are. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PPD"]}," when you are paying an individual."]},{"$$mdtype":"Tag","name":"OpenApiResponseSample","attributes":{"descriptionFile":"api-docs-apis/openapi.yaml","operationId":"createTransaction","exampleKey":"payout","responseSamplesResolved":[{"lang":"json","title":"200 application/json","source":"{\n  \"id\": \"TRANSACTION-01KEW3J7NRW9T4M2QVBXK8HZD3\",\n  \"reference_transaction_id\": null,\n  \"type\": \"PAYOUT\",\n  \"result\": \"APPROVED\",\n  \"client_id\": \"CLIENT-01KFDKXMQ637EKEAY410MSQSXB\",\n  \"client_dba\": \"Acme Jewelry\",\n  \"integrations\": [\n    \"VERICHECK\"\n  ],\n  \"response_code\": \"00\",\n  \"response_description\": \"Approved\",\n  \"batch_id\": null,\n  \"is_settled\": false,\n  \"is_returned\": false,\n  \"returned_at\": null,\n  \"time_created\": \"2026-07-15T17:31:44Z\",\n  \"amount\": 25000,\n  \"tip\": 0,\n  \"tax_amount\": 1250,\n  \"currency\": \"USD\",\n  \"payment_method\": {\n    \"type\": \"ACH\",\n    \"standard_entry_class\": \"CCD\",\n    \"account_type\": \"CHECKING\",\n    \"route_number_truncated\": \"0021\",\n    \"account_number_truncated\": \"9012\",\n    \"payment_token\": \"BANK_TOKEN-01KFDKXMQ637ETEAY410MSQTUH\",\n    \"first_name\": \"Dana\",\n    \"last_name\": \"Reyes\",\n    \"description\": \"Vendor payment\"\n  },\n  \"recurring\": false,\n  \"metadata\": {\n    \"invoice_id\": \"INV-2291\",\n    \"sales_channel\": \"api\"\n  }\n}"},{"lang":"json","title":"400 application/json","source":"{\n  \"error_code\": \"INVALID_REQUEST_DATA\",\n  \"error_message\": \"The API request contains invalid data.\",\n  \"details\": {\n    \"amount\": \"Invalid amount\",\n    \"payment_method.pan\": \"Malformed PAN\"\n  },\n  \"source\": {\n    \"system\": \"TSYS\",\n    \"code\": \"13\",\n    \"message\": \"Invalid amount\"\n  }\n}"},{"lang":"json","title":"401 application/json","source":"{\n  \"error_code\": \"NOT_AUTHENTICATED\",\n  \"error_message\": \"Access credentials missing or invalid.\",\n  \"details\": null,\n  \"source\": {\n    \"system\": null,\n    \"code\": null,\n    \"message\": null\n  }\n}"},{"lang":"json","title":"403 application/json","source":"{\n  \"error_code\": \"UNAUTHORIZED_ACTION\",\n  \"error_message\": \"Requested action is unavailable or forbidden.\",\n  \"details\": null,\n  \"source\": {\n    \"system\": null,\n    \"code\": null,\n    \"message\": null\n  }\n}"},{"lang":"json","title":"409 application/json","source":"{\n  \"error_code\": \"DUPLICATE_ACTION\",\n  \"error_message\": \"Duplicate action requested.\",\n  \"details\": null,\n  \"source\": {\n    \"system\": \"TSYS\",\n    \"code\": \"12\",\n    \"message\": \"Invalid transaction\"\n  }\n}"},{"lang":"json","title":"500 application/json","source":"{\n  \"error_code\": \"SYSTEM_ERROR\",\n  \"error_message\": \"Internal system error.\",\n  \"details\": null,\n  \"source\": {\n    \"system\": \"TSYS\",\n    \"code\": \"96\",\n    \"message\": \"System malfunction\"\n  }\n}"},{"lang":"json","title":"502 application/json","source":"{\n  \"error_code\": \"DOWNSTREAM_ERROR\",\n  \"error_message\": \"Downstream service returned invalid or unexpected response.\",\n  \"details\": null,\n  \"source\": {\n    \"system\": \"VERICHECK\",\n    \"code\": \"502\",\n    \"message\": \"Bad Gateway\"\n  }\n}"},{"lang":"json","title":"503 application/json","source":"{\n  \"error_code\": \"string\",\n  \"error_message\": \"string\",\n  \"details\": {\n    \"property1\": \"string\",\n    \"property2\": \"string\"\n  },\n  \"source\": {\n    \"system\": \"TSYS\",\n    \"code\": \"51\",\n    \"message\": \"Insufficient funds\"\n  }\n}"}]},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response reports the bank account with the routing and account numbers cut to their last four digits. The payout joins the open batch and leaves at the next batch close, so ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batch_id"]}," stays null until then."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payouts-are-ach-only","__idx":3},"children":["Payouts are ACH only"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT"]}," works with a bank account. It does ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," work with a card: the gateway does not support pushing funds to a card, and a payout with a card payment method returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVALID_ACTION"]}," and the message \"Payment method not supported for this transaction type\"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Payment method"},"children":["Payment method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"SALE"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SALE"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"AUTH"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTH"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"PAYOUT"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYOUT"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bank account"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whatever the instrument behind it supports"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payouts-can-be-returned-too","__idx":4},"children":["Payouts can be returned too"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A payout carries the same return risk as a debit, for the same reasons: a wrong account number, a closed account, a name mismatch at the receiving bank."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Watch ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_returned"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returned_at"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_code"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_reason"]}," exactly as you would on a debit. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_code"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_reason"]}," are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["omitted rather than null"]}," when there has been no return."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Because a payout sends money you may not get back, verify the destination before sending. A returned payout arrives days later, and by then the recipient may have told you the money never came."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":5},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/payments/accept-an-ach-payment"},"children":["Accept an ACH payment"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/ach-and-nacha"},"children":["ACH and NACHA basics"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/after-the-payment/find-and-report-on-transactions"},"children":["Find and report on transactions"]}]}]}]},"headings":[{"value":"Send a payout","id":"send-a-payout","depth":1},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"Send the payout","id":"send-the-payout","depth":2},{"value":"Payouts are ACH only","id":"payouts-are-ach-only","depth":2},{"value":"Payouts can be returned too","id":"payouts-can-be-returned-too","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Send a payout","shortTitle":"Payout","intro":"Push funds out to a bank account — a refund outside the original transaction, a vendor payment, a marketplace disbursement.","type":"how-to","seo":{"title":""}},"lastModified":"2026-10-23T00:08:41.656Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/payments/send-a-payout","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}