Release 0.0.321

Author: fern-api[bot]

.fern/metadata.json

@@ -7,6 +7,6 @@
     "package-prefix": "io.github.payabli.api",
     "enable-wire-tests": false
   },
-  "originGitCommit": "6415b5451c2da0d2c1cef85dc4081265a866360c",
-  "sdkVersion": "0.0.320"
+  "originGitCommit": "0e827e26830578592f2b9d144d73fc76ecc31b49",
+  "sdkVersion": "0.0.321"
 }

README.md

@@ -315,7 +315,7 @@ Add the dependency in your `pom.xml` file:
 <dependency>
   <groupId>io.github.payabli</groupId>
   <artifactId>sdk-java</artifactId>
-  <version>0.0.320</version>
+  <version>0.0.321</version>
 </dependency>
 ```
 

build.gradle

@@ -47,7 +47,7 @@ java {
 
 group = 'io.github.payabli'
 
-version = '0.0.320'
+version = '0.0.321'
 
 jar {
     dependsOn(":generatePomFileForMavenPublication")
@@ -78,7 +78,7 @@ publishing {
         maven(MavenPublication) {
             groupId = 'io.github.payabli'
             artifactId = 'sdk-java'
-            version = '0.0.320'
+            version = '0.0.321'
             from components.java
             pom {
                 name = 'Payabli Docs Team'

reference.md

@@ -11548,7 +11548,7 @@ client.moneyIn().voidv2("10-3ffa27df-b171-44e0-b251-e95fbfc7a723");
 <dl>
 <dd>
 
-Authorizes transaction for payout. Authorized transactions aren't flagged for settlement until captured. Use `referenceId` returned in the response to capture the transaction. 
+Authorizes transaction for payout.  If you don't pass the `autoCapture` field with a value of `true`, authorized transactions aren't flagged for settlement until captured.  Use `referenceId` returned in the response to capture the transaction. 
 </dd>
 </dl>
 </dd>
@@ -11598,6 +11598,7 @@ client.moneyOut().authorizeOut(
                             .build()
                     )
                 )
+                .autoCapture(true)
                 .build()
         )
         .build()
@@ -11905,7 +11906,7 @@ client.moneyOut().captureAllOut(
 <dl>
 <dd>
 
-Captures a single authorized payout transaction by ID.
+Captures a single authorized payout transaction by ID. If the transaction was authorized with `autoCapture` set to `true`,  you don't need to call this endpoint to capture the transaction for processing.
 </dd>
 </dl>
 </dd>
@@ -24897,7 +24898,7 @@ client.vendor().editVendor(
 <dl>
 <dd>
 
-Retrieves a vendor's details.
+Retrieves a vendor's details, including enrichment status and payment acceptance info when available.
 </dd>
 </dl>
 </dd>
@@ -24935,6 +24936,89 @@ client.vendor().getVendor(1);
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.vendor.enrichVendor(entry, request) -> VendorEnrichResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Triggers AI-powered vendor enrichment for an existing vendor. Runs one or more enrichment stages (invoice scan, web search) based on the `scope` parameter. Can automatically apply extracted payment acceptance info and vendor contact information to the vendor record, or return raw results for manual review. Contact Payabli to enable this feature.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```java
+client.vendor().enrichVendor(
+    "8cfec329267",
+    VendorEnrichRequest
+        .builder()
+        .vendorId(3890L)
+        .scope(
+            Optional.of(
+                Arrays.asList("invoice_scan")
+            )
+        )
+        .applyEnrichmentData(false)
+        .invoiceFile(
+            FileContent
+                .builder()
+                .fContent("<base64-encoded-pdf>")
+                .filename("invoice-2026-001.pdf")
+                .ftype(FileContentFtype.PDF)
+                .build()
+        )
+        .fallbackMethod("check")
+        .build()
+);
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**entry:** `String` — Entrypoint identifier.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `VendorEnrichRequest` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>

src/main/java/io/github/payabli/api/core/ClientOptions.java

