pcp-server-ruby-sdk 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9011779d863cca1afbb5b48b20ee1a0d9cce4c7228c833c1f7c807b5ed3d253e
-  data.tar.gz: 960ceb006b8d16e39c1a965077229e77e34de6d2cb51536d6a4f2c615e62e97e
+  metadata.gz: 482f280c7f678eb053e4b60b6b598efd83f822598825c40b036fda794d8ea931
+  data.tar.gz: ee91952a8e82ca06fb099357ff371e074158db1818cd7edabf63c6c8d303e468
 SHA512:
-  metadata.gz: 034a04e6f67e0101e619b47c64a44d59c66ec2f5131fc9d8f750f015889e41c314fc8240d3b4c4188db465b890829a8e954bac157580913b2ac98a1f19b5a989
-  data.tar.gz: 766af39044c63bcb9fccbb7ae346144428e42df2f17f87cade440e73f2496db3b3132c06fd774fcbb258b61267b6dc6ddb0ae309be44adb4eb025bbaa3a7f37e
+  metadata.gz: 1fec4a3be2887f4ae41bdb3f4c77e4cf88b0ea65d4deb62f2275f8df12c194997cfe18fa8b8754c58d309d5b48afc22e82372d4d3a2f892c4f85e0946aa5ffe2
+  data.tar.gz: f9689ef5abca20c6c4fb2029abf485f2f45ee7b6557ae6f84637539b0ed37b432b958e29c4f661a5babd64e0810b93f3ecee81a2a8113535d5a486f89ad88f95

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+# [1.10.0](https://github.com/PAYONE-GmbH/PCP-ServerSDK-ruby/compare/v1.9.0...v1.10.0) (2026-05-22)
+
+### Features
+
+* feat: update API version to 1.55.0 ([55d757f9427b16513b6c48bd9a8d7332d82bd886](https://github.com/PAYONE-GmbH/PCP-ServerSDK-ruby/commit/55d757f9427b16513b6c48bd9a8d7332d82bd886))
+
 # [1.9.0](https://github.com/PAYONE-GmbH/PCP-ServerSDK-ruby/compare/v1.8.0...v1.9.0) (2026-04-29)
 
 ### Features

data/README.md

@@ -6,7 +6,7 @@
 ![PyPI - Downloads](https://img.shields.io/gem/dv/pcp-server-ruby-sdk/1.1.0)
 
 
-Welcome to the Ruby SDK for the PAYONE Commerce Platform (api-version 1.40.0)! This repository contains a powerful, easy-to-use software development kit (SDK) designed to simplify the integration of online payment processing into your applications.
+Welcome to the Ruby SDK for the PAYONE Commerce Platform (api-version 1.55.0)! This repository contains a powerful, easy-to-use software development kit (SDK) designed to simplify the integration of online payment processing into your applications.
 
 ## Requirements
 

data/api-definition.yaml

@@ -1,15 +1,15 @@
 openapi: "3.0.3"
 
 info:
-  version: 1.50.0
+  version: 1.55.0
   title: "Commerce Platform API"
   description: |
     RESTful API for the creation of Commerce Cases with Checkouts and the execution of Payments.
 
 servers:
-  - url: "https://commerce-api.payone.com"
+  - url: "https://api.commerce.payone.com"
     description: Production URL
-  - url: "https://preprod.commerce-api.payone.com"
+  - url: "https://api.preprod.commerce.payone.com"
     description: Pre-Production URL
 
 tags:
@@ -1245,6 +1245,100 @@ paths:
               schema:
                 $ref: '#/components/schemas/ErrorResponse'
 
+  '/v1/{merchantId}/commerce-cases/{commerceCaseId}/checkouts/{checkoutId}/payment-executions/{paymentExecutionId}/events/{eventId}/fund-splits':
+    post:
+      summary: Create a Fund Split for a Chargeback Event
+      description: |-
+        This endpoint allows merchants to instruct fund split distributions for a specific chargeback event
+        within a marketplace transaction. When a chargeback event is received and allocated to a Payment Execution
+        that belongs to a marketplace transaction, the merchant can use this endpoint to specify how the chargeback
+        amount should be distributed among the different sellers (fund recipients) involved in the original order.
+
+        The fund split instruction contains one or more fund distributions, each specifying a target account,
+        the amount to be allocated, and the type of distribution (e.g. seller revenue, platform commission, etc.).
+
+        This endpoint is only applicable for Payment Executions that belong to a marketplace transaction.
+        If the Payment Execution is not part of a marketplace transaction, a 400 error will be returned.
+      tags:
+        - PaymentExecution
+      operationId: createFundSplit
+      parameters:
+        - $ref: '#/components/parameters/merchantIdPath'
+        - $ref: '#/components/parameters/commerceCaseIdPath'
+        - $ref: '#/components/parameters/checkoutIdPath'
+        - $ref: '#/components/parameters/paymentExecutionId'
+        - $ref: '#/components/parameters/eventIdPath'
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/FundSplitRequest'
+      responses:
+        '201':
+          x-nullable: true
+          description: The fund split instruction was successfully created and will be processed.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/FundSplitResponse'
+        '400':
+          x-nullable: true
+          description: |-
+            The request was malformed, was missing required data, or the Payment Execution does not belong to a
+            marketplace transaction. The error message will indicate the specific issue.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '403':
+          x-nullable: true
+          description: You are not allowed to access the service or account or your API authentication failed.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          x-nullable: true
+          description: The Commerce Case, Checkout, Payment Execution, or Event was not found.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '409':
+          x-nullable: true
+          description: |-
+            A fund split instruction has already been submitted for this event, or the event is in a state
+            that does not allow fund split creation.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          x-nullable: true
+          description: Internal server exception.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '502':
+          x-nullable: true
+          description: |-
+            Any 5XX response points to something that went wrong on our end. This could also be that the system was
+            unable to route the transaction to an appropriate acquirer/3rd party. Another reason for such a response
+            is when the 3rd party's response could not be understood.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '503':
+          x-nullable: true
+          description: Service unavailable.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+
   '/v1/{merchantId}/commerce-cases/{commerceCaseId}/checkouts/{checkoutId}/payment-information':
     post:
       summary: Create a Payment Information
@@ -1405,6 +1499,16 @@ components:
       schema:
         type: string
         format: UUID
+    eventIdPath:
+      in: path
+      name: eventId
+      description: |-
+        Unique identifier of a payment event (e.g. a chargeback event) that is associated with a Payment Execution.
+        This ID is used to link the fund split instruction to the specific event that triggered the chargeback allocation.
+      required: true
+      schema:
+        type: string
+        format: UUID
     commerceCaseIdQuery:
       in: query
       name: commerceCaseId
@@ -2110,6 +2214,15 @@ components:
       properties:
         cancellationReason:
           $ref: '#/components/schemas/CancellationReason'
+        amount:
+          type: integer
+          format: int64
+          maximum: 999999999999
+          minimum: 1
+          description: |-
+            Here you can specify the amount that you want to cancel (specified in cents, where single digit currencies
+            are presumed to have 2 digits). The amount can be lower than the amount that was authorized, but not higher. 
+             If left empty, the remaining open amount will be cancelled.
     CancelPaymentResponse:
       type: object
       additionalProperties: false
@@ -2595,6 +2708,7 @@ components:
             * false = the payment does not require approval, and the funds will be captured automatically
             
             If the parameter is not provided in the request, the default value will be true
+          default: true
         paymentProduct3391SpecificInput:
           $ref: '#/components/schemas/PaymentProduct3391SpecificInput'
     CompleteOrderRequest:
@@ -2977,7 +3091,7 @@ components:
       properties:
         acceptHeader:
           type: string
-          description: | 
+          description: |
             The accept-header of the customer client from the HTTP Headers. 
             This field can be mandatory depending on the selected payment method and routing option.
           maxLength: 2048
@@ -3147,6 +3261,7 @@ components:
             * false = the payment does not require approval, and the funds will be captured automatically
             
             If the parameter is not provided in the request, the default value will be true
+          default: true
         paymentProduct3392SpecificInput:
           $ref: '#/components/schemas/PaymentProduct3392SpecificInput'
     FinancingPaymentMethodSpecificOutput:
@@ -3240,6 +3355,46 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/FundDistribution'
+    FundSplitRequest:
+      type: object
+      description: |-
+        Request object for creating a fund split instruction for a chargeback event in a marketplace transaction.
+        Contains the fund split details specifying how the chargeback amount should be distributed among the
+        different sellers and/or the platform involved in the original marketplace order.
+      additionalProperties: false
+      required:
+        - fundSplit
+      properties:
+        fundSplit:
+          $ref: '#/components/schemas/FundSplit'
+    FundSplitResponse:
+      type: object
+      description: |-
+        Response object returned after successfully creating a fund split instruction. Contains the unique
+        identifier of the created fund split and the processing status.
+      additionalProperties: false
+      properties:
+        fundSplitId:
+          type: string
+          format: UUID
+          description: |-
+            Unique identifier assigned to the created fund split instruction. This ID can be used for tracking
+            and referencing the fund split in subsequent operations or inquiries.
+          example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+        paymentExecutionId:
+          type: string
+          format: UUID
+          description: |-
+            Unique identifier of the Payment Execution that this fund split is associated with.
+          example: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
+        eventId:
+          type: string
+          format: UUID
+          description: |-
+            Unique identifier of the chargeback event that this fund split instruction was created for.
+          example: "c56a4180-65aa-42ec-a945-5fd21dec0538"
+        fundSplit:
+          $ref: '#/components/schemas/FundSplit'
     InstallmentOption:
       type: object
       properties:
@@ -3509,7 +3664,7 @@ components:
           example: 0
         taxAmountPerUnit:
           type: boolean
-          description: |- 
+          description: |-
             This field indicates if the `taxAmount` is to be interpreted as the tax amount per unit rather than for the entire line item. 
             This field is included in the response only when `taxAmount` is set; otherwise, it will return as `null`.
           format: int64
@@ -4207,7 +4362,10 @@ components:
           example: your-order-6372
     PaymentReferencesForRefund:
       type: object
-      description: Object that holds all reference properties that are linked to this transaction.
+      description: |-
+        Object that holds all reference properties that are linked to this refund transaction.
+        Extends the standard PaymentReferences with an additional captureReference field to support
+        scenarios where a Checkout may contain multiple partial captures from different sellers.
       additionalProperties: false
       allOf:
         - $ref: '#/components/schemas/PaymentReferences'
@@ -4215,9 +4373,16 @@ components:
           properties:
             captureReference:
               description: |-
-                Reference of the capture that should be used for the refund.
+                Merchant-provided reference of the capture that this refund should be applied to.
+                A single Checkout can contain multiple partial captures.
+                By supplying the captureReference the merchant ensures the refund is allocated to the correct
+                capture.
+
+                This value must match the merchantReference that was provided in the PaymentReferences of the
+                original capture request.
               example: your-order-6372
               type: string
+              maxLength: 20
     PaymentResponse:
       type: object
       description: Object that holds the payment related properties.
@@ -4454,6 +4619,7 @@ components:
             * false = the payment does not require approval, and the funds will be captured automatically
             
             If the parameter is not provided in the request, the default value will be true
+          default: true
         paymentProcessingToken:
           type: string
           description: ID of the token to use to create the payment.
@@ -4477,6 +4643,8 @@ components:
           $ref: '#/components/schemas/PaymentProductId'
         paymentProduct840SpecificInput:
           $ref: '#/components/schemas/RedirectPaymentProduct840SpecificInput'
+        paymentProduct900SpecificInput:
+          $ref: '#/components/schemas/RedirectPaymentProduct900SpecificInput'
         redirectionData:
           $ref: '#/components/schemas/RedirectionData'
     RedirectPaymentMethodSpecificOutput:
@@ -4529,6 +4697,27 @@ components:
             Default value is false.
           default: false
           example: true
+    RedirectPaymentProduct900SpecificInput:
+      type: object
+      properties:
+        captureTrigger:
+          type: string
+          description: |-
+            Indicates the event upon which the payment should be captured. 
+            This value is shown to customers in the Wero portal to clarify
+            when the capture will occur.
+            Has the following possible values:
+            - shipping: Upon shipping the order.
+            - delivery: Upon delivering the order.
+            - availability: As soon as the order is available.
+            - serviceFulfillment: Upon fulfilling the service.
+            - other: For any other use case.
+          enum:
+            - shipping
+            - delivery
+            - availability
+            - serviceFulfillment
+            - other
     References:
       type: object
       description: Object that holds all reference properties that are linked to this transaction.
@@ -5008,4 +5197,4 @@ components:
       enum:
         - first
         - subsequent
-      x-enum-to-string: false
+      x-enum-to-string: false

data/lib/PCP-server-Ruby-SDK/endpoints/payment_execution_api_client.rb

@@ -6,6 +6,7 @@ require_relative '../models/cancel_payment_response'
 require_relative '../models/capture_payment_response'
 require_relative '../models/complete_payment_response'
 require_relative '../models/create_payment_response'
+require_relative '../models/fund_split_response'
 require_relative '../models/refund_payment_response'
 module PCPServerSDK
   module Endpoints
@@ -176,6 +177,31 @@ module PCPServerSDK
         deserialize_json(response, PCPServerSDK::Models::PaymentExecution)
       end
 
+      # Create a fund split for a payment event
+      # @param merchant_id [String] The merchant identifier
+      # @param commerce_case_id [String] The commerce case identifier
+      # @param checkout_id [String] The checkout identifier
+      # @param payment_execution_id [String] The payment execution identifier
+      # @param event_id [String] The payment event identifier
+      # @param payload [PCPServerSDK::Models::FundSplitRequest] The fund split request
+      # @return [PCPServerSDK::Models::FundSplitResponse] The fund split response
+      def create_fund_split(merchant_id, commerce_case_id, checkout_id, payment_execution_id, event_id, payload)
+        validate_ids(merchant_id, commerce_case_id, checkout_id)
+        raise TypeError, PAYMENT_EXECUTION_ID_REQUIRED_ERROR if payment_execution_id.nil? || payment_execution_id.empty?
+        raise TypeError, 'Event ID is required' if event_id.nil? || event_id.empty?
+
+        url = URI.join(get_config.host, "/v1/#{merchant_id}/commerce-cases/#{commerce_case_id}/checkouts/#{checkout_id}/payment-executions/#{payment_execution_id}/events/#{event_id}/fund-splits")
+
+        request_init = {
+          method: 'POST',
+          headers: { 'Content-Type' => 'application/json' },
+          body: JSON.generate(payload)
+        }
+
+        response = make_api_call(url.to_s, request_init)
+        deserialize_json(response, PCPServerSDK::Models::FundSplitResponse)
+      end
+
 
     private
 

data/lib/PCP-server-Ruby-SDK/models/cancel_payment_request.rb

@@ -6,6 +6,11 @@ module PCPServerSDK
     class CancelPaymentRequest
       attr_accessor :cancellation_reason
 
+      # Here you can specify the amount that you want to cancel (specified in cents, where single digit currencies
+      # are presumed to have 2 digits). The amount can be lower than the amount that was authorized, but not higher. 
+      # If left empty, the remaining open amount will be cancelled.
+      attr_accessor :amount
+
       class EnumAttributeValidator
         attr_reader :datatype
         attr_reader :allowable_values
@@ -31,7 +36,8 @@ module PCPServerSDK
       # Attribute mapping from ruby-style variable name to JSON key.
       def self.attribute_map
         {
-          :'cancellation_reason' => :'cancellationReason'
+          :'cancellation_reason' => :'cancellationReason',
+          :'amount' => :'amount'
         }
       end
 
@@ -43,7 +49,8 @@ module PCPServerSDK
       # Attribute type mapping.
       def self.openapi_types
         {
-          :'cancellation_reason' => :'CancellationReason'
+          :'cancellation_reason' => :'CancellationReason',
+          :'amount' => :'Integer'
         }
       end
 
@@ -71,6 +78,10 @@ module PCPServerSDK
         if attributes.key?(:'cancellation_reason')
           self.cancellation_reason = attributes[:'cancellation_reason']
         end
+
+        if attributes.key?(:'amount')
+          self.amount = attributes[:'amount']
+        end
       end
 
       # Checks equality by comparing each attribute.
@@ -78,7 +89,8 @@ module PCPServerSDK
       def ==(o)
         return true if self.equal?(o)
         self.class == o.class &&
-            cancellation_reason == o.cancellation_reason
+            cancellation_reason == o.cancellation_reason &&
+            amount == o.amount
       end
 
       # @see the `==` method
@@ -90,7 +102,7 @@ module PCPServerSDK
       # Calculates hash code according to all attributes.
       # @return [Integer] Hash code
       def hash
-        [cancellation_reason].hash
+        [cancellation_reason, amount].hash
       end
 
       # Builds the object from hash

data/lib/PCP-server-Ruby-SDK/models/fund_split_request.rb

@@ -0,0 +1,153 @@
+
+require 'date'
+require 'time'
+
+module PCPServerSDK
+  module Models
+    class FundSplitRequest
+      attr_accessor :fund_split
+
+      def self.attribute_map
+        {
+          :'fund_split' => :'fundSplit'
+        }
+      end
+
+      def self.acceptable_attributes
+        attribute_map.values
+      end
+
+      def self.openapi_types
+        {
+          :'fund_split' => :'FundSplit'
+        }
+      end
+
+      def self.openapi_nullable
+        Set.new([])
+      end
+
+      def initialize(attributes = {})
+        if (!attributes.is_a?(Hash))
+          fail ArgumentError, "The input argument (attributes) must be a hash in `FundSplitRequest` initialize method"
+        end
+
+        attributes = attributes.each_with_object({}) { |(k, v), h|
+          if (!self.class.attribute_map.key?(k.to_sym))
+            fail ArgumentError, "`#{k}` is not a valid attribute in `FundSplitRequest`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
+          end
+          h[k.to_sym] = v
+        }
+
+        if attributes.key?(:'fund_split')
+          self.fund_split = attributes[:'fund_split']
+        end
+      end
+
+      def ==(o)
+        return true if self.equal?(o)
+        self.class == o.class &&
+          fund_split == o.fund_split
+      end
+
+      def eql?(o)
+        self == o
+      end
+
+      def hash
+        [fund_split].hash
+      end
+
+      def self.build_from_hash(attributes)
+        return nil unless attributes.is_a?(Hash)
+        attributes = attributes.transform_keys(&:to_sym)
+        transformed_hash = {}
+        openapi_types.each_pair do |key, type|
+          if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+            transformed_hash["#{key}"] = nil
+          elsif type =~ /\AArray<(.*)>/i
+            if attributes[attribute_map[key]].is_a?(Array)
+              transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+            end
+          elsif !attributes[attribute_map[key]].nil?
+            transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+          end
+        end
+        new(transformed_hash)
+      end
+
+      def self._deserialize(type, value)
+        case type.to_sym
+        when :Time
+          Time.parse(value)
+        when :Date
+          Date.parse(value)
+        when :String
+          value.to_s
+        when :Integer
+          value.to_i
+        when :Float
+          value.to_f
+        when :Boolean
+          if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+            true
+          else
+            false
+          end
+        when :Object
+          value
+        when /\AArray<(?<inner_type>.+)>\z/
+          inner_type = Regexp.last_match[:inner_type]
+          value.map { |v| _deserialize(inner_type, v) }
+        when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+          k_type = Regexp.last_match[:k_type]
+          v_type = Regexp.last_match[:v_type]
+          {}.tap do |hash|
+            value.each do |k, v|
+              hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+            end
+          end
+        else
+          klass = PCPServerSDK::Models.const_get(type)
+          klass.respond_to?(:openapi_any_of) || klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
+        end
+      end
+
+      def to_s
+        to_hash.to_s
+      end
+
+      def to_body
+        to_hash
+      end
+
+      def to_hash
+        hash = {}
+        self.class.attribute_map.each_pair do |attr, param|
+          value = self.send(attr)
+          if value.nil?
+            is_nullable = self.class.openapi_nullable.include?(attr)
+            next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+          end
+
+          hash[param] = _to_hash(value)
+        end
+        hash
+      end
+
+      def _to_hash(value)
+        if value.is_a?(Array)
+          value.compact.map { |v| _to_hash(v) }
+        elsif value.is_a?(Hash)
+          {}.tap do |hash|
+            value.each { |k, v| hash[k] = _to_hash(v) }
+          end
+        elsif value.respond_to? :to_hash
+          value.to_hash
+        else
+          value
+        end
+      end
+    end
+  end
+end

data/lib/PCP-server-Ruby-SDK/models/fund_split_response.rb

@@ -0,0 +1,180 @@
+
+require 'date'
+require 'time'
+
+module PCPServerSDK
+  module Models
+    class FundSplitResponse
+      attr_accessor :fund_split_id
+
+      attr_accessor :payment_execution_id
+
+      attr_accessor :event_id
+
+      attr_accessor :fund_split
+
+      def self.attribute_map
+        {
+          :'fund_split_id' => :'fundSplitId',
+          :'payment_execution_id' => :'paymentExecutionId',
+          :'event_id' => :'eventId',
+          :'fund_split' => :'fundSplit'
+        }
+      end
+
+      def self.acceptable_attributes
+        attribute_map.values
+      end
+
+      def self.openapi_types
+        {
+          :'fund_split_id' => :'String',
+          :'payment_execution_id' => :'String',
+          :'event_id' => :'String',
+          :'fund_split' => :'FundSplit'
+        }
+      end
+
+      def self.openapi_nullable
+        Set.new([])
+      end
+
+      def initialize(attributes = {})
+        if (!attributes.is_a?(Hash))
+          fail ArgumentError, "The input argument (attributes) must be a hash in `FundSplitResponse` initialize method"
+        end
+
+        attributes = attributes.each_with_object({}) { |(k, v), h|
+          if (!self.class.attribute_map.key?(k.to_sym))
+            fail ArgumentError, "`#{k}` is not a valid attribute in `FundSplitResponse`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
+          end
+          h[k.to_sym] = v
+        }
+
+        if attributes.key?(:'fund_split_id')
+          self.fund_split_id = attributes[:'fund_split_id']
+        end
+
+        if attributes.key?(:'payment_execution_id')
+          self.payment_execution_id = attributes[:'payment_execution_id']
+        end
+
+        if attributes.key?(:'event_id')
+          self.event_id = attributes[:'event_id']
+        end
+
+        if attributes.key?(:'fund_split')
+          self.fund_split = attributes[:'fund_split']
+        end
+      end
+
+      def ==(o)
+        return true if self.equal?(o)
+        self.class == o.class &&
+          fund_split_id == o.fund_split_id &&
+          payment_execution_id == o.payment_execution_id &&
+          event_id == o.event_id &&
+          fund_split == o.fund_split
+      end
+
+      def eql?(o)
+        self == o
+      end
+
+      def hash
+        [fund_split_id, payment_execution_id, event_id, fund_split].hash
+      end
+
+      def self.build_from_hash(attributes)
+        return nil unless attributes.is_a?(Hash)
+        attributes = attributes.transform_keys(&:to_sym)
+        transformed_hash = {}
+        openapi_types.each_pair do |key, type|
+          if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+            transformed_hash["#{key}"] = nil
+          elsif type =~ /\AArray<(.*)>/i
+            if attributes[attribute_map[key]].is_a?(Array)
+              transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+            end
+          elsif !attributes[attribute_map[key]].nil?
+            transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+          end
+        end
+        new(transformed_hash)
+      end
+
+      def self._deserialize(type, value)
+        case type.to_sym
+        when :Time
+          Time.parse(value)
+        when :Date
+          Date.parse(value)
+        when :String
+          value.to_s
+        when :Integer
+          value.to_i
+        when :Float
+          value.to_f
+        when :Boolean
+          if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+            true
+          else
+            false
+          end
+        when :Object
+          value
+        when /\AArray<(?<inner_type>.+)>\z/
+          inner_type = Regexp.last_match[:inner_type]
+          value.map { |v| _deserialize(inner_type, v) }
+        when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+          k_type = Regexp.last_match[:k_type]
+          v_type = Regexp.last_match[:v_type]
+          {}.tap do |hash|
+            value.each do |k, v|
+              hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+            end
+          end
+        else
+          klass = PCPServerSDK::Models.const_get(type)
+          klass.respond_to?(:openapi_any_of) || klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
+        end
+      end
+
+      def to_s
+        to_hash.to_s
+      end
+
+      def to_body
+        to_hash
+      end
+
+      def to_hash
+        hash = {}
+        self.class.attribute_map.each_pair do |attr, param|
+          value = self.send(attr)
+          if value.nil?
+            is_nullable = self.class.openapi_nullable.include?(attr)
+            next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+          end
+
+          hash[param] = _to_hash(value)
+        end
+        hash
+      end
+
+      def _to_hash(value)
+        if value.is_a?(Array)
+          value.compact.map { |v| _to_hash(v) }
+        elsif value.is_a?(Hash)
+          {}.tap do |hash|
+            value.each { |k, v| hash[k] = _to_hash(v) }
+          end
+        elsif value.respond_to? :to_hash
+          value.to_hash
+        else
+          value
+        end
+      end
+    end
+  end
+end

data/lib/PCP-server-Ruby-SDK/models/payment_references_for_refund.rb

@@ -1,14 +1,21 @@
 require 'date'
 require 'time'
 
-# Object that holds all reference properties for a refund that are linked to this transaction.
+# Object that holds all reference properties that are linked to this refund transaction.
+# Extends the standard PaymentReferences with an additional captureReference field to support
+# scenarios where a Checkout may contain multiple partial captures from different sellers.
 module PCPServerSDK
   module Models
     class PaymentReferencesForRefund
       # Unique reference of the Commerce Case that is also returned for reporting and reconciliation purposes.
       attr_accessor :merchant_reference
 
-      # Reference to the capture to be refunded.
+      # Merchant-provided reference of the capture that this refund should be applied to.
+      #          A single Checkout can contain multiple partial captures.
+      #          By supplying the captureReference the merchant ensures the refund is allocated to the correct
+      #          capture.
+      #          This value must match the merchantReference that was provided in the PaymentReferences of the
+      #          original capture request.
       attr_accessor :capture_reference
 
       # Attribute mapping from ruby-style variable name to JSON key.

data/lib/PCP-server-Ruby-SDK/models/redirect_payment_method_specific_input.rb

@@ -23,6 +23,8 @@ module PCPServerSDK
 
       attr_accessor :payment_product840_specific_input
 
+      attr_accessor :payment_product900_specific_input
+
       attr_accessor :redirection_data
 
       # Attribute mapping from ruby-style variable name to JSON key.
@@ -34,6 +36,7 @@ module PCPServerSDK
           :'tokenize' => :'tokenize',
           :'payment_product_id' => :'paymentProductId',
           :'payment_product840_specific_input' => :'paymentProduct840SpecificInput',
+          :'payment_product900_specific_input' => :'paymentProduct900SpecificInput',
           :'redirection_data' => :'redirectionData'
         }
       end
@@ -52,6 +55,7 @@ module PCPServerSDK
           :'tokenize' => :'Boolean',
           :'payment_product_id' => :'Integer',
           :'payment_product840_specific_input' => :'RedirectPaymentProduct840SpecificInput',
+          :'payment_product900_specific_input' => :'RedirectPaymentProduct900SpecificInput',
           :'redirection_data' => :'RedirectionData'
         }
       end
@@ -101,6 +105,10 @@ module PCPServerSDK
           self.payment_product840_specific_input = attributes[:'payment_product840_specific_input']
         end
 
+        if attributes.key?(:'payment_product900_specific_input')
+          self.payment_product900_specific_input = attributes[:'payment_product900_specific_input']
+        end
+
         if attributes.key?(:'redirection_data')
           self.redirection_data = attributes[:'redirection_data']
         end
@@ -117,6 +125,7 @@ module PCPServerSDK
             tokenize == o.tokenize &&
             payment_product_id == o.payment_product_id &&
             payment_product840_specific_input == o.payment_product840_specific_input &&
+            payment_product900_specific_input == o.payment_product900_specific_input &&
             redirection_data == o.redirection_data
       end
 
@@ -129,7 +138,7 @@ module PCPServerSDK
       # Calculates hash code according to all attributes.
       # @return [Integer] Hash code
       def hash
-        [requires_approval, payment_processing_token, reporting_token, tokenize, payment_product_id, payment_product840_specific_input, redirection_data].hash
+        [requires_approval, payment_processing_token, reporting_token, tokenize, payment_product_id, payment_product840_specific_input, payment_product900_specific_input, redirection_data].hash
       end
 
       # Builds the object from hash

data/lib/PCP-server-Ruby-SDK/models/redirect_payment_product900_specific_input.rb

@@ -0,0 +1,183 @@
+
+require 'date'
+require 'time'
+
+module PCPServerSDK
+  module Models
+    class RedirectPaymentProduct900SpecificInput
+      attr_accessor :capture_trigger
+
+      class EnumAttributeValidator
+        attr_reader :datatype
+        attr_reader :allowable_values
+
+        def initialize(datatype, allowable_values)
+          @allowable_values = allowable_values.map do |value|
+            case datatype.to_s
+            when /Integer/i
+              value.to_i
+            when /Float/i
+              value.to_f
+            else
+              value
+            end
+          end
+        end
+
+        def valid?(value)
+          !value || allowable_values.include?(value)
+        end
+      end
+
+      def self.attribute_map
+        {
+          :'capture_trigger' => :'captureTrigger'
+        }
+      end
+
+      def self.acceptable_attributes
+        attribute_map.values
+      end
+
+      def self.openapi_types
+        {
+          :'capture_trigger' => :'String'
+        }
+      end
+
+      def self.openapi_nullable
+        Set.new([])
+      end
+
+      def initialize(attributes = {})
+        if (!attributes.is_a?(Hash))
+          fail ArgumentError, "The input argument (attributes) must be a hash in `RedirectPaymentProduct900SpecificInput` initialize method"
+        end
+
+        attributes = attributes.each_with_object({}) { |(k, v), h|
+          if (!self.class.attribute_map.key?(k.to_sym))
+            fail ArgumentError, "`#{k}` is not a valid attribute in `RedirectPaymentProduct900SpecificInput`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
+          end
+          h[k.to_sym] = v
+        }
+
+        if attributes.key?(:'capture_trigger')
+          self.capture_trigger = attributes[:'capture_trigger']
+        end
+      end
+
+      def ==(o)
+        return true if self.equal?(o)
+        self.class == o.class &&
+          capture_trigger == o.capture_trigger
+      end
+
+      def eql?(o)
+        self == o
+      end
+
+      def hash
+        [capture_trigger].hash
+      end
+
+      def self.build_from_hash(attributes)
+        return nil unless attributes.is_a?(Hash)
+        attributes = attributes.transform_keys(&:to_sym)
+        transformed_hash = {}
+        openapi_types.each_pair do |key, type|
+          if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+            transformed_hash["#{key}"] = nil
+          elsif type =~ /\AArray<(.*)>/i
+            if attributes[attribute_map[key]].is_a?(Array)
+              transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+            end
+          elsif !attributes[attribute_map[key]].nil?
+            transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+          end
+        end
+        new(transformed_hash)
+      end
+
+      def self._deserialize(type, value)
+        case type.to_sym
+        when :Time
+          Time.parse(value)
+        when :Date
+          Date.parse(value)
+        when :String
+          value.to_s
+        when :Integer
+          value.to_i
+        when :Float
+          value.to_f
+        when :Boolean
+          if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+            true
+          else
+            false
+          end
+        when :Object
+          value
+        when /\AArray<(?<inner_type>.+)>\z/
+          inner_type = Regexp.last_match[:inner_type]
+          value.map { |v| _deserialize(inner_type, v) }
+        when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+          k_type = Regexp.last_match[:k_type]
+          v_type = Regexp.last_match[:v_type]
+          {}.tap do |hash|
+            value.each do |k, v|
+              hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+            end
+          end
+        else
+          klass = PCPServerSDK::Models.const_get(type)
+          klass.respond_to?(:openapi_any_of) || klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
+        end
+      end
+
+      def to_s
+        to_hash.to_s
+      end
+
+      def to_body
+        to_hash
+      end
+
+      def to_hash
+        hash = {}
+        self.class.attribute_map.each_pair do |attr, param|
+          value = self.send(attr)
+          if value.nil?
+            is_nullable = self.class.openapi_nullable.include?(attr)
+            next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+          end
+
+          hash[param] = _to_hash(value)
+        end
+        hash
+      end
+
+      def _to_hash(value)
+        if value.is_a?(Array)
+          value.compact.map { |v| _to_hash(v) }
+        elsif value.is_a?(Hash)
+          {}.tap do |hash|
+            value.each { |k, v| hash[k] = _to_hash(v) }
+          end
+        elsif value.respond_to? :to_hash
+          value.to_hash
+        else
+          value
+        end
+      end
+
+      def capture_trigger=(capture_trigger)
+        validator = EnumAttributeValidator.new('String', ['shipping', 'delivery', 'availability', 'serviceFulfillment', 'other'])
+        unless validator.valid?(capture_trigger)
+          fail ArgumentError, "invalid value for \"capture_trigger\", must be one of #{validator.allowable_values}."
+        end
+        @capture_trigger = capture_trigger
+      end
+    end
+  end
+end

data/lib/PCP-server-Ruby-SDK/version.rb

@@ -1,4 +1,4 @@
 
 module PCPServerSDK
-  VERSION = '1.9.0'
+  VERSION = '1.10.0'
 end

data/lib/PCP-server-Ruby-SDK.rb

@@ -78,6 +78,8 @@ require_relative 'PCP-server-Ruby-SDK/models/financing_payment_method_specific_i
 require_relative 'PCP-server-Ruby-SDK/models/financing_payment_method_specific_output'
 require_relative 'PCP-server-Ruby-SDK/models/fund_distribution'
 require_relative 'PCP-server-Ruby-SDK/models/fund_split'
+require_relative 'PCP-server-Ruby-SDK/models/fund_split_request'
+require_relative 'PCP-server-Ruby-SDK/models/fund_split_response'
 require_relative 'PCP-server-Ruby-SDK/models/installment_option'
 require_relative 'PCP-server-Ruby-SDK/models/link_information'
 require_relative 'PCP-server-Ruby-SDK/models/mandate_recurrence_type'
@@ -138,6 +140,7 @@ require_relative 'PCP-server-Ruby-SDK/models/complete_payment_product840_specifi
 require_relative 'PCP-server-Ruby-SDK/models/complete_redirect_payment_method_specific_input'
 require_relative 'PCP-server-Ruby-SDK/models/redirect_payment_method_specific_output'
 require_relative 'PCP-server-Ruby-SDK/models/redirect_payment_product840_specific_input'
+require_relative 'PCP-server-Ruby-SDK/models/redirect_payment_product900_specific_input'
 require_relative 'PCP-server-Ruby-SDK/models/redirection_data'
 require_relative 'PCP-server-Ruby-SDK/models/references'
 require_relative 'PCP-server-Ruby-SDK/models/refresh_payment_request'

data/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pcp-serversdk-ruby",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pcp-serversdk-ruby",
-      "version": "1.9.0",
+      "version": "1.10.0",
       "devDependencies": {
         "@commitlint/cli": "19.4.0",
         "@commitlint/config-conventional": "19.2.2",

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pcp-serversdk-ruby",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "type": "commonjs",
   "scripts": {
     "changelog": "conventional-changelog -i CHANGELOG.md -s --config ./changelog.config.js"

data/spec/endpoints/payment_execution_api_client_spec.rb

@@ -377,4 +377,56 @@ RSpec.describe PCPServerSDK::Endpoints::PaymentExecutionApiClient do
       end
     end
   end
+
+  describe '#create_fund_split' do
+    let(:payload) { double('PCPServerSDK::Models::FundSplitRequest') }
+
+    context 'when request is successful' do
+      let(:response) { double('Response', body: '{}', code: '200') }
+      let(:expected_response) { PCPServerSDK::Models::FundSplitResponse.new }
+
+      before do
+        allow(client).to receive(:get_response).and_return(response)
+      end
+
+      it 'returns a successful response' do
+        result = client.create_fund_split('1', '2', '3', '4', '5', payload)
+        expect(result).to eq(expected_response)
+      end
+    end
+
+    context 'when request is unsuccessful (400)' do
+      let(:response) { double('Response', body: error_body, code: '400') }
+
+      before do
+        allow(client).to receive(:get_response).and_return(response)
+      end
+
+      it 'raises an PCPServerSDK::Errors::ApiErrorResponseException' do
+        expect { client.create_fund_split('1', '2', '3', '4', '5', payload) }.to raise_error(PCPServerSDK::Errors::ApiErrorResponseException)
+      end
+    end
+
+    context 'when request is unsuccessful (500)' do
+      let(:response) { double('Response', body: '{}', code: '500') }
+
+      before do
+        allow(client).to receive(:get_response).and_return(response)
+      end
+
+      it 'raises an PCPServerSDK::Errors::ApiResponseRetrievalException' do
+        expect { client.create_fund_split('1', '2', '3', '4', '5', payload) }.to raise_error(PCPServerSDK::Errors::ApiResponseRetrievalException)
+      end
+    end
+
+    context 'when some params are nil' do
+      it 'raises a TypeError' do
+        expect { client.create_fund_split(nil, '2', '3', '4', '5', payload) }.to raise_error(TypeError, 'Merchant ID is required')
+        expect { client.create_fund_split('1', nil, '3', '4', '5', payload) }.to raise_error(TypeError, 'Commerce Case ID is required')
+        expect { client.create_fund_split('1', '2', nil, '4', '5', payload) }.to raise_error(TypeError, 'Checkout ID is required')
+        expect { client.create_fund_split('1', '2', '3', nil, '5', payload) }.to raise_error(TypeError, 'Payment Execution ID is required')
+        expect { client.create_fund_split('1', '2', '3', '4', nil, payload) }.to raise_error(TypeError, 'Event ID is required')
+      end
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pcp-server-ruby-sdk
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.10.0
 platform: ruby
 authors:
 - PAYONE GmbH
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-29 00:00:00.000000000 Z
+date: 2026-05-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -190,6 +190,8 @@ files:
 - lib/PCP-server-Ruby-SDK/models/financing_payment_method_specific_output.rb
 - lib/PCP-server-Ruby-SDK/models/fund_distribution.rb
 - lib/PCP-server-Ruby-SDK/models/fund_split.rb
+- lib/PCP-server-Ruby-SDK/models/fund_split_request.rb
+- lib/PCP-server-Ruby-SDK/models/fund_split_response.rb
 - lib/PCP-server-Ruby-SDK/models/installment_option.rb
 - lib/PCP-server-Ruby-SDK/models/link_information.rb
 - lib/PCP-server-Ruby-SDK/models/mandate_recurrence_type.rb
@@ -249,6 +251,7 @@ files:
 - lib/PCP-server-Ruby-SDK/models/redirect_payment_method_specific_input.rb
 - lib/PCP-server-Ruby-SDK/models/redirect_payment_method_specific_output.rb
 - lib/PCP-server-Ruby-SDK/models/redirect_payment_product840_specific_input.rb
+- lib/PCP-server-Ruby-SDK/models/redirect_payment_product900_specific_input.rb
 - lib/PCP-server-Ruby-SDK/models/redirection_data.rb
 - lib/PCP-server-Ruby-SDK/models/references.rb
 - lib/PCP-server-Ruby-SDK/models/refresh_payment_request.rb
@@ -332,15 +335,15 @@ specification_version: 4
 summary: Commerce Platform API Ruby Gem
 test_files:
 - spec/communicator_configuration_spec.rb
+- spec/endpoints/order_management_checkout_actions_api_client_spec.rb
+- spec/endpoints/base_api_client_spec.rb
 - spec/endpoints/payment_execution_api_client_spec.rb
-- spec/endpoints/checkout_api_client_spec.rb
 - spec/endpoints/payment_information_api_client_spec.rb
-- spec/endpoints/commerce_case_api_client_spec.rb
-- spec/endpoints/base_api_client_spec.rb
-- spec/endpoints/order_management_checkout_actions_api_client_spec.rb
 - spec/endpoints/authentication_api_client_spec.rb
-- spec/errors/api_exception_spec.rb
+- spec/endpoints/checkout_api_client_spec.rb
+- spec/endpoints/commerce_case_api_client_spec.rb
 - spec/errors/api_response_retrieval_exception_spec.rb
+- spec/errors/api_exception_spec.rb
 - spec/errors/api_error_response_exception_spec.rb
 - spec/models/required_field_validation_spec.rb
 - spec/queries/get_checkouts_query_spec.rb