Erste Schritte mit iOS SDK

Eigenschaften

Mit dem Trust Payments iOS SDK können Sie nahtlos eine vorgefertigte oder benutzerdefinierte Benutzeroberfläche in Ihre App integrieren, um Kartenzahlungen zu akzeptieren und das Starke Kundenauthentifizierung (SCA) Mandat zu erfüllen.

Verwenden Sie diese Integration, wenn Sie eine vorgefertigte "Drop-In"-UI benötigen, die die folgenden Funktionen unterstützt:

• Kartenzahlungen
• Tokenisierung Zahlungen
• Anpassung der UI-Komponenten an das Branding Ihres Unternehmens
• Gebietsschema und benutzerdefinierte Übersetzungen

Wenn Sie bereits Ihre eigenen Kassenansichten in Ihrer iOS-App erstellt haben, aber eine Methode zur Verarbeitung von Zahlungen an das Trust Payments Gateway benötigen, können Sie unsere Zahlungsverkehrsmanager API verwenden.

1. Installieren Sie das SDK in Ihrer Anwendung

Um das iOS SDK in Ihr Xcode Projekt einzubinden, müssen Sie einen der folgenden Abhängigkeitsmanager verwenden:

1. CocoaPods

CocoaPods ist ein Abhängigkeitsmanager für Cocoa Projekte. Anweisungen zur Verwendung und Installation finden Sie auf der Website des Unternehmens. Um Trust Payments SDK in Ihr Xcode Projekt mit CocoaPods zu integrieren, geben Sie es in Ihrem Podfile wie folgt an:

pod 'TrustPayments'

2. Carthage

Carthage ist ein dezentraler Abhängigkeitsmanager, der die notwendigen Abhängigkeiten erstellt und Ihnen binäre Frameworks zur Verfügung stellt. Um Trust Payments SDK mit Carthage in Ihr Xcode zu integrieren, geben Sie es wie folgt in Ihrem Cartfile an:

git "https://gitlab.com/trustpayments-public/mobile-sdk/ios"

Sobald Sie Carthage installiert haben, können Sie damit beginnen, Frameworks zu Ihrem Projekt hinzuzufügen. Klicken Sie hier, um zu erfahren, wie.

2. Initialisieren Sie das iOS SDK in Ihrer App

Konfigurieren Sie die Instanz

Bevor Sie eine Zahlungsanforderung durchführen können, müssen Sie die username, gateway und environment, wie im folgenden Beispiel gezeigt:

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

Ansicht Steuergeräte

Das folgende Beispiel zeigt, wie Sie einen Drop-In View Controller erstellen, der nur die erforderlichen Felder verwendet:

let dropInVC = try ViewControllerFactory.shared.dropInViewController(
  jwt: jwt,
  payButtonTappedClosureBeforeTransaction: {
    (controller: DropInController) in
  },
  transactionResponseClosure: {
    (
      jwt: [String],
      transactionResult: TPAdditionalTransactionResult?,
      error: APIClientError?
    )
    in
  }
)

Karte Eingabefelder

Als Alternative zu unserem Drop-In View Controller bieten wir Integratoren die Möglichkeit, individuelle Kartenkomponenten für PAN, Verfallsdatum und Sicherheitscode zu erstellen. Sie können diese Komponenten in Ihren bereits vorhandenen View Controller für die Zahlungskontrolle einfügen, wie unten gezeigt:

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

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

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

Dann hören Sie auf CardNumberInput und passen Sie den Sicherheitscode so an, dass er die erforderliche Anzahl von Ziffern für die gegebene Karte widerspiegelt:

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

Sobald der Kunde auf die Schaltfläche "Bezahlen" geklickt hat, müssen Sie eine Instanz unseres SDKs erstellen paymentTransactionManager erstellen und die Methode performTransaction aufrufen, wie im nächsten Schritt gezeigt.

Zahlungsverkehrsmanager

Wenn Sie beabsichtigen, unsere individuellen Kartenkomponenten zu verwenden, wie oben erwähnt, oder wenn Sie bereits Ihre eigenen Karteneingaben für die Zahlungskasse haben bzw. dies beabsichtigen, aber eine Methode zur Verarbeitung von Zahlungen an das Trust Payments Gateway benötigen, können Sie unsere Transaktionsmanager-API verwenden.

let paymentTransactionManager = try PaymentTransactionManager(jwt: .empty)

paymentTransactionManager.performTransaction(jwt: jwt, card: card, transactionResponseClosure: {jwt, transactionResult, error in})

Sobald Sie eine Instanz des paymentTransactionManagererstellt haben, können Sie dessen Methode performTransaction aufrufen, um eine Zahlungsanforderung zu stellen. Beim Aufruf von performTransaction müssen Sie die folgenden Parameter beachten:

Card(cardNumber: 
	CardNumber(rawValue: "4111111111111111"),
	cvv: CVV(rawValue: "123"),
	expiryDate: ExpiryDate(rawValue: "12/2026")
)

3. Webhooks konfigurieren

Es wird dringend empfohlen, dass Sie Webhooks für Ihre Mobile SDK-Lösung konfigurieren. Wenn diese konfiguriert sind, wird URL-Benachrichtigungen an Ihr System gesendet, wenn Zahlungen auf Ihrem Konto verarbeitet werden.

1. Melden Sie sich auf Portal an.
   
   
2. Suchen Sie nach Ihrem sitereference über das Suchfeld oben auf der Seite.
   
   
3. Wenn Sie die Details Ihrer Website anzeigen, klicken Sie auf "Regel-Manager".
   
   
   
   
4. Wählen Sie die Aktionsart "URL-Benachrichtigung" aus der Dropdown-Liste und Ihr Browser wird umgeleitet.
   
   
   
   
5. Erstellen Sie eine neue Regel URL-Benachrichtigung :
   • (A) Klicken Sie auf "Add new condition" und geben Sie die Umstände an, unter denen die URL-Benachrichtigung nach einer Transaktion ausgelöst werden soll. Vergewissern Sie sich, dass in dem angezeigten Feld "Anforderungen" die Option "AUTH" angekreuzt ist (d. h. die Benachrichtigung wird nach einer Zahlung ausgelöst Genehmigungen).
     Klicken Sie hier, um mehr über die Konfiguration von Bedingungen zu erfahren.
   • (B) Klicken Sie auf "Add new action" und geben Sie den Endpunkt für die URL-Benachrichtigung an.
     Klicken Sie hier, um mehr über URL-Benachrichtigung Aktionen zu erfahren.
   • (C) Weisen Sie der Aktion über die Dropdown-Felder die Bedingung zu und klicken Sie auf "Create rule".
     
     
   
   
   
6. Stellen Sie sicher, dass die Regel aktiv ist (dies wird durch ein Häkchen unter dem Feld Aktiv Spalte). Sobald die Regel aktiviert ist, wird sie auf alle Zahlungsvorgänge für die angegebene sitereference, und die URL-Benachrichtigung wird ausgelöst, sobald die angegebene Bedingung erfüllt ist.
   
   Hinweis: Alle neuen Regeln sollten auf Ihrem Testsystem erstellt werden sitereference und getestet, um sicherzustellen, dass sie wie erwartet funktionieren, bevor sie in Ihr Live-System aufgenommen werden sitereference.
   
   
7. Sie muss Ihr System so konfigurieren, dass es auf alle URL-Benachrichtigungen , die von Trust Payments empfangen werden, mit einer HTTP 200 OK Antwort.
   Zum Beispiel: "HTTP/1.0 200 OK".
   Ihr System muss innerhalb von 8 Sekunden nach Erhalt einer Benachrichtigung antworten.