komoju-sdk 1.0.0.beta.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2cd7456a21b555caccf367a647cdf9322a3a8b2fd078c8ac11c45e06d59763d
-  data.tar.gz: 2588befd4f7f8fad97e8d96782dd2e3a497fdadba698009f57f4e282cd3a2a99
+  metadata.gz: cd73b163d2d1057a44eb39204ada1a03fa7492dcc654d3f4487fea041766ae83
+  data.tar.gz: be7878cec97d973f2196384a2c6830e919bf66fe37ded010fe6195367710cffb
 SHA512:
-  metadata.gz: 6071a3e74a088aa8c3a351786d8350327b4f56908282481fe8fddf91e6a572c4125bd8d9f631118f056ca9ab8ec46bfb3070352524d25a4bd73cb9e47f1447c4
-  data.tar.gz: 88ef61b12c0569a645324b4feb069024cd695707d9ae4c1adf2eca4af1ac55c60e73d1e0120cb8dcf9e9312fe03123308d3fa97e3aad7dc98d2539cd39496158
+  metadata.gz: 2cde3f3a46a2ac46192a6a6771242da338fb3bd56e9ee8b2e6f1be48e20d787755c99a253cda684cc7ee81fdae945c19f432d994455bb325d9845d59d73d1971
+  data.tar.gz: d0375e5fc6ca094f8b7a1061d6af07057d6f4fda979da47e8afdcb0e2632cec8cc39778b5bd28a5b39ed8602e41b77176a963a2b6344a9fe882f8a4a19e46c8f

data/CHANGELOG.md

@@ -2,6 +2,146 @@
 
 ## [Unreleased]
 
