Aan de slag met iOS SDK

Kenmerken

Met de Trust Payments iOS SDK kun je naadloos een vooraf gebouwde of aangepaste UI in je app integreren om kaartbetalingen te accepteren en te voldoen aan het Strong Customer Authentication (SCA) mandaat.

Gebruik deze integratie als u een vooraf gebouwde "Drop-In" UI nodig hebt die de volgende functies ondersteunt:

• Kaartbetalingen
• tokenisatie betalingen
• Aanpassing van UI-componenten aan de huisstijl van uw bedrijf
• Lokale en aangepaste vertalingen

Als u al uw eigen betaalkassaweergaven in uw iOS app hebt gebouwd, maar een methode nodig hebt om betalingen aan de Trust Payments gateway te verwerken, kunt u onze Beheerder van betalingstransacties API gebruiken.

  Klik hier voor meer informatie.

1. Installeer de SDK in uw app

Om de iOS SDK in te sluiten in je Xcode project, moet je Cocoapods gebruiken:

1. CocoaPods

CocoaPods is een afhankelijkheidsbeheerder voor Cocoa projecten. Ga voor gebruiks- en installatie-instructies naar hun website. Om Trust Payments SDK te integreren in je Xcode project met CocoaPods, moet je het als volgt specificeren in je Podfile :

Replace '<TOKEN>' with the CARDINAL_TOKEN received from our Technical Support team.

pod 'CardinalMobile', :git => "https://oauth2:<TOKEN>@gitlab.com/securetrading-gl/software-development-kit/cardinal-sdk-ios", :tag =>'2.2.5-7'

Voeg aan het einde van de Podfile het volgende toe:

post_install do |installer|
 installer.pods_project.targets.each do |target|
  target.build_configurations.each do |config|
   config.build_settings['CODE_SIGNING_ALLOWED'] ='NO'
   config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = "12.0"
  end
  if target.name == "TrustPayments"
   all_filerefs = installer.pods_project.files
   all_filerefs.each do |fileref|
    if fileref.path.end_with?"CardinalMobile.xcframework"
     build_phase = target.frameworks_build_phase
     unless build_phase.files_references.include?(fileref)
      build_phase.add_file_reference(fileref)
     end
    end
   end
  end
 end
end

Ga in de Terminal naar je projectmap en voer het commando uit:

pod install

2. Initialiseer de iOS SDK in uw app

De instantie configureren

Voordat u een betalingsverzoek kunt uitvoeren, moet u de username, gateway en environment, zoals in onderstaand voorbeeld:

import TrustPaymentsCore
TrustPayments.instance.configure(
  username: username_from_trustpayments,
  gateway: .eu,
  environment: .staging,
  translationsForOverride: nil
)

Controllers bekijken

Hieronder volgt een voorbeeld van hoe je een Drop-In View Controller maakt met alleen de vereiste velden:

import TrustPaymentsUI
do {
    let dropInVC = try ViewControllerFactory.shared.dropInViewController(jwt: signedJWT, payButtonTappedClosureBeforeTransaction: nil, transactionResponseClosure: { jwt, result, error in
        // Handle transaction response
    }).viewController
    // Present drop in view. E.g.
    navigationController?.pushViewController(dropInVC, animated: true)
} catch {
    // Handle initialization error
}

	Parameter	Beschrijving
	cardinalDarkModeStyleManager	Specificeert de licht/donker modus voor de ACS weergave (3-D Secure).
	cardinalStyleManager	Specificeert de interfacestijl voor de ACS-weergave (3-D Secure).
	customDropInView	DropInViewProtocol compliant view voor aanvullende weergaven, bijvoorbeeld voor het toevoegen van een fooi aan een betaling.
	dropInViewDarkModeStyleManager	Specificeert de licht/donker-modus voor de Drop-In View Controller.
	dropInViewStyleManager	Wordt gebruikt om de Drop-In View Controller aan te passen.
	jwt	Het ondertekende JWT. Klik hier om te leren hoe u het JWT genereert.
	payButtonTappedClosureBeforeTransaction	Sluiting geactiveerd door het indrukken van de betaalknop (vlak voor de transactie - u kunt deze sluiting gebruiken om het JWT-token bij te werken) U kunt deze sluiting gebruiken om het JWT-token bij te werken door de updateJWT() functie op de controller die als argument wordt doorgegeven.
	transactionResponseClosure	Sluiting die wordt geactiveerd wanneer de transactie is voltooid, met de volgende eigenschappen: JWT-sleutelarray met antwoorden van alle verzoeken (de handtekening van elke sleutel moet worden geverifieerd vóór het decoderen). Een object dat 3-D Secure authenticatiegegevens bevat die met het AUTH verzoek worden verzonden. Een foutobject dat aangeeft of er fouten zijn opgetreden bij de verbinding met de gatewayserver of tijdens de authenticatie op 3-D Secure .

Het volgende is een alternatief voorbeeld van hoe een Drop-In View Controller kan worden gemaakt met meer optionele parameters:

import TrustPaymentsUI
do {
    let dropInVC = try ViewControllerFactory.shared.dropInViewController(jwt: signedJwt, customDropInView: customView, visibleFields: [.expiryDate], dropInViewStyleManager: dropInViewStyleManager, dropInViewDarkModeStyleManager: dropInViewDarkModeStyleManager, cardinalStyleManager: cardinalStyleManager, cardinalDarkModeStyleManager: cardinalDarkModeStyleManager, payButtonTappedClosureBeforeTransaction: { dropInViewController in
        // Perform any action before the transaction is started
        // such as updating the JWT
    }, transactionResponseClosure: { jwt, result, error in
        // Handle transaction result
    }).viewController
    // Present the Drop-In view
    navigationController?.pushViewController(dropInVC, animated: true)
} catch {
    // Handle initialization error
}

Gewoon kaartinvoerveld

Hieronder wordt gedemonstreerd hoe u kaartdetailinvoerweergaven kunt maken zonder verzoeken te doen:

Het creëren van afzonderlijke UI componenten:

lazy var cardNumberInput: CardNumberInputView = {
  CardNumberInputView(inputViewStyleManager: inputViewStyleManager)
}()

lazy var expiryDateInput: ExpiryDateInputView = {
  ExpiryDateInputView(inputViewStyleManager: inputViewStyleManager)
}()

lazy var cvvInput: CVVInputView = {
  CVVInputView(inputViewStyleManager: inputViewStyleManager)
}()

Luister dan naar CardNumberInput en de beveiligingscode aanpassen aan het vereiste aantal cijfers voor de gegeven kaart:

extension SingleInputView: CardNumberInputViewDelegate {
  func cardNumberInputViewDidComplete(_ cardNumberInputView: CardNumberInputView) {
    cvvInput.cardType = cardNumberInputView.cardType
    cvvInput.isEnabled = cardNumberInputView.isCVVRequired
  }

  func cardNumberInputViewDidChangeText(_ cardNumberInputView: CardNumberInputView) {
    cvvInput.cardType = cardNumberInputView.cardType
    cvvInput.isEnabled = cardNumberInputView.isCVVRequired
  }
}

Beheerder van betalingstransacties

Als u al uw eigen betaalkassaweergaven in uw iOS app hebt / van plan bent te bouwen, maar een methode nodig hebt om betalingen aan de Trust Payments gateway te verwerken, kunt u onze transactiemanager-API gebruiken.

import TrustPaymentsCore
do {
 let paymentTransactionManager = try PaymentTransactionManager(jwt: .empty)
    paymentTransactionManager.performTransaction(jwt: signedJwt, card: card) { jwt, result, error in
        // Handle transaction result
    }
} catch {
    // Handle initialization error
}

3. Webhooks configureren

Het wordt sterk aanbevolen om webhooks te configureren op uw Mobile SDK-oplossing. Indien geconfigureerd, wordt URL-kennisgevingen naar uw systeem gestuurd wanneer betalingen op uw rekening worden verwerkt.

1. Aanmelden bij Portal.
   
   
2. Zoek naar uw sitereference met behulp van het zoekvak bovenaan de pagina.
   
   
3. Wanneer u de details van uw site bekijkt, klikt u op "Regelbeheer".
   
   
   
   
4. Selecteer het actietype "URL-kennisgeving" uit het keuzemenu en uw browser wordt omgeleid.
   
   
   
   
5. Maak een nieuwe URL-kennisgeving regel aan:
   • (A) Klik op "Add new condition" en specificeer de omstandigheden waarin de URL-kennisgeving moet worden geactiveerd na een transactie. Zorg ervoor dat in het weergegeven vak Verzoeken "AUTH" is aangevinkt (wat betekent dat de kennisgeving wordt geactiveerd na een betaling authorisaties).
     Klik hier voor meer informatie over het configureren van voorwaarden.
   • (B) Klik op "Add new action" en specificeer het eindpunt voor de URL-kennisgeving.
     Klik hier voor meer informatie over URL-kennisgeving acties.
   • (C) Wijs via de vervolgkeuzelijsten de voorwaarde toe aan de actie en klik op "Create rule".
     
     
   
   
   
6. Zorg ervoor dat de regel actief is (dit wordt aangegeven met een vinkje onder het Actief kolom). Na activering wordt de regel toegepast op alle betalingssessies voor de opgegeven sitereference, en de URL-kennisgeving wordt geactiveerd wanneer aan de gespecificeerde voorwaarde wordt voldaan.
   
   Opmerking: Alle nieuwe regels moeten worden aangemaakt op je test sitereference en getest om er zeker van te zijn dat ze werken zoals verwacht voordat ze worden toegevoegd aan uw live sitereference.
   
   
7. Jij moet configureer uw systeem om te reageren op alle URL-kennisgevingen ontvangen van Trust Payments met een HTTP 200 OK antwoord.
   Bijvoorbeeld: "HTTP/1.0 200 OK".
   Uw systeem moet binnen 8 seconden na ontvangst van een melding antwoorden.