Skip to content

Releases: checkout/checkout-sdk-net

5.0.0

16 Apr 08:42
ebccfe8

Choose a tag to compare

Release - 5.0.0 (#546)

This release introduces .NET 8 support across the SDK, updates related dependencies and build/test workflows, and makes a breaking change to the Agentic Commerce API by renaming a key method. It also includes minor test improvements and some conditional compilation cleanup.

.NET 8 Support and Build/Dependency Updates

  • Added .NET 8 (net8.0) as a target framework to both CheckoutSdk and CheckoutSdk.Extensions projects, and updated their dependencies to include .NET 8 compatible packages. (src/CheckoutSdk/CheckoutSdk.csproj, src/CheckoutSdk.Extensions/CheckoutSdk.Extensions.csproj) [1] [2] [3] [4]
  • Updated global.json to use .NET SDK version 8.0.420.
  • Updated all GitHub Actions workflows to include .NET 8 in their build and test matrices. (.github/workflows/build-master.yml, .github/workflows/build-pull-request.yml, .github/workflows/build-release.yml, .github/workflows/codeql-analysis.yml) [1] [2] [3] [4] [5] [6]

Conditional Compilation and Logging

  • Updated preprocessor directives throughout the codebase to use NET5_0_OR_GREATER || NETSTANDARD2_0 instead of legacy combinations, ensuring correct logging and dependency usage for .NET 8 and simplifying multi-targeting logic. (src/CheckoutSdk/AbstractCheckoutSdkBuilder.cs, src/CheckoutSdk/ApiClient.cs, src/CheckoutSdk/LogProvider.cs, src/CheckoutSdk/OAuthSdkCredentials.cs) [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

Agentic Commerce API Breaking Change

  • Renamed the method CreateDelegatedPayment to CreateDelegatedPaymentToken in both AgenticCommerceClient and IAgenticCommerceClient, and updated all related tests and usages accordingly. [1] [2] [3] [4] [5] [6] [7]

Test Improvements

  • Updated integration tests to use .ShouldNotBe(default) instead of .ShouldNotBeNull() for value types, improving the accuracy of assertions. (test/CheckoutSdkTest/Accounts/AccountsIntegrationTest.cs, test/CheckoutSdkTest/AgenticCommerce/AgenticCommerceIntegrationTest.cs) [1] [2] [3] [4]

Package Reference Conditions

  • Improved conditional package references for legacy frameworks in CheckoutSdk.csproj to avoid unnecessary dependencies for newer targets.

These updates ensure the SDK is compatible with the latest .NET ecosystem, improve CI reliability, and clarify API usage for Agentic Commerce.

4.24.0

13 Apr 14:46
95f6562

Choose a tag to compare

Release 4.24.0 (#543)

Changes:

  • Fix correct AccountHolder type and add missing fields to RequestIdSource and RequestCardSource
  • Add PaymentRouting, PaymentSubscription and missing fields to PaymentRequest
  • Update Card Metadata module: new fields, XML docs, and tests
  • Fix balance predicates to refund integration tests to prevent flaky assertions

4.23.0

09 Apr 08:42
cd5d8cf

Choose a tag to compare

Release 4.23.0 (#538)

Changes:

  • Add Agentic Commerce endpoint support with delegated payment operations
  • Add Compliance Requests endpoint support (get details and respond)
  • Add Google Pay endpoint support (enrollment, domain registration and listing)
  • Add Digital Cards support to Issuing module
  • Update Payment Setups and Flow models (Billing, AccommodationData, Paypal, and more)
  • Update Authentication client with session headers support
  • Wire up new clients in CheckoutApi/ICheckoutApi and update common infrastructure

4.22.2

13 Mar 13:00
9a7dea0

Choose a tag to compare

Release - 4.22.2 (#535)

  • PaymentMethodConfiguration applepay and googlepay serialization fixes in HPP module
  • PaymentMethodConfiguration, added stored field card in HPP module

4.22.1

12 Mar 15:37
639a3c9

Choose a tag to compare

Release - 4.22.1 (#533)

This release introduces several improvements and refactors across the SDK, focusing on enhanced API flexibility, improved type safety, and better test reliability. The most significant changes include updates to API methods for custom headers, improvements to file handling and type safety, and adjustments to test coverage due to upstream issues.

API flexibility and header support

  • Added support for custom headers to the Patch method in ApiClient and its interface, allowing API calls to include additional headers when needed. (src/CheckoutSdk/ApiClient.cs, src/CheckoutSdk/IApiClient.cs, [1] [2] [3]
  • Updated AccountsClient methods (UpdatePaymentInstrument, UploadFile, RetrieveFile) to leverage new header support and correct entity path usage, improving API consistency and extensibility. (src/CheckoutSdk/Accounts/AccountsClient.cs, [1] [2] [3]

Type safety and file handling improvements

  • Changed the Purpose property in FileDetailsResponse to use the strongly-typed AccountsFilePurpose instead of a plain string, improving type safety and clarity. (src/CheckoutSdk/Files/FileDetailsResponse.cs, src/CheckoutSdk/Files/FileDetailsResponse.csL23-R24)
  • Enhanced AccountsFilePurpose with implicit conversions, equality overrides, and ToString, facilitating easier and safer usage throughout the codebase. (src/CheckoutSdk/Accounts/AccountsFilePurpose.cs, [1] [2]

Payment method configuration and enum consistency

  • Updated PaymentMethod enum and PaymentMethodConfiguration to use consistent naming and serialization for applepay and googlepay, ensuring correct mapping and compatibility with API expectations. (src/CheckoutSdk/HandlePaymentsAndPayouts/Flow/Entities/PaymentMethod.cs, [1]; src/CheckoutSdk/HandlePaymentsAndPayouts/Flow/Entities/PaymentMethodConfiguration.cs, [2] [3] [4]

Test reliability and coverage

  • Temporarily skipped multiple integration tests in AccountsIntegrationTest due to upstream API issues (503 errors), preventing false negatives and maintaining CI reliability. (test/CheckoutSdkTest/Accounts/AccountsIntegrationTest.cs, [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

Miscellaneous improvements

  • Changed the Gender property in DocumentDetails to use the nullable Gender enum instead of a string, improving type safety. (src/CheckoutSdk/Identities/Entities/DocumentDetails.cs, src/CheckoutSdk/Identities/Entities/DocumentDetails.csL63-R63)
  • Removed the unused UpdatedCard class from StandaloneAccountUpdater responses, cleaning up the codebase. (src/CheckoutSdk/StandaloneAccountUpdater/Responses/UpdatedCard.cs, src/CheckoutSdk/StandaloneAccountUpdater/Responses/UpdatedCard.csL1-L37)

These changes collectively enhance the SDK's robustness, maintainability, and developer experience.

4.22.0

25 Feb 15:44
cbf6d63

Choose a tag to compare

Release - 4.22.0 (#531)

Added new endpoints support in Issuing module:

  • Issuing Control Groups
  • Issuing Disputes
  • Accounts Reserve Rules

4.21.0

25 Feb 11:11
c3c47b7

Choose a tag to compare

Release 4.21.0 - Identities modules support (#529)

Developed new Identities support (27 methods)
- Applicants
- Identity Verification
- AML Screening
- Face Authentication
- ID Document Verification

4.20.0

19 Feb 14:53
9c0ce27

Choose a tag to compare

Release - 4.20.0 (#527)

New features included:
- ApplePay Client with all endpoints
- PaymentMethods Client with all endpoints
- StandaloneAccountUpdater Client with all endpoints

4.19.0

03 Feb 16:37
c7541d1

Choose a tag to compare

Version 4.19.0 - Update existing clients with missing endpoints (#521)

  • Updated ForwardClient, IssuingClient and PaymentsClient with all missing methods
  • New FormUrlEncodedContent option for APIClient SendRequestAsync

4.18.0

30 Jan 09:10
12650af

Choose a tag to compare

Release 4.18.0 (#519)

  • New Payment Flow API client to the SDK
  • Merchant-specific DNS names Support for access