[Android] Expose fulfillmentChange

[kiftio]

What changes are you making?

Adds support for the ec.fulfillment.change protocol event by introducing a fulfillmentChange notification descriptor to both EmbeddedCheckoutProtocol and CheckoutProtocol. This allows clients to register handlers for fulfillment change notifications and have them dispatched correctly when the event is received.

How to test

1. Register a handler for CheckoutProtocol.fulfillmentChange on a CheckoutProtocol.Client instance.
2. Send a message with method ec.fulfillment.change and verify the handler is invoked with the decoded Checkout payload.
3. Run the existing and newly added unit tests:
   • fulfillmentChange descriptor has correct method — verifies the method string is ec.fulfillment.change
   • process dispatches ec fulfillment change to registered handler — verifies end-to-end dispatch
   • embedded checkout fulfillment change descriptor decodes checkout notifications — verifies payload decoding

---

Before you merge

Important

• I've added tests to support my implementation
• I have read and agree with the Contribution Guidelines
• I have read and agree with the Code of Conduct
• I've updated the relevant platform README (platforms/swift/README.md and/or platforms/android/README.md)

---

Releasing a new Swift version?

• I have bumped the version in ShopifyCheckoutKit.podspec
• I have bumped the version in platforms/swift/Sources/ShopifyCheckoutKit/ShopifyCheckoutKit.swift
• I have updated platforms/swift/CHANGELOG.md
• I have updated the SwiftPM/CocoaPods version snippets in platforms/swift/README.md (major version only)

Releasing a new Embedded Checkout Protocol version?

• I have bumped embeddedCheckoutProtocolAndroid in platforms/android/gradle/libs.versions.toml
• I have updated protocol/languages/kotlin/embedded-checkout-protocol/api/embedded-checkout-protocol.api if the public API changed

Releasing a new Android version?

• I have bumped checkoutKitAndroid in platforms/android/gradle/libs.versions.toml
• I have updated platforms/android/CHANGELOG.md
• I have updated the Gradle/Maven version snippets in platforms/android/README.md

Tip

See the Contributing documentation for the full release process per platform.

[kiftio]

• [Android] Expose fulfillmentChange #340 : 2 dependent PRs (#288 , #342 ) 👈 (View in Graphite)
• [Android] Add support for ec_auth and ec_color_scheme #326
• [Android] Move url encoding to protocol #324
• [Android] publish packages independently #329
• [Android] extract checkout protocol module #315
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

React Native — Coverage Report

Lines	Statements	Branches	Functions
	91.66% (319/348)	87.86% (181/206)	100% (82/82)

[github-actions]

Package Size

Platform	Artifact	Base	Head	Delta
Android	release AAR	167.4 KiB	167.5 KiB	+85 B

Measured from the PR base SHA and PR head SHA. This comment reports package artifact sizes only; it is not a final app binary-size report.

[kiftio]

Merge activity

• Jun 25, 11:07 AM UTC: A user started a stack merge that includes this pull request via Graphite.
• Jun 25, 11:09 AM UTC: Graphite rebased this pull request as part of a merge.
• Jun 25, 11:25 AM UTC: @kiftio merged this pull request with Graphite.