+## [1.0.0] - 2026-06-29
+
+Targets KOMOJU API version `2025-01-28`.
+
+### Changed
+
+- [`GET payments` endpoint] The response object for partially captured payments has been updated.
+
+  - **Return value changes**:
+    - `amount_refunded`: the refund amount for the difference between the authorized amount and captured amount is no longer included for partially captured payments.
+    - `refunds`: partially captured payments no longer show a refund for the difference between the authorized amount and captured amount.
+
+- [`POST payments` endpoint] The response object for partially captured payments has been updated.
+
+  - **Return value changes**:
+    - `amount_refunded`: the refund amount for the difference between the authorized amount and captured amount is no longer included for partially captured payments.
+    - `refunds`: a refund for the difference between the authorized amount and captured amount is not shown if the payment is a partially captured payment.
+
+- [`GET payments/:id` endpoint] The response object for a partially captured payment has been updated.
+
+  - **Return value changes**:
+    - `amount_refunded`: the refund amount for the difference between the authorized amount and captured amount is no longer included for partially captured payments.
+    - `refunds`: a refund for the difference between the authorized amount and captured amount is not shown if the payment is a partially captured payment.
+
+- [`PATCH payments/:id` endpoint] The response object for a partially captured payment has been updated.
+
+  - **Return value changes**:
+    - `amount_refunded`: the refund amount for the difference between the authorized amount and captured amount is no longer included for partially captured payments.
+    - `refunds`: a refund for the difference between the authorized amount and captured amount is not shown if the payment is a partially captured payment.
+
+- [`POST payments/:id/capture` endpoint] The response object for a partially captured payment has been updated.
+
+  - **Return value changes**:
+    - `amount_refunded`: the refund amount for the difference between the authorized amount and captured amount is no longer included for partially captured payments.
+    - `refunds`: a refund for the difference between the authorized amount and captured amount is not shown if the payment is a partially captured payment.
+
+- [`POST payments/:id/refund` endpoint] The response object for a partially captured payment has been updated.
+
+  - **Return value changes**:
+    - `amount_refunded`: the refund amount for the difference between the authorized amount and captured amount is no longer included for partially captured payments.
+    - `refunds`: a refund for the difference between the authorized amount and captured amount is not shown if the payment is a partially captured payment.
+
+- [`POST payments/:id/cancel` endpoint] The response object for a partially captured payment has been updated.
+
+  - **Return value changes**:
+    - `amount_refunded`: the refund amount for the difference between the authorized amount and captured amount is no longer included for partially captured payments.
+    - `refunds`: a refund for the difference between the authorized amount and captured amount is not shown if the payment is a partially captured payment.
+
+- [`POST payments/:id/finalize` endpoint] The response object for a partially captured payment has been updated.
+
+    - `amount_refunded`: the refund amount for the difference between the authorized amount and captured amount is no longer included for partially captured payments.
+    - `refunds`: a refund for the difference between the authorized amount and captured amount is not shown if the payment is a partially captured payment.
+
+- [`GET merchants/{merchant_id}/payments` endpoint] The response object for a partially captured payment has been updated.
+
+  - **Return value changes**:
+    - `amount_refunded`: the refund amount for the difference between the authorized amount and captured amount is no longer included for partially captured payments.
+    - `refunds`: partially captured payments no longer show a refund for the difference between the authorized amount and captured amount.
+
+- [`GET balances/:id` endpoint] Transformed the response to a nested (2D) structure to match the Merchant dashboard's Payout Balance page.
+
+  - **Renamed keys**: `balance_total` is now `total_balance_cents`.
+  - **Removed keys**: `payment_fee_total`, `tax_total`.
+  - **Structural changes**: Added new `payments`, `refunds`, `platform_model`, `corrections`, `komoju_card_charges` and `misc` sections.
+    - `payments`:
+      - Moved here: `payment_total` now called `captured_amount_total_cents`
+      - New keys: `processing_fees_cents`
+    - `refunds`:
+      - Moved here:
+        - `refund_total` now called `refunded_amount_total_cents`
+        - `refund_fee_total` now called `refund_processing_fees_cents` and includes tax
+        - `refunded_customer_fee_total` now called `refunded_customer_fees_cents` and includes tax
+    - `platform_model` (only available for Platform merchants):
+      - Moved here: `fund_transfer_total_cents`
+      - New keys: `payment_share_total_cents`, `payment_share_refund_total_cents`, `platform_fee_total_cents`, `platform_fee_refund_total_cents`, `submerchant_management_fees_cents`.
+    - `disbursements`:
+      - New keys: `disbursement_amount_total_cents`, `disbursement_fee_total_cents`
+    - `misc`:
+      - New keys: `clearing_total_cents`, `komoju_card_discount_total_cents`, `chargeback_fixed_fee_total_cents`, `other_fee_adjustments_total_cents` (this is the sum of all fee adjustments, any misc. record types that don't belong in other sections, and/or any new types of records that impact a merchant's balance. Refer to the API reference for the exhaustive list).
+    - For each section, added a `total_cents` of each of its amounts.
+
+- [`GET settlements` endpoint] Renamed one key name, added a number of new keys, and made changes to several returned values.
+
+  - **Renamed keys**:
+    - `amount` is now `settlement_amount_cents` in order to make the key more clear and less generic.
+  
+  - **Added keys**:
+    - NOTE: values for keys ending in `_cents` are returned as integers (not strings); any integers related to fees can be negative integers.
+    - `transaction_amount_cents`
+    - `fee_amount_cents`
+    - `fee_tax_amount_cents`
+    - `fx_currency`
+    - `fx_conversion_rate`
+    - `fx_conversion_amount_cents`
+    - `bank_transfer_fee_amount_cents`
+    - `remittance_amount_cents`
+
+  - **Return value changes**: 
+    - `status`: "automatic_pending" is now returned as "pending".
+    - `settlement_amount_cents` (formerly `amount`): the value of `settlement_amount_cents` is now returned as an integer rather than a string.
+    - `download`: all keys in this section (such as `csv` or `xls`) will show "null" instead of a link if the settlement is cancelled. If the settlement is not cancelled, all links will point to an updated version of the report.
+
+- [`GET settlements/:id` endpoint] Renamed two key names, added a number of new keys, made changes to several returned values, and transformed the response to a nested (2D) structure to include details for various kinds of payments and fees.
+
+  - **Renamed keys**:
+    - `amount` is now `settlement_amount_cents` in order to make the key more clear and less generic.
+
+  - **Removed keys**:
+    - `payment_total`
+    - `payment_fee_total`
+    - `refund_total`
+    - `refund_fee_total`
+    - `refunded_customer_fee_total`
+    - `correction_total`
+    - `tax_total`
+    - `balance_amount`
+  
+  - **Added keys**:
+    - NOTE: values for keys ending in `_cents` are returned as integers (not strings); any integers related to fees can be negative integers.
+    - `transaction_amount_cents`
+    - `fee_amount_cents`
+    - `fee_tax_amount_cents`
+    - `fx_currency`
+    - `fx_conversion_rate`
+    - `fx_conversion_amount_cents`
+    - `bank_transfer_fee_amount_cents`
+    - `remittance_amount_cents`
+    - `payments`, `refunds`, `platform_model`, `corrections`, `komoju_card_charges`, `disbursements`, `misc` sections (see `GET balances/:id` above for structure)
+
+  - **Return value changes**: 
+    - `download`: all keys in this section (such as `csv` or `xls`) will show "null" instead of a link if the settlement is cancelled. If the settlement is not cancelled, all links will point to an updated version of the report. Additionally, URLs for downloading settlement CSV and XLS files will point to a new version of the report.
+
+  - [`GET settlements/:id/csv` endpoint] Updated format of the report.
+
+  - [`GET settlements/:id/xls` endpoint] Updated format of the report.
+
+## [1.0.0.beta.2] - 2026-06-11
+
+No changes. Release to verify CI runner configuration.
+
 ## [1.0.0.beta.1] - 2026-05-25
 
 Targets KOMOJU API version `2025-01-28`.

