{"templateId":"markdown","versions":[{"version":"v1","label":"v1","link":"/api-reference/v1/components/docs/settlements","default":true,"active":false,"folderId":"1b9c9f54"},{"version":"v2","label":"v2 (Beta)","link":"/api-reference/v2/components/docs/settlements","default":false,"active":true,"folderId":"1b9c9f54"}],"sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Flute Developer","siteUrl":"https://developer.flute.com","description":"Documentation and API reference for integrating Flute payment processing.","lang":"en-US","llmstxt":{"hide":true,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"id":"settlements"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Settlement is the process of actually transferring funds between parties to finalize a transaction"," ","This is different from authorization, which just reserves or confirms funds are available."," ","That means funds are not instantly available for each transaction."," ","Merchants may see a delay between a sale and the funds deposited in their account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The typical lifecycle that includes settlement:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authorization"]},". An authorized transaction is one that has been approved and funds are held or reserved."," ","No money has moved yet.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","For example, the following call starts a transaction with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["captureMethod"]}," of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Auto"]},"."," ","This automatically adds the transaction in an open settlement batch when the transaction is completed."," ","The call returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionId"]},", which may be used to reference this transaction."]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Sample Authorization Call"]},{"$$mdtype":"Tag","name":"a","attributes":{"id":"sample-authorization-call"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"csharp","header":{"controls":{"copy":{}}},"source":"  POST /v2/transactions\n  Authorization: Bearer {{apiKey}}                                                                                          \n  Content-Type: application/json\n  {                                                                                                                         \n  \"baseAmount\": 150.00,                                                                                                 \n  \"currencyCode\": \"USD\",\n  \"customerInitiatedTransaction\": true,\n      \"transactionDetails\": \n      {\n          \"cardData\":\n          {\n              \"captureMethod\": \"Auto\",\n              \"paymentMethodDetails\":\n              {\n                \"cardNumber\": \"4111111111111111\",\n                \"securityCode\": \"737\",\n                \"expirationMonth\": 9,\n                \"expirationYear\": 2027\n                }\n            }\n        }\n    }\n","lang":"csharp"},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Capture or batch"]},". Approved transactions are grouped together, or batched, for later processing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["captureMethod"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Auto"]},", no additional processing is required at this step."," ","The transaction has been added to the settlement batch automatically."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["captureMethod"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Manual"]},", the transaction must be explicitly added to the settlement batch."," ","In this case use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/transactions/{{transactionId}}/capture"]}," to capture it to the settlement batch."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Care must be taken when using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Manual"]}," because if the transaction is never captured, the authorization simply expires and no funds move."]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Sample Capture Call"]},{"$$mdtype":"Tag","name":"a","attributes":{"id":"sample-capture-call"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Omit the body (or send {}) for a full capture. Once captured, it enters the open settlement batch."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"csharp","header":{"controls":{"copy":{}}},"source":"POST /v2/transactions/{{transactionId}}/capture\nAuthorization: Bearer {{apiKey}}\nContent-Type: application/json\n\n{\n  \"amount\": 150.00\n}\n","lang":"csharp"},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settlement"]},". Settlement is the step where an authorized transaction becomes a real transfer of money."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The batch is submitted to the card networks or banks."," ","This processing includes moving the money from the cardholder's bank, through the network, to the acquiring bank."," ","It eventually ends at merchant's account, minus fees."," ","Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/settlements/settle"]}," to initiate the settlement batch."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This batch processing usually happens on a schedule, such as daily batch settlement at the end of business."]}]},"headings":[],"frontmatter":{"seo":{"title":""}},"lastModified":"2026-07-08T15:40:38.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/v2/components/docs/settlements","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}