{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars/sdk_sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["code-group"]},"type":"markdown"},"seo":{"title":"Incrementally authorizing a transaction","description":"The specifications of Ratepay's APIs for easy payment transactions.","siteUrl":"https://docs.ratepay.com","keywords":"Ratepay developer portal, Ratepay api portal, Ratepay api reference docs","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":"incrementally-authorizing-a-transaction","__idx":0},"children":["Incrementally authorizing a transaction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Incremental authorization increases the authorized amount of an existing transaction that has not been fully captured, such as when a buyer adds an item to an order before shipment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ratepayTransactionId"]}," returned by the original authorization to identify the transaction."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Unlike the initial authorization, an incremental authorization does not require a shopping basket. You can submit an amount increase without providing item details. If included, items are specified directly in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IncrementalAuthorizationRequest"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example increases the authorized amount by €25.00 without specifying additional items."]},{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"tabs"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"java","data-title":"Java","header":{"title":"Java","controls":{"copy":{}}},"source":"import com.ratepay.sdk.IncrementalAuthorizeOutcome;\nimport com.ratepay.sdk.model.api.payment.IncrementalAuthorizationRequest;\nimport java.math.BigDecimal;\n\nIncrementalAuthorizationRequest request = new IncrementalAuthorizationRequest(\n    new BigDecimal(\"25.00\"), // grossAmount to add\n    null, // items\n    null, // partnerOperationId\n    null, // partnerShopId, required only for marketplace (multi-shop) transactions\n    null, // specialItems\n    null  // vats\n);\n\nIncrementalAuthorizeOutcome outcome = client.incrementalAuthorize(ratepayTransactionId, request, null);\n\nif (outcome.kind() == IncrementalAuthorizeOutcome.Kind.ACCEPTED) {\n    var accepted = (IncrementalAuthorizeOutcome.Accepted) outcome;\n    System.out.println(\"Increased by \" + accepted.getRatepayAuthorizationId());\n} else {\n    var declined = (IncrementalAuthorizeOutcome.Declined) outcome;\n    System.out.println(\"Increase declined: \" + declined.getDecline().getCategory());\n}\n","lang":"java"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"kotlin","data-title":"Kotlin","header":{"title":"Kotlin","controls":{"copy":{}}},"source":"import com.ratepay.sdk.IncrementalAuthorizeOutcome\nimport com.ratepay.sdk.model.api.payment.IncrementalAuthorizationRequest\nimport java.math.BigDecimal\n\nval request = IncrementalAuthorizationRequest(grossAmount = BigDecimal(\"25.00\"))\n\nwhen (val outcome = client.incrementalAuthorize(ratepayTransactionId, request)) {\n    is IncrementalAuthorizeOutcome.Accepted -> println(\"Increased: ${outcome.ratepayAuthorizationId}\")\n    is IncrementalAuthorizeOutcome.Declined -> println(\"Increase declined: ${outcome.decline.category}\")\n}\n","lang":"kotlin"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"exceptions","__idx":1},"children":["Exceptions"]},{"$$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":"Exception"},"children":["Exception"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HTTP Status Code"},"children":["HTTP Status Code"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RatepayAuthException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401/403"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RatepayValidationException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RatepayTransactionNotFoundException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RatepayLegalException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["451"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RatepayNetworkException"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5xx/transport"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next","__idx":2},"children":["Next"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/developer/sdk/guides/capturing-a-transaction"},"children":["Capturing the increased amount"]}]}]}]},"headings":[{"value":"Incrementally authorizing a transaction","id":"incrementally-authorizing-a-transaction","depth":1},{"value":"Exceptions","id":"exceptions","depth":2},{"value":"Next","id":"next","depth":2}],"frontmatter":{"seo":{"title":"Incrementally authorizing a transaction"}},"lastModified":"2026-11-04T10:26:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/developer/sdk/guides/incremental-authorization","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}