data/README.md

@@ -1,13 +1,15 @@
 # komoju-sdk
 
-Ruby gem for the KOMOJU API — Full featured access to the KOMOJU payments system.
+The KOMOJU Ruby SDK is a full-featured gem for the KOMOJU Payments API. It works with any Ruby application or framework, including Rails.
+
+For a full reference of all available endpoints and models, see the [KOMOJU API Reference](https://doc.komoju.com/reference/getting-started).
 
 ## Installation
 
 Add to your Gemfile:
 
 ```ruby
-gem 'komoju-sdk', '~> 1.0.0.beta.1'
+gem 'komoju-sdk', '~> 1.0.0'
 ```
 
 Then run `bundle install`.
@@ -25,60 +27,61 @@ end
 
 Get your API keys from the [KOMOJU Merchant Settings](https://komoju.com/merchant/settings).
 
-### Accept a Payment
+## Example: Hosted Page Payment
+
+The following example walks through a basic hosted page payment flow. For a full guide, see the [Hosted Page Integration Guide](https://doc.komoju.com/docs/hosted-page-integration-guide).
+
+### 1. Creating a Session
 
-Charge a customer directly with their payment details:
+When your customer is ready to pay, create a session and redirect them to the returned `session_url`.
 
 ```ruby
-payments_api = Komoju::PaymentsApi.new
+sessions_api = Komoju::SessionsApi.new
 
-begin
-  payment = payments_api.create_payment(
-    Komoju::CreatePaymentRequestWithPaymentDetails.new(
-      amount: 1000,
-      currency: 'JPY',
-      payment_details: {
-        type: 'credit_card',
-        number: '4111111111111111',
-        month: 12,
-        year: 2025,
-        verification_value: '123'
-      }
-    )
+session = sessions_api.create_session(
+  Komoju::CreateSessionRequestWithPaymentMode.new(
+    mode: 'payment',
+    amount: 1000,
+    currency: 'JPY',
+    return_url: 'https://your-site.com/orders/return'
   )
-  puts "Payment created: #{payment.id} (#{payment.status})"
+)
 
-  # Capture an authorized payment
-  captured = payments_api.capture_payment(payment.id, Komoju::CapturePaymentRequest.new)
-  puts "Payment captured: #{captured.captured_at}"
-rescue Komoju::ApiError => e
-  puts "Error #{e.code}: #{e.message}"
-end
+redirect_to session.session_url, allow_other_host: true
 ```
 
-### Hosted Payment Page (Sessions)
+### 2. Handling the Return URL
+
+After the customer pays, KOMOJU redirects them back to your `return_url` with a `session_id` query param appended:
 
-Redirect customers to a KOMOJU-hosted checkout page:
+```
+https://your-site.com/orders/return?session_id=xxxxx
+```
+
+Fetch the session to check the outcome:
 
 ```ruby
 sessions_api = Komoju::SessionsApi.new
+komoju_session = sessions_api.show_session(params[:session_id])
 
-begin
-  session = sessions_api.create_session(
-    Komoju::CreateSessionRequestWithPaymentMode.new(
-      mode: 'payment',
-      amount: 5000,
-      currency: 'JPY',
-      return_url: 'https://example.com/thank-you',
-      default_locale: 'ja'
-    )
-  )
-  puts "Redirect customer to: #{session.session_url}"
-rescue Komoju::ApiError => e
-  puts "Error #{e.code}: #{e.message}"
+if komoju_session.status == Komoju::SessionStatus::COMPLETED
+  # payment.status will be "captured", "authorized", or "pending"
+  puts "Payment #{komoju_session.payment.status}"
+else
+  puts "Payment was cancelled or failed"
 end
 ```
 
+### 3. Set Up Webhooks (Recommended)
+
+It is possible that the redirect in step 2 fails, possibly due to the user closing their browser, network issues, etc. Or, that the capture will only take place later on, such as with Convenience Store payments. To account for this, we recommend setting up a [Webhook](https://doc.komoju.com/docs/webhooks) to listen for payment events such as `payment.captured`, `payment.authorized`, and `payment.cancelled`. Configure your webhook URL in the [KOMOJU Merchant Dashboard](https://komoju.com/merchant/settings).
+
+#### Verifying Webhook Signatures
+
+To ensure a webhook request genuinely came from KOMOJU, set a **secret token** when creating or updating the webhook. KOMOJU then signs every delivery with a SHA-256 HMAC of the raw request body in the `X-Komoju-Signature` header, which you can recompute and verify.
+
+See [Webhooks → Secret Token](https://doc.komoju.com/docs/webhooks#secret-token) for the full explanation and code examples.
+
 ## Error Handling
 
 All API errors raise `Komoju::ApiError`:
@@ -101,6 +104,10 @@ All URIs are relative to *https://komoju.com/api/v1*
 Class | Method | HTTP request | Description
 ------------ | ------------- | ------------- | -------------
 *Komoju::BarcodesApi* | [**show_barcode**](docs/BarcodesApi.md#show_barcode) | **GET** /barcodes/{payment_id} | Barcode: Show
+*Komoju::ChargebacksApi* | [**accept_chargeback_request**](docs/ChargebacksApi.md#accept_chargeback_request) | **POST** /chargeback_requests/{id}/accept | Chargeback: Accept
+*Komoju::ChargebacksApi* | [**defend_chargeback_request**](docs/ChargebacksApi.md#defend_chargeback_request) | **POST** /chargeback_requests/{id}/defend | Chargeback: Defend
+*Komoju::ChargebacksApi* | [**list_chargeback_requests**](docs/ChargebacksApi.md#list_chargeback_requests) | **GET** /chargeback_requests | Chargeback: List
+*Komoju::ChargebacksApi* | [**show_chargeback_request**](docs/ChargebacksApi.md#show_chargeback_request) | **GET** /chargeback_requests/{id} | Chargeback: Show
 *Komoju::DisbursementsApi* | [**cancel_disbursement**](docs/DisbursementsApi.md#cancel_disbursement) | **POST** /disbursements/{id}/cancel | Disbursement: Cancel
 *Komoju::DisbursementsApi* | [**create_disbursement**](docs/DisbursementsApi.md#create_disbursement) | **POST** /disbursements | Disbursement: Create
 *Komoju::DisbursementsApi* | [**disbursement_report**](docs/DisbursementsApi.md#disbursement_report) | **GET** /disbursements/report | Disbursement: Report
@@ -123,7 +130,7 @@ Class | Method | HTTP request | Description
 *Komoju::PlatformModelApi* | [**create_file**](docs/PlatformModelApi.md#create_file) | **POST** /merchants/{merchant_id}/files | File: Create
 *Komoju::PlatformModelApi* | [**create_merchant**](docs/PlatformModelApi.md#create_merchant) | **POST** /merchants | Merchant: Create
 *Komoju::PlatformModelApi* | [**create_merchant_balance_transfer**](docs/PlatformModelApi.md#create_merchant_balance_transfer) | **POST** /merchants/{merchant_id}/balances/{currency}/transfer | Balance: Transfer
-*Komoju::PlatformModelApi* | [**edit_merchant_balance_settings**](docs/PlatformModelApi.md#edit_merchant_balance_settings) | **PATCH** /merchants/{merchant_id}/balances/{currency}/settings | Balances: Edit Settings
+*Komoju::PlatformModelApi* | [**edit_merchant_balance_settings**](docs/PlatformModelApi.md#edit_merchant_balance_settings) | **PUT** /merchants/{merchant_id}/balances/{currency}/settings | Balances: Edit Settings
 *Komoju::PlatformModelApi* | [**list_live_application_payment_methods**](docs/PlatformModelApi.md#list_live_application_payment_methods) | **GET** /live_application/{merchant_id}/payment_methods | Live Application: Payment Methods
 *Komoju::PlatformModelApi* | [**list_merchants**](docs/PlatformModelApi.md#list_merchants) | **GET** /merchants | Merchant: List
 *Komoju::PlatformModelApi* | [**list_submerchant_payments**](docs/PlatformModelApi.md#list_submerchant_payments) | **GET** /merchants/{merchant_id}/payments | Payment: List for Merchant
@@ -151,7 +158,9 @@ Class | Method | HTTP request | Description
 *Komoju::SessionsApi* | [**create_session**](docs/SessionsApi.md#create_session) | **POST** /sessions | Session: Create
 *Komoju::SessionsApi* | [**pay_session**](docs/SessionsApi.md#pay_session) | **POST** /sessions/{id}/pay | Session: Pay
 *Komoju::SessionsApi* | [**show_session**](docs/SessionsApi.md#show_session) | **GET** /sessions/{id} | Session: Show
+*Komoju::SettlementsApi* | [**balance_transactions**](docs/SettlementsApi.md#balance_transactions) | **GET** /balances/{currency}/transactions | Balance: Transactions
 *Komoju::SettlementsApi* | [**list_settlements**](docs/SettlementsApi.md#list_settlements) | **GET** /settlements | Settlement: Index
+*Komoju::SettlementsApi* | [**show_balance**](docs/SettlementsApi.md#show_balance) | **GET** /balances/{currency} | Balance: Show
 *Komoju::SettlementsApi* | [**show_settlement**](docs/SettlementsApi.md#show_settlement) | **GET** /settlements/{id} | Settlement: Show
 *Komoju::SettlementsApi* | [**show_settlement_csv**](docs/SettlementsApi.md#show_settlement_csv) | **GET** /settlements/{id}/csv | Settlement: CSV
 *Komoju::SettlementsApi* | [**show_settlement_pdf**](docs/SettlementsApi.md#show_settlement_pdf) | **GET** /settlements/{id}/pdf | Settlement: PDF
@@ -186,7 +195,18 @@ Class | Method | HTTP request | Description
  - [Komoju::BarcodeReadyResponse](docs/BarcodeReadyResponse.md)
  - [Komoju::CancelDisbursementRequest](docs/CancelDisbursementRequest.md)
  - [Komoju::CapturePaymentRequest](docs/CapturePaymentRequest.md)
- - [Komoju::CapturePaymentRequestTax](docs/CapturePaymentRequestTax.md)
+ - [Komoju::ChargebackCustomer](docs/ChargebackCustomer.md)
+ - [Komoju::ChargebackDefense](docs/ChargebackDefense.md)
+ - [Komoju::ChargebackDefenseDocument](docs/ChargebackDefenseDocument.md)
+ - [Komoju::ChargebackDefenseRecipientInfo](docs/ChargebackDefenseRecipientInfo.md)
+ - [Komoju::ChargebackDefenseShippingInfo](docs/ChargebackDefenseShippingInfo.md)
+ - [Komoju::ChargebackPayment](docs/ChargebackPayment.md)
+ - [Komoju::ChargebackPaymentMethod](docs/ChargebackPaymentMethod.md)
+ - [Komoju::ChargebackRequestDetail](docs/ChargebackRequestDetail.md)
+ - [Komoju::ChargebackRequestList](docs/ChargebackRequestList.md)
+ - [Komoju::ChargebackRequestListItem](docs/ChargebackRequestListItem.md)
+ - [Komoju::ChargebackStatus](docs/ChargebackStatus.md)
+ - [Komoju::ChargebackTimelineEntry](docs/ChargebackTimelineEntry.md)
  - [Komoju::CountryCode](docs/CountryCode.md)
  - [Komoju::CreateCustomerRequest](docs/CreateCustomerRequest.md)
  - [Komoju::CreateDisbursementRequest](docs/CreateDisbursementRequest.md)
@@ -210,9 +230,12 @@ Class | Method | HTTP request | Description
  - [Komoju::Currency](docs/Currency.md)
  - [Komoju::Customer](docs/Customer.md)
  - [Komoju::CustomerList](docs/CustomerList.md)
- - [Komoju::CustomerMetadata](docs/CustomerMetadata.md)
  - [Komoju::CustomerSource](docs/CustomerSource.md)
- - [Komoju::DeleteExternalCustomerResponse](docs/DeleteExternalCustomerResponse.md)
+ - [Komoju::DefendChargebackDocument](docs/DefendChargebackDocument.md)
+ - [Komoju::DefendChargebackRecipientInfo](docs/DefendChargebackRecipientInfo.md)
+ - [Komoju::DefendChargebackRequestBody](docs/DefendChargebackRequestBody.md)
+ - [Komoju::DefendChargebackShippingInfo](docs/DefendChargebackShippingInfo.md)
+ - [Komoju::DeleteExternalCustomer200Response](docs/DeleteExternalCustomer200Response.md)
  - [Komoju::Disbursement](docs/Disbursement.md)
  - [Komoju::DisbursementList](docs/DisbursementList.md)
  - [Komoju::DisbursementStatus](docs/DisbursementStatus.md)
@@ -309,6 +332,9 @@ Class | Method | HTTP request | Description
  - [Komoju::PaymentDetailsWechatpay](docs/PaymentDetailsWechatpay.md)
  - [Komoju::PaymentList](docs/PaymentList.md)
  - [Komoju::PaymentMethod](docs/PaymentMethod.md)
+ - [Komoju::PaymentMethodApplication](docs/PaymentMethodApplication.md)
+ - [Komoju::PaymentMethodApplicationStatus](docs/PaymentMethodApplicationStatus.md)
+ - [Komoju::PaymentMethodApplicationWithSubmittedFields](docs/PaymentMethodApplicationWithSubmittedFields.md)
  - [Komoju::PaymentMethodBrands](docs/PaymentMethodBrands.md)
  - [Komoju::PaymentMethodInstallmentsInner](docs/PaymentMethodInstallmentsInner.md)
  - [Komoju::PaymentMethodStatus](docs/PaymentMethodStatus.md)
@@ -387,6 +413,7 @@ Class | Method | HTTP request | Description
  - [Komoju::ResponsePaymentDetailsWebMoney](docs/ResponsePaymentDetailsWebMoney.md)
  - [Komoju::ResponsePaymentDetailsWechatpay](docs/ResponsePaymentDetailsWechatpay.md)
  - [Komoju::SecureToken](docs/SecureToken.md)
+ - [Komoju::SecureTokenThreeDSecureAccount](docs/SecureTokenThreeDSecureAccount.md)
  - [Komoju::SerializedSubmerchant](docs/SerializedSubmerchant.md)
  - [Komoju::SerializedSubmerchantActivePaymentMethodsInner](docs/SerializedSubmerchantActivePaymentMethodsInner.md)
  - [Komoju::SerializedSubmerchantExpirySettingsInner](docs/SerializedSubmerchantExpirySettingsInner.md)
@@ -405,6 +432,7 @@ Class | Method | HTTP request | Description
  - [Komoju::SharedDetailsPayments](docs/SharedDetailsPayments.md)
  - [Komoju::SharedDetailsPlatformModel](docs/SharedDetailsPlatformModel.md)
  - [Komoju::SharedDetailsRefunds](docs/SharedDetailsRefunds.md)
+ - [Komoju::ShowBalance200Response](docs/ShowBalance200Response.md)
  - [Komoju::ShowBarcodeResponse](docs/ShowBarcodeResponse.md)
  - [Komoju::SimulateLiveApplicationPaymentMethodStatusRequest](docs/SimulateLiveApplicationPaymentMethodStatusRequest.md)
  - [Komoju::StatementDescriptor](docs/StatementDescriptor.md)

data/docs/BalanceTransactionList.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **resource** | **String** | Resource type name for this list, always \"balance_transaction_list\". |  |
+| **resource** | **String** | Resource type name for this list, always \"list\". |  |
 | **data** | [**Array<Transaction>**](Transaction.md) | Array of ledger transaction objects. |  |
 | **start_time** | **Time** | Start of the time range for records in this response. |  |
 | **end_time** | **Time** | End of the time range for records in this response. |  |

data/docs/BarcodesApi.md

@@ -23,11 +23,6 @@ Fetches the latest barcode for a konbini payment.  Barcodes can be displayed in
 ```ruby
 require 'time'
 require 'komoju-sdk'
-# setup authorization
-Komoju.configure do |config|
-  # Configure your KOMOJU API key
-  config.api_key = 'YOUR_API_KEY'
-end
 
 api_instance = Komoju::BarcodesApi.new
 payment_id = 'payment_id_example' # String | Payment unique identifier
@@ -71,7 +66,7 @@ end
 
 ### Authorization
 
-[api_key](../README.md#api_key)
+No authorization required
 
 ### HTTP request headers
 

data/docs/CapturePaymentRequest.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **amount** | **Integer** | The payment amount before tax, greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD). | [optional] |
-| **tax** | [**CapturePaymentRequestTax**](CapturePaymentRequestTax.md) |  | [optional] |
+| **tax** | [**CreatePaymentRequestWithPaymentDetailsTax**](CreatePaymentRequestWithPaymentDetailsTax.md) |  | [optional] |
 | **platform_details** | [**PlatformDetails**](PlatformDetails.md) |  | [optional] |
 
 ## Example

data/docs/ChargebackCustomer.md

@@ -0,0 +1,20 @@
+# Komoju::ChargebackCustomer
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | Customer's name, or null if not provided. |  |
+| **email** | **String** | Customer's email address, or null if not provided. |  |
+
+## Example
+
+```ruby
+require 'komoju-sdk'
+
+instance = Komoju::ChargebackCustomer.new(
+  name: null,
+  email: null
+)
+```
+

data/docs/ChargebackDefense.md

@@ -0,0 +1,26 @@
+# Komoju::ChargebackDefense
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **product_name** | **String** | Name of the product or service, or null if not provided. |  |
+| **reason** | **String** | The merchant's defense reason. |  |
+| **shipping_info** | [**ChargebackDefenseShippingInfo**](ChargebackDefenseShippingInfo.md) |  |  |
+| **recipient_info** | [**ChargebackDefenseRecipientInfo**](ChargebackDefenseRecipientInfo.md) |  |  |
+| **documents** | [**Array<ChargebackDefenseDocument>**](ChargebackDefenseDocument.md) | Supporting documents submitted with the defense. |  |
+
+## Example
+
+```ruby
+require 'komoju-sdk'
+
+instance = Komoju::ChargebackDefense.new(
+  product_name: null,
+  reason: null,
+  shipping_info: null,
+  recipient_info: null,
+  documents: null
+)
+```
+

data/docs/ChargebackDefenseDocument.md

@@ -0,0 +1,26 @@
+# Komoju::ChargebackDefenseDocument
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **file_name** | **String** | Stored file name. |  |
+| **content_type** | **String** | MIME type of the document. |  |
+| **file_size** | **Integer** | File size in bytes. |  |
+| **uploaded_at** | **Time** | When the document was uploaded. |  |
+| **url** | **String** | Temporary signed URL to download the document. |  |
+
+## Example
+
+```ruby
+require 'komoju-sdk'
+
+instance = Komoju::ChargebackDefenseDocument.new(
+  file_name: null,
+  content_type: null,
+  file_size: null,
+  uploaded_at: null,
+  url: null
+)
+```
+

data/docs/ChargebackDefenseRecipientInfo.md

@@ -0,0 +1,22 @@
+# Komoju::ChargebackDefenseRecipientInfo
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | Recipient's name, or null. |  |
+| **phone** | **String** | Recipient's phone number, or null. |  |
+| **email** | **String** | Recipient's email address, or null. |  |
+
+## Example
+
+```ruby
+require 'komoju-sdk'
+
+instance = Komoju::ChargebackDefenseRecipientInfo.new(
+  name: null,
+  phone: null,
+  email: null
+)
+```
+

data/docs/ChargebackDefenseShippingInfo.md

@@ -0,0 +1,24 @@
+# Komoju::ChargebackDefenseShippingInfo
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **company_name** | **String** | Shipping carrier company name, or null. |  |
+| **shipping_date** | **String** | Date the item was shipped (e.g. 2026-05-20), or null. |  |
+| **tracking_number** | **String** | Carrier tracking number, or null. |  |
+| **shipping_address** | **String** | Destination shipping address, or null. |  |
+
+## Example
+
+```ruby
+require 'komoju-sdk'
+
+instance = Komoju::ChargebackDefenseShippingInfo.new(
+  company_name: null,
+  shipping_date: null,
+  tracking_number: null,
+  shipping_address: null
+)
+```
+

data/docs/ChargebackPayment.md

@@ -0,0 +1,30 @@
+# Komoju::ChargebackPayment
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | A unique 25-character alphanumeric resource identifier. |  |
+| **amount** | **Integer** | Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD). |  |
+| **currency** | [**Currency**](Currency.md) |  |  |
+| **created_at** | **Time** | Timestamp when the payment was created. |  |
+| **captured_at** | **Time** | Timestamp when the payment was captured, or null. |  |
+| **payment_method** | [**ChargebackPaymentMethod**](ChargebackPaymentMethod.md) |  |  |
+| **masked_card_number** | **String** | Masked card number, or null if not applicable. |  |
+
+## Example
+
+```ruby
+require 'komoju-sdk'
+
+instance = Komoju::ChargebackPayment.new(
+  id: null,
+  amount: null,
+  currency: null,
+  created_at: null,
+  captured_at: null,
+  payment_method: null,
+  masked_card_number: null
+)
+```
+

data/docs/ChargebackPaymentMethod.md

@@ -0,0 +1,22 @@
+# Komoju::ChargebackPaymentMethod
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **type** | **String** | Payment method type slug (e.g. \"credit_card\"). |  |
+| **brand** | **String** | Card brand, or null if not applicable. |  |
+| **last_four_digits** | **String** | Last four digits of the card, or null if not applicable. |  |
+
+## Example
+
+```ruby
+require 'komoju-sdk'
+
+instance = Komoju::ChargebackPaymentMethod.new(
+  type: null,
+  brand: null,
+  last_four_digits: null
+)
+```
+

data/docs/ChargebackRequestDetail.md

@@ -0,0 +1,38 @@
+# Komoju::ChargebackRequestDetail
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | A unique 25-character alphanumeric resource identifier. |  |
+| **status** | [**ChargebackStatus**](ChargebackStatus.md) |  |  |
+| **reason_code** | **String** | Machine-readable reason code. Internal codes (e.g. \"CB_Fraud\") are used by default; for Worldpay Visa/Mastercard payments the network's own reason codes are used instead (e.g. \"10.4\" or \"4837\"). |  |
+| **reason** | **String** | Human-readable chargeback reason corresponding to the reason code. |  |
+| **created_at** | **Time** | Timestamp when the chargeback was created. |  |
+| **due_date** | **Time** | Deadline by which the merchant must respond. |  |
+| **last_updated_at** | **Time** | Timestamp when the chargeback was last updated. |  |
+| **timeline** | [**Array<ChargebackTimelineEntry>**](ChargebackTimelineEntry.md) | Chronological list of chargeback events. |  |
+| **payment** | [**ChargebackPayment**](ChargebackPayment.md) |  |  |
+| **customer** | [**ChargebackCustomer**](ChargebackCustomer.md) |  |  |
+| **defense** | [**ChargebackDefense**](ChargebackDefense.md) |  |  |
+
+## Example
+
+```ruby
+require 'komoju-sdk'
+
+instance = Komoju::ChargebackRequestDetail.new(
+  id: null,
+  status: null,
+  reason_code: CB_Fraud,
+  reason: null,
+  created_at: null,
+  due_date: null,
+  last_updated_at: null,
+  timeline: null,
+  payment: null,
+  customer: null,
+  defense: null
+)
+```
+

data/docs/ChargebackRequestList.md

@@ -0,0 +1,32 @@
+# Komoju::ChargebackRequestList
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **resource** | **String** | Resource type name, always \"list\". |  |
+| **data** | [**Array<ChargebackRequestListItem>**](ChargebackRequestListItem.md) | Array of chargeback request objects for this page. |  |
+| **start_time** | **Time** | Start of the time range for records in this response. |  |
+| **end_time** | **Time** | End of the time range for records in this response. |  |
+| **total** | **Integer** | Total number of records matching the query. |  |
+| **page** | **Integer** | Current page number. |  |
+| **per_page** | **Integer** | Number of results per page. |  |
+| **last_page** | **Integer** | Last available page number. |  |
+
+## Example
+
+```ruby
+require 'komoju-sdk'
+
+instance = Komoju::ChargebackRequestList.new(
+  resource: null,
+  data: null,
+  start_time: null,
+  end_time: null,
+  total: null,
+  page: null,
+  per_page: null,
+  last_page: null
+)
+```
+