pcp-server-ruby-sdk 1.13.0 → 1.15.0

data/spec/endpoints/payment_intent_api_client_spec.rb

@@ -8,9 +8,15 @@ RSpec.describe PCPServerSDK::Endpoints::PaymentIntentApiClient do
 
   describe '#create_payment_intent' do
     it 'posts the payload and deserializes the response' do
-      payload = PCPServerSDK::Models::CreatePaymentIntentRequest.new
+      payload = PCPServerSDK::Models::CreatePaymentIntentRequest.new(
+        references: PCPServerSDK::Models::PaymentReferencesForPaymentIntent.new(merchant_reference: 'order-123')
+      )
       response = double('Response', body: '{"paymentIntentOutput":{"paymentIntentId":"intent-1"}}', code: '201')
-      allow(client).to receive(:get_response).and_return(response)
+      allow(client).to receive(:get_response) do |_http, request|
+        expect(request).to be_a(Net::HTTP::Post)
+        expect(JSON.parse(request.body)).to eq('references' => { 'merchantReference' => 'order-123' })
+        response
+      end
 
       result = client.create_payment_intent('merchant-1', payload)
 
@@ -40,4 +46,31 @@ RSpec.describe PCPServerSDK::Endpoints::PaymentIntentApiClient do
       expect { client.get_payment_intent('merchant-1', nil) }.to raise_error(TypeError, 'Payment Intent ID is required')
     end
   end
+
+  describe '#patch_payment_intent' do
+    it 'patches the payment intent with a JSON body and deserializes the response' do
+      payload = PCPServerSDK::Models::PatchPaymentIntentRequest.new(
+        amount_of_money: PCPServerSDK::Models::AmountOfMoney.new(amount: 1500, currency_code: 'EUR')
+      )
+      response = double('Response', body: '{"paymentIntentOutput":{"paymentIntentId":"intent-1"}}', code: '200')
+      allow(client).to receive(:get_response) do |_http, request|
+        expect(request).to be_a(Net::HTTP::Patch)
+        expect(request.path).to eq('/v1/merchant-1/payment-intents/intent-1')
+        expect(request['Content-Type']).to eq('application/json')
+        expect(JSON.parse(request.body)).to eq('amountOfMoney' => { 'amount' => 1500, 'currencyCode' => 'EUR' })
+        response
+      end
+
+      result = client.patch_payment_intent('merchant-1', 'intent-1', payload)
+
+      expect(result).to be_a(PCPServerSDK::Models::PatchPaymentIntentResponse)
+      expect(result.payment_intent_output.payment_intent_id).to eq('intent-1')
+    end
+
+    it 'validates merchant ID, payment intent ID, and payload' do
+      expect { client.patch_payment_intent(nil, 'intent-1', {}) }.to raise_error(TypeError, 'Merchant ID is required')
+      expect { client.patch_payment_intent('merchant-1', nil, {}) }.to raise_error(TypeError, 'Payment Intent ID is required')
+      expect { client.patch_payment_intent('merchant-1', 'intent-1', nil) }.to raise_error(TypeError, 'Payload is required')
+    end
+  end
 end

data/spec/models/api_definition_conformance_spec.rb

@@ -44,6 +44,34 @@ RSpec.describe 'OpenAPI model conformance' do
     expect(mismatches).to be_empty
   end
 
+  it 'uses the referenced object model for every object-valued schema property' do
+    mismatches = schemas.flat_map do |name, schema|
+      next [] unless schema['type'] == 'object'
+
+      model = PCPServerSDK::Models.const_get(name)
+      schema_properties_with_definitions(schema).filter_map do |property, definition|
+        reference = definition['$ref'] || definition.dig('items', '$ref')
+        next unless reference
+
+        referenced_name = reference.split('/').last
+        next unless schemas.fetch(referenced_name)['type'] == 'object'
+
+        expected = definition['type'] == 'array' ? "Array<#{referenced_name}>" : referenced_name
+        actual = model.openapi_types.fetch(model.attribute_map.key(property.to_sym)).to_s
+        "#{name}.#{property}: expected #{expected}, got #{actual}" unless actual == expected
+      end
+    end
+
+    expect(mismatches).to be_empty
+  end
+
+  def schema_properties_with_definitions(schema)
+    inherited = Array(schema['allOf']).each_with_object({}) do |parent, result|
+      result.merge!(schema_properties_with_definitions(parent['$ref'] ? schemas.fetch(parent['$ref'].split('/').last) : parent))
+    end
+    inherited.merge(schema.fetch('properties', {}))
+  end
+
   it 'declares each direct allOf parent' do
     mismatches = schemas.filter_map do |name, schema|
       expected = Array(schema['allOf']).filter_map { |parent| parent['$ref']&.split('/')&.last }.sort

