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.7.1'
    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"],
                         ]
                    ],
                    merchantProvidedPayerDetails: MerchantProvidedPayerDetails(
                        email: "john.doe@example.com",
                        name: "John Doe",
                        phone: "+44 20 7946 0958",
                        account: PayerAccount(
                            holderName: "John Doe",
                            accountNumber: "12345678",
                            sortCode: "123456",
                            iban: "DE89370400440532013000"
                        ),
                        address: PayerAddress(
                            addressLine1: "123 Main Street",
                            addressLine2: "Apt 4B",
                            countryCode: "GB",
                            town: "London",
                            postCode: "SW1A 1AA"
                        ),
                        useForUxFlowOptimisation: true
                    )
            )
                    .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 -> PaymentIdentifiers {
        do {
            let merchantPaymentIdFromBackend = "123" // Get merchant Payment Id from backend
            let referenceFromBackend = "ref123" // Get reference from backend
            let generatedPaymentIdentifiers = PaymentIdentifiers(
                merchantPaymentId: merchantPaymentIdFromBackend,
                reference: referenceFromBackend
            )
            return generatedPaymentIdentifiers
        } catch {
            // Return result with error message in case of exception
            // If errorMessage is not null then it will be displayed to the user as an error message
            return PaymentIdentifiers(
                merchantPaymentId: "",
                reference: "",
                errorMessage: error.localizedDescription
            )
        }
    }
}
 
// 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()
)

  VolumeButtonComponent(
 // other parameters
      merchantProvidedPayerDetails: MerchantProvidedPayerDetails(
          email: "john.doe@example.com",
          name: "John Doe",
          phone: "+44 20 7946 0958",
          account: PayerAccount(
              holderName: "John Doe",
              accountNumber: "12345678",
              sortCode: "123456",
              iban: "DE89370400440532013000"
          ),
          address: PayerAddress(
              addressLine1: "123 Main Street",
              addressLine2: "Apt 4B",
              countryCode: "GB",
              town: "London",
              postCode: "SW1A 1AA"
          ),
          useForUxFlowOptimisation: true
      )
  )

PayerAccount(
  holderName: "John D.",
  iban: "DE89370400440532013000",
  accountNumber: null,
  sortCode: null,
)

PayerAccount(
  holderName: "John D.",
  accountNumber: "12345678",
  sortCode: "123456",
  iban: null,
)

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