onramper_flutter 1.1.2
onramper_flutter: ^1.1.2 copied to clipboard
Official Flutter plugin for the Onramper crypto on-ramp. Configures, initializes, and embeds a native SwiftUI checkout button. iOS-only, requires iOS 16+ and App Attest.
Changelog #
All notable changes to this project are documented in this file. This project adheres to Semantic Versioning and the Keep a Changelog format.
1.1.2 — License correction #
Changed #
- License updated from MIT to Apache License 2.0 to match the
React Native wrapper and the bundled
OnramperSDKiOS framework. - Added
NOTICEfile attributingOnramperSDK(Copyright 2026 Onramper Technologies B.V.) per Apache 2.0 redistribution terms.
1.1.1 — Mandatory security update #
Bumps the bundled OnramperSDK to v1.1.1. The upstream release notes describe this as required for continued operation of existing partner integrations, following a security enhancement in the headless-service backend.
Changed #
ios/onramper_flutter.podspec— pinned to OnramperSDK v1.1.1 (asset id492870955, sha25688235fa50561422ba3276f8008ff0a2229cff760f75f36f3f424ff5f26e2b2e2).
Plugin surface #
Unchanged. The v1.1.1 SDK adds a new EncryptedPayload type carried on internal CheckoutFinalizeRequest / CheckoutIntentResponse structs — neither is constructed or read by the plugin bridge, so no consumer-visible API changes.
1.1.0 — Initial public release #
First tagged release. Bundles OnramperSDK v1.1.0.
Added #
OnramperClient— configure → initialize → getCheckoutRequirements → observe, backed by both aChangeNotifierand broadcast streams.OnramperCheckoutButtonwidget — embeds the native SwiftUI checkout button via a Flutter platform view. Handles OnramperID login, requirement completion, finalize, and payment presentation entirely inside the native SDK.OnramperClient.getCheckoutRequirements(request, buttonStyle:)— optional per-intent styling (backgroundColor,foregroundColor,borderRadius) forwarded to the native button.OnramperClient.signOut()— clears cached OnramperID tokens while preserving the partner session.OnramperClient.cancelPreparedIntent(handle)— drops a specific stored native button by handle.CheckoutRequirementKind.reverification— surfaces provider-driven email/phone re-verification requirements.- Provider-lifecycle events:
checkoutCancelled,providerReady,paymentAuthorized,paymentProcessing,paymentCancelled,providerError(withproviderReasonstring). CheckoutFinalizeResponsepayload oncheckoutFinalizedevents for consumers that need the full finalize response (payment URL, render type, payment type, headless checkout id).OnramperErrorKind.securityTrustFailedwithhostpayload — distinct fromunrecoverablefor cert-pinning failures.AmountLimitRequirement.amountLimitSatisfied— boolean signal for "no consumer action needed".- Native SDK is fetched from a pinned release of
onramper/onramper-iosatpod installtime, sha256-verified. Removes the previously-vendored ~19 MB Git-LFS xcframework from the repo.
Requirements #
- Flutter 3.22+, Dart 3.4+
- iOS 16+ deployment target, App Attest capability, physical device for testing
- Export
ONRAMPER_IOS_READ_TOKENorGITHUB_TOKENatpod installtime to raise GitHub's anonymous rate limit from 60 to 5,000 requests/hour (optional)