data/spec/models/pay_by_link_models_spec.rb

@@ -0,0 +1,50 @@
+require 'spec_helper'
+require_relative '../../lib/PCP-server-Ruby-SDK'
+
+RSpec.describe 'Pay-by-link models' do
+  it 'serializes required request properties and deserializes the response structure' do
+    request = PCPServerSDK::Models::CreatePayByLinkRequest.new(
+      payment_link_specific_input: PCPServerSDK::Models::PaymentLinkSpecificInput.new(
+        authorization_mode: 'SALE',
+        payment_methods: ['840'],
+        return_url: 'https://merchant.example/complete'
+      ),
+      order_type: 'FULL',
+      order_references: PCPServerSDK::Models::References.new(merchant_reference: 'order-123')
+    )
+
+    expect(request.to_hash).to include(
+      paymentLinkSpecificInput: {
+        authorizationMode: 'SALE',
+        paymentMethods: ['840'],
+        returnUrl: 'https://merchant.example/complete'
+      },
+      orderType: 'FULL',
+      orderReferences: { merchantReference: 'order-123' }
+    )
+
+    response = PCPServerSDK::Models::CreatePayByLinkResponse.build_from_hash(
+      'expirationDate' => '2026-09-22T12:00:00Z',
+      'paymentLinkOrder' => {
+        'merchantReference' => 'order-123',
+        'amount' => { 'amount' => 1200, 'currencyCode' => 'EUR' }
+      },
+      'status' => 'ACTIVE',
+      'redirectionUrl' => 'https://commerce.example/pay/link',
+      'paymentLinkId' => '707ef15b-7a0a-48f2-b7d8-c95103418a9c'
+    )
+
+    expect(response.expiration_date).to be_a(Time)
+    expect(response.payment_link_order).to be_a(PCPServerSDK::Models::PaymentLinkOrder)
+    expect(response.payment_link_order.amount).to be_a(PCPServerSDK::Models::AmountOfMoney)
+    expect(response.payment_link_order.amount.amount).to eq(1200)
+    expect(response.payment_link_order.amount.currency_code).to eq('EUR')
+    expect(response.status).to eq('ACTIVE')
+  end
+
+  it 'enforces the required request fields from the OpenAPI schema' do
+    expect do
+      PCPServerSDK::Models::CreatePayByLinkRequest.new(order_type: 'FULL')
+    end.to raise_error(ArgumentError, 'payment_link_specific_input cannot be nil')
+  end
+end

data/spec/models/payment_intent_models_spec.rb

@@ -5,6 +5,7 @@ RSpec.describe 'Payment intent models' do
   it 'deserializes and serializes nested payment intent data' do
     request = PCPServerSDK::Models::CreatePaymentIntentRequest.build_from_hash(
       'amountOfMoney' => { 'amount' => 1200, 'currencyCode' => 'EUR' },
+      'references' => { 'merchantReference' => 'subscription-123' },
       'shoppingCart' => {
         'items' => [{ 'invoiceData' => { 'description' => 'Subscription' } }]
       },
@@ -18,8 +19,75 @@ RSpec.describe 'Payment intent models' do
     )
 
     expect(request.amount_of_money).to be_a(PCPServerSDK::Models::AmountOfMoney)