@@ -38,10 +38,10 @@ private ClientOptions(
         this.headers.putAll(headers);
         this.headers.putAll(new HashMap<String, String>() {
             {
-                put("User-Agent", "io.github.payabli:sdk-java/0.0.320");
+                put("User-Agent", "io.github.payabli:sdk-java/0.0.321");
                 put("X-Fern-Language", "JAVA");
                 put("X-Fern-SDK-Name", "com.payabli.fern:api-sdk");
-                put("X-Fern-SDK-Version", "0.0.320");
+                put("X-Fern-SDK-Version", "0.0.321");
             }
         });
         this.headerSuppliers = headerSuppliers;

src/main/java/io/github/payabli/api/resources/bill/types/BillOutData.java

@@ -129,6 +129,7 @@ public Optional<String> getAdditionalData() {
 
     /**
      * @return An array of bill images. Attachments aren't required, but we strongly recommend including them. Including a bill image can make payouts smoother and prevent delays. You can include either the Base64-encoded file content, or you can include an fURL to a public file. The maximum file size for image uploads is 30 MB.
+     * <p>When vendor enrichment is enabled and the first attachment is a PDF, the invoice is scanned and extracted vendor contact information and bill details (invoice number, amount due, due date) are merged into the request. Fields in the request body take precedence over extracted data. If the scan fails, bill creation proceeds with the original request data. See the <a href="/guides/pay-out-vendor-enrichment-overview">vendor enrichment guide</a> for details. Contact Payabli to enable this feature.</p>
      */
     @JsonProperty("attachments")
     public Optional<List<FileContent>> getAttachments() {
@@ -425,6 +426,7 @@ public Builder additionalData(String additionalData) {
 
         /**
          * <p>An array of bill images. Attachments aren't required, but we strongly recommend including them. Including a bill image can make payouts smoother and prevent delays. You can include either the Base64-encoded file content, or you can include an fURL to a public file. The maximum file size for image uploads is 30 MB.</p>
+         * <p>When vendor enrichment is enabled and the first attachment is a PDF, the invoice is scanned and extracted vendor contact information and bill details (invoice number, amount due, due date) are merged into the request. Fields in the request body take precedence over extracted data. If the scan fails, bill creation proceeds with the original request data. See the <a href="/guides/pay-out-vendor-enrichment-overview">vendor enrichment guide</a> for details. Contact Payabli to enable this feature.</p>
          */
         @JsonSetter(value = "attachments", nulls = Nulls.SKIP)
         public Builder attachments(Optional<List<FileContent>> attachments) {

src/main/java/io/github/payabli/api/resources/moneyout/AsyncMoneyOutClient.java

@@ -41,29 +41,29 @@ public AsyncRawMoneyOutClient withRawResponse() {
     }
 
     /**
-     * Authorizes transaction for payout. Authorized transactions aren't flagged for settlement until captured. Use <code>referenceId</code> returned in the response to capture the transaction.
+     * Authorizes transaction for payout.  If you don't pass the <code>autoCapture</code> field with a value of <code>true</code>, authorized transactions aren't flagged for settlement until captured.  Use <code>referenceId</code> returned in the response to capture the transaction.
      */
     public CompletableFuture<AuthCapturePayoutResponse> authorizeOut(AuthorizePayoutBody body) {
         return this.rawClient.authorizeOut(body).thenApply(response -> response.body());
     }
 
     /**
-     * Authorizes transaction for payout. Authorized transactions aren't flagged for settlement until captured. Use <code>referenceId</code> returned in the response to capture the transaction.
+     * Authorizes transaction for payout.  If you don't pass the <code>autoCapture</code> field with a value of <code>true</code>, authorized transactions aren't flagged for settlement until captured.  Use <code>referenceId</code> returned in the response to capture the transaction.
      */
     public CompletableFuture<AuthCapturePayoutResponse> authorizeOut(
             AuthorizePayoutBody body, RequestOptions requestOptions) {
         return this.rawClient.authorizeOut(body, requestOptions).thenApply(response -> response.body());
     }
 
     /**
-     * Authorizes transaction for payout. Authorized transactions aren't flagged for settlement until captured. Use <code>referenceId</code> returned in the response to capture the transaction.
+     * Authorizes transaction for payout.  If you don't pass the <code>autoCapture</code> field with a value of <code>true</code>, authorized transactions aren't flagged for settlement until captured.  Use <code>referenceId</code> returned in the response to capture the transaction.
      */
     public CompletableFuture<AuthCapturePayoutResponse> authorizeOut(MoneyOutTypesRequestOutAuthorize request) {
         return this.rawClient.authorizeOut(request).thenApply(response -> response.body());
     }
 
     /**
-     * Authorizes transaction for payout. Authorized transactions aren't flagged for settlement until captured. Use <code>referenceId</code> returned in the response to capture the transaction.
+     * Authorizes transaction for payout.  If you don't pass the <code>autoCapture</code> field with a value of <code>true</code>, authorized transactions aren't flagged for settlement until captured.  Use <code>referenceId</code> returned in the response to capture the transaction.
      */
     public CompletableFuture<AuthCapturePayoutResponse> authorizeOut(
             MoneyOutTypesRequestOutAuthorize request, RequestOptions requestOptions) {
@@ -143,28 +143,28 @@ public CompletableFuture<CaptureAllOutResponse> captureAllOut(
     }
 
     /**
-     * Captures a single authorized payout transaction by ID.
+     * Captures a single authorized payout transaction by ID. If the transaction was authorized with <code>autoCapture</code> set to <code>true</code>,  you don't need to call this endpoint to capture the transaction for processing.
      */
     public CompletableFuture<AuthCapturePayoutResponse> captureOut(String referenceId) {
         return this.rawClient.captureOut(referenceId).thenApply(response -> response.body());
     }
 
     /**
-     * Captures a single authorized payout transaction by ID.
+     * Captures a single authorized payout transaction by ID. If the transaction was authorized with <code>autoCapture</code> set to <code>true</code>,  you don't need to call this endpoint to capture the transaction for processing.
      */
     public CompletableFuture<AuthCapturePayoutResponse> captureOut(String referenceId, RequestOptions requestOptions) {
         return this.rawClient.captureOut(referenceId, requestOptions).thenApply(response -> response.body());
     }
 
     /**
-     * Captures a single authorized payout transaction by ID.
+     * Captures a single authorized payout transaction by ID. If the transaction was authorized with <code>autoCapture</code> set to <code>true</code>,  you don't need to call this endpoint to capture the transaction for processing.
      */
     public CompletableFuture<AuthCapturePayoutResponse> captureOut(String referenceId, CaptureOutRequest request) {
         return this.rawClient.captureOut(referenceId, request).thenApply(response -> response.body());
     }
 
     /**
-     * Captures a single authorized payout transaction by ID.
+     * Captures a single authorized payout transaction by ID. If the transaction was authorized with <code>autoCapture</code> set to <code>true</code>,  you don't need to call this endpoint to capture the transaction for processing.
      */
     public CompletableFuture<AuthCapturePayoutResponse> captureOut(
             String referenceId, CaptureOutRequest request, RequestOptions requestOptions) {

src/main/java/io/github/payabli/api/resources/moneyout/AsyncRawMoneyOutClient.java

@@ -56,15 +56,15 @@ public AsyncRawMoneyOutClient(ClientOptions clientOptions) {
     }
 
     /**
-     * Authorizes transaction for payout. Authorized transactions aren't flagged for settlement until captured. Use <code>referenceId</code> returned in the response to capture the transaction.
+     * Authorizes transaction for payout.  If you don't pass the <code>autoCapture</code> field with a value of <code>true</code>, authorized transactions aren't flagged for settlement until captured.  Use <code>referenceId</code> returned in the response to capture the transaction.
      */
     public CompletableFuture<PayabliApiHttpResponse<AuthCapturePayoutResponse>> authorizeOut(AuthorizePayoutBody body) {
         return authorizeOut(
                 MoneyOutTypesRequestOutAuthorize.builder().body(body).build());
     }
 
     /**
-     * Authorizes transaction for payout. Authorized transactions aren't flagged for settlement until captured. Use <code>referenceId</code> returned in the response to capture the transaction.
+     * Authorizes transaction for payout.  If you don't pass the <code>autoCapture</code> field with a value of <code>true</code>, authorized transactions aren't flagged for settlement until captured.  Use <code>referenceId</code> returned in the response to capture the transaction.
      */
     public CompletableFuture<PayabliApiHttpResponse<AuthCapturePayoutResponse>> authorizeOut(
             AuthorizePayoutBody body, RequestOptions requestOptions) {
@@ -73,15 +73,15 @@ public CompletableFuture<PayabliApiHttpResponse<AuthCapturePayoutResponse>> auth
     }
 
     /**
-     * Authorizes transaction for payout. Authorized transactions aren't flagged for settlement until captured. Use <code>referenceId</code> returned in the response to capture the transaction.
+     * Authorizes transaction for payout.  If you don't pass the <code>autoCapture</code> field with a value of <code>true</code>, authorized transactions aren't flagged for settlement until captured.  Use <code>referenceId</code> returned in the response to capture the transaction.
      */
     public CompletableFuture<PayabliApiHttpResponse<AuthCapturePayoutResponse>> authorizeOut(
             MoneyOutTypesRequestOutAuthorize request) {
         return authorizeOut(request, null);
     }
 
     /**
-     * Authorizes transaction for payout. Authorized transactions aren't flagged for settlement until captured. Use <code>referenceId</code> returned in the response to capture the transaction.
+     * Authorizes transaction for payout.  If you don't pass the <code>autoCapture</code> field with a value of <code>true</code>, authorized transactions aren't flagged for settlement until captured.  Use <code>referenceId</code> returned in the response to capture the transaction.
      */
     public CompletableFuture<PayabliApiHttpResponse<AuthCapturePayoutResponse>> authorizeOut(
             MoneyOutTypesRequestOutAuthorize request, RequestOptions requestOptions) {
@@ -573,30 +573,30 @@ public void onFailure(@NotNull Call call, @NotNull IOException e) {
     }
 
     /**
-     * Captures a single authorized payout transaction by ID.
+     * Captures a single authorized payout transaction by ID. If the transaction was authorized with <code>autoCapture</code> set to <code>true</code>,  you don't need to call this endpoint to capture the transaction for processing.
      */
     public CompletableFuture<PayabliApiHttpResponse<AuthCapturePayoutResponse>> captureOut(String referenceId) {
         return captureOut(referenceId, CaptureOutRequest.builder().build());
     }
 
     /**
-     * Captures a single authorized payout transaction by ID.
+     * Captures a single authorized payout transaction by ID. If the transaction was authorized with <code>autoCapture</code> set to <code>true</code>,  you don't need to call this endpoint to capture the transaction for processing.
      */
     public CompletableFuture<PayabliApiHttpResponse<AuthCapturePayoutResponse>> captureOut(
             String referenceId, RequestOptions requestOptions) {
         return captureOut(referenceId, CaptureOutRequest.builder().build(), requestOptions);
     }
 
     /**
-     * Captures a single authorized payout transaction by ID.
+     * Captures a single authorized payout transaction by ID. If the transaction was authorized with <code>autoCapture</code> set to <code>true</code>,  you don't need to call this endpoint to capture the transaction for processing.
      */
     public CompletableFuture<PayabliApiHttpResponse<AuthCapturePayoutResponse>> captureOut(
             String referenceId, CaptureOutRequest request) {
         return captureOut(referenceId, request, null);
     }
 
     /**
-     * Captures a single authorized payout transaction by ID.
+     * Captures a single authorized payout transaction by ID. If the transaction was authorized with <code>autoCapture</code> set to <code>true</code>,  you don't need to call this endpoint to capture the transaction for processing.
      */
     public CompletableFuture<PayabliApiHttpResponse<AuthCapturePayoutResponse>> captureOut(
             String referenceId, CaptureOutRequest request, RequestOptions requestOptions) {