Quick Start

    dependencies:
      flutter:
        sdk: flutter
      volume_sdk:
        git:
          url: https://<GIT_AUTHORIZATION>@github.com/getvolume/VolumePubDev.git
          ref: 2.5.0

import 'package:volume_sdk/volume_provider.dart';
 
void main() {
  const myApp = MyApp();
  VolumeProvider.init(
    VolumeSetup(
        applicationId: "", //provided by Volume
        volumeEnvironment: "sandbox",
        showSandboxBanks: true,
        maxPaymentAmount: "15000",
        minPaymentAmount: "1"),
        buttonCustomisation: const ButtonCustomization(),
        translations: {
          "en": const VolumeTranslations(
              accountHolderNameText: "Name and Surname"),
          "de": const VolumeTranslations(
              accountHolderNameText: "Name und Nachname"),
        },
        language: "en"),
        myApp
  );
  VolumeProvider.setLanguage("de") // Use this to change language in runtime
 
  runApp(myApp);
}

 
var merchantPaymentId = generateMerchantPaymentId();
 
  @override
  void initState() {
    super.initState();
    _volumeButtonEventListener = VolumeButtonEventListener((value) {
      setState(() {
        merchantPaymentId = value;
      });
    });
  }
 
VolumePaymentButtonWidget(
  merchantPaymentId: merchantPaymentId, // Generate new value each time navigateToPaymentConsent event is emitted
  reference: "Example Reference", // Generate new reference value each time navigateToPaymentConsent event is emitted
  amount: 50.0,
  isEnabled: true,
  currency: "GBP",
  country: "GB",
  volumeEventListener: volumeButtonEventListener,
  metadata: <String, dynamic>{
      "type": "shirt",
      "color": "black",
      "owner": {
        "position": "CTO",
        "description": "Very handsome man",
        "details": {
          "name": "John",
          "surname": "Doe",
        },
        "relatedItems": [
          { "itemName": "trousers", "color": "blue" },
          { "itemName": "shoes", "color": "white" },
        ],
      },
    },
)
 
String generateMerchantPaymentId()  {
  return "This should be unique value"; //TODO Get merchant Payment Id value from backend
}
 
class VolumeButtonEventListener implements VolumeEventListener {
  final void Function(dynamic value) onNavigateToPaymentConsent;
  const VolumeButtonEventListener(this.onNavigateToPaymentConsent );
 
  @override
  onEvent(VolumeEvent event) {
    switch (event.runtimeType) {
      case NavigateToPaymentConsent:
        onNavigateToPaymentConsent(generateMerchantPaymentId());
        return;
    }
  }
}

class VolumePaymentIdentifiersProvider extends PaymentIdentifiersProvider {
  @override
  Future<PaymentIdentifiers> providePaymentIdentifiers() async {
    var generatedPaymentIdentifiers = // Get MerchantPaymentId and Reference from the backend
        PaymentIdentifiers(merchantPaymentId: generatedPaymentIdentifiers.merchantPaymentId, reference: generatedPaymentIdentifiers.reference);
    return paymentIdentifiers;
  }
}
 
// Usage in the VolumePaymentButtonWidget
VolumePaymentButtonWidget(
  merchantPaymentId: merchantPaymentId,
  reference: reference,
  amount: amount,
  currency: currency,
  country: country,
  isEnabled: isEnabled,
  volumeEventListener: _volumeButtonEventListener,
  paymentIdentifiersProvider: VolumePaymentIdentifiersProvider(),
  metadata: const <String, dynamic>{
    // ... metadata
  },
)

<key>LSApplicationQueriesSchemes</key>
	<array>
		<string>BMBGB</string>
		<string>revolut</string>
		<string>natwestbank</string>
		<string>monzo</string>
		<string>santanderretail</string>
		<string>rbs</string>
		<string>lloyds-retail</string>
		<string>ukcomhsbcmobilebanking</string>
		<string>zappcfi437759</string>
		<string>hsbc-pwnwguti5z</string>
		<string>zapp</string>
		<string>launchAIB</string>
		<string>ie.aib.mobilebanking</string>
		<string>BOIOneAPP</string>
		<string>halifax-retail</string>
		<string>starlingbank</string>
		<string>tescobank</string>
		<string>tsbmobile</string>
		<string>sparda-app</string>
		<string>bankingappspardaproduktion</string>
		<string>secureappspardaproduktion</string>
		<string>sapp-pushtan</string>
		<string>sapp-invest</string>
		<string>de.sparda.securego</string>
		<string>bos-retail</string>
		<string>launchbca</string>
		<string>comfirstdirectbankingonthego</string>
		<string>cs-com.virginmoney.uk.mobile.ios</string>
		<string>transferwise</string>
		<string>ybssavings</string>
		<string>chase-international</string>
	</array>