+    expect(request.references).to be_a(PCPServerSDK::Models::PaymentReferencesForPaymentIntent)
     expect(request.shopping_cart.items.first).to be_a(PCPServerSDK::Models::CartItemData)
     expect(request.payment_method_specific_input.redirect_payment_method_specific_input.requires_approval).to be(false)
     expect(request.to_hash.dig(:shoppingCart, :items, 0, :invoiceData, :description)).to eq('Subscription')
   end
+
+  it 'uses the payment-intent PayPal account structure' do
+    response = PCPServerSDK::Models::PaymentIntentResponse.build_from_hash(
+      'redirectPaymentMethodSpecificOutput' => {
+        'paymentProduct840SpecificOutput' => {
+          'customerAccount' => { 'emailAddress' => 'customer@example.com' }
+        }
+      }
+    )
+
+    customer_account = response.redirect_payment_method_specific_output.payment_product840_specific_output.customer_account
+
+    expect(customer_account).to be_a(PCPServerSDK::Models::PaymentProduct840CustomerAccountForIntent)
+    expect(customer_account.email_address).to eq('customer@example.com')
+  end
+
+  it 'uses the regular PayPal account structure outside payment intents' do
+    output = PCPServerSDK::Models::PaymentProduct840SpecificOutput.build_from_hash(
+      'customerAccount' => { 'payerId' => 'payer-123' }
+    )
+
+    expect(output.customer_account).to be_a(PCPServerSDK::Models::PaymentProduct840CustomerAccount)
+    expect(output.customer_account.payer_id).to eq('payer-123')
+  end
+
+  it 'serializes the patch request with the updated amount and shopping cart' do
+    request = PCPServerSDK::Models::PatchPaymentIntentRequest.build_from_hash(
+      'amountOfMoney' => { 'amount' => 1500, 'currencyCode' => 'EUR' },
+      'shoppingCart' => { 'items' => [{ 'invoiceData' => { 'description' => 'Updated item' } }] }
+    )
+
+    expect(request.amount_of_money).to be_a(PCPServerSDK::Models::AmountOfMoney)
+    expect(request.shopping_cart.items.first).to be_a(PCPServerSDK::Models::CartItemData)
+    expect(request.to_hash).to eq(
+      amountOfMoney: { amount: 1500, currencyCode: 'EUR' },
+      shoppingCart: { items: [{ invoiceData: { description: 'Updated item' } }] }
+    )
+  end
+
+  it 'deserializes the patch response using the create response structure' do
+    response = PCPServerSDK::Models::PatchPaymentIntentResponse.build_from_hash(
+      'paymentIntentOutput' => { 'paymentIntentId' => 'intent-1' },
+      'shoppingCart' => { 'items' => [] }
+    )
+
+    expect(response).to be_a(PCPServerSDK::Models::CreatePaymentIntentResponse)
+    expect(response.payment_intent_output.payment_intent_id).to eq('intent-1')
+    expect(response.shopping_cart).to be_a(PCPServerSDK::Models::ShoppingCartData)
+    expect(response.to_hash.dig(:paymentIntentOutput, :paymentIntentId)).to eq('intent-1')
+  end
+
+  it 'uses redirectData in created payment intent output' do
+    response = PCPServerSDK::Models::CreatePaymentIntentResponse.build_from_hash(
+      'paymentIntentOutput' => {
+        'redirectPaymentMethodSpecificOutput' => {
+          'redirectData' => { 'redirectURL' => 'https://example.com/redirect' }
+        }
+      }
+    )
+    redirect_output = response.payment_intent_output.redirect_payment_method_specific_output
+
+    expect(redirect_output.redirect_data).to be_a(PCPServerSDK::Models::RedirectData)
+    expect(redirect_output.redirect_data.redirect_url).to eq('https://example.com/redirect')
+    expect(response.to_hash.dig(:paymentIntentOutput, :redirectPaymentMethodSpecificOutput, :redirectData))
+      .to eq(redirectURL: 'https://example.com/redirect')
+  end
 end

data/spec/queries/get_checkouts_query_spec.rb

@@ -181,4 +181,19 @@ RSpec.describe PCPServerSDK::Queries::GetCheckoutsQuery do
     @query.company_information = 'Company XYZ'
     expect(@query.to_query_map).to eq({ 'companyInformation' => 'Company XYZ' })
   end
