trusted_shops_flutter #

Unofficial Flutter plugin that embeds the official Trusted Shops Android SDK and Trusted Shops iOS SDK so you can show the Trustbadge and offer buyer protection from Dart.

This package is not affiliated with Trusted Shops AG. The native SDKs stay proprietary; you still need a Trusted Shops mobile-app contract and per-market integration IDs.

Trusted Shops documents native Android/iOS only. This plugin is a community bridge via Flutter platform views.

Requirements #

Install #

dependencies:
  trusted_shops_flutter: ^0.1.0

flutter pub add trusted_shops_flutter

Android #

No extra Gradle repositories are required (mavenCentral() is enough). Use FlutterFragmentActivity so the Compose Trustbadge can attach a lifecycle:

import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity : FlutterFragmentActivity()

Set minSdk to at least 29.

iOS #

Raise the deployment target to 17.0. Keep Flutter Swift Package Manager enabled so the plugin can pull trustedshops-public/ios-sdk.

Apps that disable SwiftPM (CocoaPods only) cannot resolve the official iOS SDK.

Usage #

import 'package:trusted_shops_flutter/trusted_shops_flutter.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await TrustedShops.start(
    defaultMarket: TrustedShopsMarket.deu,
    integrationIds: {
      TrustedShopsMarket.deu: const String.fromEnvironment(
        'TRUSTED_SHOPS_INTEGRATION_ID_DE',
      ),
    },
    loggingEnabled: kDebugMode,
  );
  runApp(const MyApp());
}

Show the badge anywhere:

const TrustbadgeView(
  layout: TrustbadgeLayout.horizontal,
  height: 72,
)

Buyer protection after checkout (show a TrustbadgeView first so shop data can load):

await TrustedShops.initiateCheckout(
  TrustedShopsOrder(
    shopOrderId: 'ORDER-123',
    email: 'buyer@example.com',
    amount: 59.99,
    currency: TrustedShopsCurrency.eur,
    products: const [
      TrustedShopsProduct(name: 'Wireless Headphones', sku: 'WH-001'),
    ],
  ),
);

Integration IDs #

The mobile SDKs do not use the classic website TSID. Trusted Shops issues a separate integration ID per market after the mobile-app addendum / risk assessment. See How do I use Trusted Shops in my mobile app?.

Native SDK versions #

• Android: com.trustedshops.android.sdk:trustedshops-sdk:1.2.6
• iOS: Swift package trustedshops_ios_sdk from 1.2.6

License #

BSD-3-Clause for this wrapper. The official Trusted Shops SDKs have their own proprietary licenses.