Quick Start

   platform :ios, '14.0'
    source 'https://github.com/CocoaPods/Specs.git'
    source 'https://' + ENV['GIT_AUTHORIZATION'] + '@github.com/getvolume/VolumePods.git'
 
    target 'SampleApp' do
      use_frameworks!
      pod 'Alamofire'
      pod 'VolumePayComponent', '2.5.0'
    end

   export GIT_AUTHORIZATION=volume-public:github_pat_72A4HWM8I0LwB3_T0kenProv1dedByV0lume__V3o9ZRvFBM5cmENW8vf8ES365KNJ7b6u7gY1

import VolumePayComponent
 
@main
struct ExampleApp: App {
 
    init() {
        do {
            try volumeProvider.initialize(
                    volumeSetup: VolumeSetup(
                            applicationId: "", //provided by Volume
                            volumeEnvironment: "sandbox",
                            volumeEventListener: DefaultVolumeEventListener { message in
                                debugPrint(message)
                            },
                            showSandboxBanks: true,
                            maxPaymentAmount: 15000,
                            minPaymentAmount: 1,
                            volumeTranslations: [ // Optional parameter
                                "DE": VolumeTranslations(buttonText: "Bezahlen mit",
                                        headingText: "Bezahlen Sie mit Ihrer Banking-App",
                                        modalTitleText: "Bank-App auswählen",
                                        modalSubtitleText: "Ihre Zahlung ist durch die Sicherheit Ihrer Bank geschützt",
                                        moreBanksText: "+ mehr",
                                        selectBankButtonText: "Wählen Sie zum Bezahlen die Bank-App aus",
                                        payerDetailsText: "Bitte geben Sie Ihre Daten ein:",
                                        accountHolderNameText: "Vorname und Nachname",
                                        ibanText: "IBAN",
                                        continueInBankText: "Weiter in der Bank-App")
                            ]
                    )
            )
        } catch {
            debugPrint(error)
        }
    }
 
    class DefaultVolumeEventListener: VolumeEventListener {
        let showEvent: (String) -> ()?
 
        init(showToast: @escaping (String) -> ()?) {
            showEvent = showToast
        }
 
        func onEvent(event: VolumeEvent) {
            showEvent(event.description)
        }
    }
 
    var body: some Scene {
        WindowGroup {
            ExampleAppView()
        }
    }
}

 
 struct ExampleAppView: View {
 
    @State private var currency: String = "EUR"
    @State private var country: String = "DE"
    @State private var language: LanguageCode = "EN"
    @State private var merchantPaymentId: String = generateMerchantPaymentId()
 
    var body: some View {
        let volumeButtonEventListener: VolumeEventListener = DefaultVolumeButtonEventListener { event in
            switch event {
            case .navigateToPaymentConsent:
                self.merchantPaymentId = generateMerchantPaymentId()
            default: break
            }
        }
 
        return VStack {
            VolumeButtonComponent(
                    amount: 0.1,
                    reference: "Example Reference", // Generate new reference value each time navigateToPaymentConsent event is emitted
                    currency: $currency,
                    country: $country,
                    merchantPaymentId: merchantPaymentId, // Generate new value each time navigateToPaymentConsent event is emitted
                    isEnabled: true,
                    language: $language // Optional parameter
                    volumeButtonEventListener: volumeButtonEventListener,
                    metadata: [
                         "type": "shirt",
                         "color": "black",
                         "owner": [
                             "position": "CTO",
                             "description": "A tall guy",
                             "details": [
                                 "name": "John",
                                 "surname": "Doe",
                             ],
                         ],
                         "relatedItems": [
                             [ "itemName": "trousers", "color": "blue"],
                             [ "itemName": "shoes", "color": "white"],
                         ]
                    ]
            )
                    .padding(.horizontal, 15.0)
                    .padding(.vertical, 50)
        }
    }
}
 
func generateMerchantPaymentId() -> String {
    "This should be unique value" //TODO Get merchant Payment Id value from backend
}
 
class DefaultVolumeButtonEventListener: VolumeEventListener {
    let onEvent: (VolumeEvent) -> ()?
 
    init(onEventAction: @escaping (VolumeEvent) -> ()?) {
        onEvent = onEventAction
    }
 
    func onEvent(event: VolumeEvent) {
        onEvent(event)
    }
}

class VolumePaymentIdentifiersProvider: PaymentIdentifiersProvider {
    func providePaymentIdentifiers() async throws -> PaymentIdentifiers {
        // Get MerchantPaymentId and Reference from the backend
        let merchantPaymentId = generateMerchantPaymentId()
        let reference = generateReference()
        return PaymentIdentifiers(merchantPaymentId: merchantPaymentId, reference: reference)
    }
}
 
// Usage in the VolumePaymentButtonView
VolumeButtonComponent(
        amount: 0.1,
        reference: "Example Reference", // will be overridden by paymentIdentifiersProvider
        currency: $currency,
        country: $country,
        merchantPaymentId: merchantPaymentId, // will be overridden by paymentIdentifiersProvider
        isEnabled: true,
        language: $language // Optional parameter
        volumeButtonEventListener: volumeButtonEventListener,
        paymentIdentifiersProvider: VolumePaymentIdentifiersProvider()
)

<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>