+
+  it 'should return query map with card_authorization_id' do
+    @query.card_authorization_id = 'authorization-123'
+    expect(@query.to_query_map).to eq({ 'cardAuthorizationId' => 'authorization-123' })
+  end
+
+  it 'should return query map with receipt_number' do
+    @query.receipt_number = 'receipt-123'
+    expect(@query.to_query_map).to eq({ 'receiptNumber' => 'receipt-123' })
+  end
+
+  it 'should return query map with trace_number' do
+    @query.trace_number = 'trace-123'
+    expect(@query.to_query_map).to eq({ 'traceNumber' => 'trace-123' })
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pcp-server-ruby-sdk
 version: !ruby/object:Gem::Version
-  version: 1.13.0
+  version: 1.15.0
 platform: ruby
 authors:
 - PAYONE GmbH
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-23 00:00:00.000000000 Z
+date: 2026-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -107,6 +107,7 @@ files:
 - lib/PCP-server-Ruby-SDK/endpoints/checkout_api_client.rb
 - lib/PCP-server-Ruby-SDK/endpoints/commerce_case_api_client.rb
 - lib/PCP-server-Ruby-SDK/endpoints/order_management_checkout_actions_api_client.rb
+- lib/PCP-server-Ruby-SDK/endpoints/pay_by_link_api_client.rb
 - lib/PCP-server-Ruby-SDK/endpoints/payment_execution_api_client.rb
 - lib/PCP-server-Ruby-SDK/endpoints/payment_information_api_client.rb
 - lib/PCP-server-Ruby-SDK/endpoints/payment_intent_api_client.rb
@@ -174,6 +175,8 @@ files:
 - lib/PCP-server-Ruby-SDK/models/create_checkout_response.rb
 - lib/PCP-server-Ruby-SDK/models/create_commerce_case_request.rb
 - lib/PCP-server-Ruby-SDK/models/create_commerce_case_response.rb
+- lib/PCP-server-Ruby-SDK/models/create_pay_by_link_request.rb
+- lib/PCP-server-Ruby-SDK/models/create_pay_by_link_response.rb
 - lib/PCP-server-Ruby-SDK/models/create_payment_intent.rb
 - lib/PCP-server-Ruby-SDK/models/create_payment_intent_request.rb
 - lib/PCP-server-Ruby-SDK/models/create_payment_intent_response.rb
@@ -213,8 +216,11 @@ files:
 - lib/PCP-server-Ruby-SDK/models/order_type.rb
 - lib/PCP-server-Ruby-SDK/models/patch_checkout_request.rb
 - lib/PCP-server-Ruby-SDK/models/patch_commerce_case_request.rb
+- lib/PCP-server-Ruby-SDK/models/patch_payment_intent_request.rb
+- lib/PCP-server-Ruby-SDK/models/patch_payment_intent_response.rb
 - lib/PCP-server-Ruby-SDK/models/pause_payment_request.rb
 - lib/PCP-server-Ruby-SDK/models/pause_payment_response.rb
+- lib/PCP-server-Ruby-SDK/models/pay_link_status_value.rb
 - lib/PCP-server-Ruby-SDK/models/payee.rb
 - lib/PCP-server-Ruby-SDK/models/payment_channel.rb
 - lib/PCP-server-Ruby-SDK/models/payment_creation_output.rb
@@ -230,6 +236,8 @@ files:
 - lib/PCP-server-Ruby-SDK/models/payment_intent_output.rb
 - lib/PCP-server-Ruby-SDK/models/payment_intent_response.rb
 - lib/PCP-server-Ruby-SDK/models/payment_intent_response_data.rb
+- lib/PCP-server-Ruby-SDK/models/payment_link_order.rb
+- lib/PCP-server-Ruby-SDK/models/payment_link_specific_input.rb
 - lib/PCP-server-Ruby-SDK/models/payment_method_specific_input.rb
 - lib/PCP-server-Ruby-SDK/models/payment_method_specific_input_for_intent.rb
 - lib/PCP-server-Ruby-SDK/models/payment_output.rb
