{"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":"Reefpay Docs","description":"Reefpay 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\": \"BATCH-01KEW32V6YNV11T33XGDR7TGWC\",\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  \"currency\": \"USD\",\n  \"payment_method\": {\n    \"type\": \"ACH\",\n    \"standard_entry_class\": \"CCD\",\n    \"account_type\": \"CHECKING\",\n    \"route_number_truncated\": \"****21\",\n    \"account_number_truncated\": \"****9012\",\n    \"payment_token\": \"PAYMENT_TOKEN-01KFDKXMQ637ETEAY410MSQTUH\",\n    \"first_name\": \"Dana\",\n    \"last_name\": \"Reyes\",\n    \"description\": \"Vendor payment\"\n  },\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}"}]},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response reports the bank account with its identifiers truncated. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batch_id"]}," ","is assigned, so the payout leaves at the next batch close."]},{"$$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-09-17T12:21:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/payments/send-a-payout","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}