@@ -240,10 +248,11 @@ files:
 - lib/PCP-server-Ruby-SDK/models/payment_product5002_specific_input.rb
 - lib/PCP-server-Ruby-SDK/models/payment_product771_specific_output.rb
 - lib/PCP-server-Ruby-SDK/models/payment_product840_customer_account.rb
+- lib/PCP-server-Ruby-SDK/models/payment_product840_customer_account_for_intent.rb
 - lib/PCP-server-Ruby-SDK/models/payment_product840_specific_output.rb
-- lib/PCP-server-Ruby-SDK/models/payment_product840_specific_output_data.rb
 - lib/PCP-server-Ruby-SDK/models/payment_product840_specific_output_for_intent.rb
 - lib/PCP-server-Ruby-SDK/models/payment_references.rb
+- lib/PCP-server-Ruby-SDK/models/payment_references_for_payment_intent.rb
 - lib/PCP-server-Ruby-SDK/models/payment_references_for_refund.rb
 - lib/PCP-server-Ruby-SDK/models/payment_response.rb
 - lib/PCP-server-Ruby-SDK/models/payment_status_output.rb
@@ -314,6 +323,7 @@ files:
 - spec/endpoints/checkout_api_client_spec.rb
 - spec/endpoints/commerce_case_api_client_spec.rb
 - spec/endpoints/order_management_checkout_actions_api_client_spec.rb
+- spec/endpoints/pay_by_link_api_client_spec.rb
 - spec/endpoints/payment_execution_api_client_spec.rb
 - spec/endpoints/payment_information_api_client_spec.rb
 - spec/endpoints/payment_intent_api_client_spec.rb
@@ -322,6 +332,7 @@ files:
 - spec/errors/api_response_retrieval_exception_spec.rb
 - spec/models/api_definition_conformance_spec.rb
 - spec/models/model_base_spec.rb
+- spec/models/pay_by_link_models_spec.rb
 - spec/models/payment_intent_models_spec.rb
 - spec/models/required_field_validation_spec.rb
 - spec/queries/get_checkouts_query_spec.rb
@@ -355,23 +366,25 @@ 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/payment_information_api_client_spec.rb
-- spec/endpoints/payment_execution_api_client_spec.rb
+- spec/endpoints/base_api_client_spec.rb
 - spec/endpoints/commerce_case_api_client_spec.rb
+- spec/endpoints/payment_information_api_client_spec.rb
+- spec/endpoints/order_management_checkout_actions_api_client_spec.rb
+- spec/endpoints/pay_by_link_api_client_spec.rb
 - spec/endpoints/authentication_api_client_spec.rb
-- spec/endpoints/checkout_api_client_spec.rb
 - spec/endpoints/payment_intent_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/errors/api_response_retrieval_exception_spec.rb
 - spec/errors/api_error_response_exception_spec.rb
 - spec/errors/api_exception_spec.rb
-- spec/models/payment_intent_models_spec.rb
-- spec/models/model_base_spec.rb
 - spec/models/required_field_validation_spec.rb
 - spec/models/api_definition_conformance_spec.rb
-- spec/queries/get_checkouts_query_spec.rb
+- spec/models/payment_intent_models_spec.rb
+- spec/models/model_base_spec.rb
+- spec/models/pay_by_link_models_spec.rb
 - spec/queries/get_commerce_cases_query_spec.rb
+- spec/queries/get_checkouts_query_spec.rb
 - spec/request_header_generator_spec.rb
 - spec/spec_helper.rb
 - spec/transformer/apple_pay_transformer_spec.rb

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

@@ -1,11 +0,0 @@
-require_relative 'model_base'
-
-module PCPServerSDK
-  module Models
-    class PaymentProduct840SpecificOutputData < ModelBase
-      attribute :billing_address, :billingAddress, :Address
-      attribute :customer_account, :customerAccount, :PaymentProduct840CustomerAccount
-      attribute :pay_pal_transaction_id, :payPalTransactionId, :String
-    end
-  end
-end