Tokenisierung für Android SDK

Mit unserem Mobile SDK können Sie es wiederkehrenden Kunden ermöglichen, Zahlungen über Ihre App abzuwickeln, ohne dass sie ihre Kartendaten erneut eingeben müssen. Dies führt nicht nur zu schnelleren und einfacheren Zahlungen für Ihre Kunden, sondern Ihr Unternehmen profitiert auch davon, dass Sie keine sensiblen Kartennummern speichern müssen (dies kann Ihren PCI-Akkreditierungsprozess vereinfachen).

Dieser Vorgang wird Tokenisierung genannt.

Voraussetzungen

• Account Checks werden von Händlern mit einem Trust Payments Acquiring-Konto unterstützt. Wenn Sie eine andere Acquiring-Bank verwenden, müssen Sie unser Support-Team kontaktieren, um zu prüfen, ob diese Funktion unterstützt wird, bevor Sie fortfahren.
• Account Checks kann nur bei kartenbasierten Zahlungsmitteln durchgeführt werden.

Konfiguration für die Speicherung von Zahlungsnachweisen

Konfigurieren Sie das JWT

Sie müssen sicherstellen, dass Ihre JWT payload umfasst die folgenden Felder:

Feldspezifikation

	Feld	Format	Beschreibung
	credentialsonfile	Numerisch (1)	Dies muss auf "1" gesetzt werden, um anzuzeigen, dass der Kunde damit einverstanden ist, dass die Zahlungsdaten für zukünftige Transaktionen gespeichert werden. Siehe unten für weitere Informationen.
	requesttypedescriptions	Liste	Wenn Sie eine Zahlung bearbeiten, übermitteln Sie: [“THREEDQUERY”,”AUTH”] Wenn nicht eine Zahlung bearbeiten, einreichen: [“THREEDQUERY”,”ACCOUNTCHECK”] Klicken Sie hier, um mehr zu erfahren.

{
  "payload": {
    "accounttypedescription": "ECOM",
    "baseamount": "1050",
    "credentialsonfile": "1",
    "currencyiso3a": "GBP",
    "requesttypedescriptions":["THREEDQUERY","AUTH"],
    "sitereference": "test_site12345",
    "termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener"

  },
  "iat": 1559033849,
  "iss": "jwt.user"
}

{
  "payload":{
    "accounttypedescription":"ECOM",
    "baseamount":1050,
    "credentialsonfile":"1",
    "currencyiso3a":"GBP",
    "requesttypedescriptions":["THREEDQUERY","ACCOUNTCHECK"],
    "sitereference":"test_site12345",
    "termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener"
  },
  "iat":1559033849,
  "iss":"jwt.user"
}

Über Daten Hinterlegt

Die Identifizierung von Transaktionen unter CoF bietet folgende Vorteile:

• Erhöht die Wahrscheinlichkeit einer Transaktion Autorisierung und Abrechnung.
• Größere Transparenz und bessere Erfahrungen aus der Sicht des Kunden.
• Es ist weniger wahrscheinlich, dass Emittenten das Fehlen eines Sicherheitscodes als Grund für die Ablehnung einer Transaktion angeben.

Umgang mit der Antwort

Nachdem die Anfrage verarbeitet wurde, erhalten Sie ein einzelnes Antwort-JWT, das die Antwort auf die Anfrage ACCOUNTCHECK enthält:

• Stellen Sie sicher, dass die errorcode Der zurückgegebene Wert ist "0", was den Erfolg anzeigt. (Sie dürfen keine Anmeldedaten speichern, wenn ein Fehler aufgetreten ist)
• Prüfen Sie die Werte, die in der securityresponseaddress, securityresponsepostcode und securityresponsesecuritycode Felder. Klicken Sie hier für weitere Informationen zu diesen Kontrollen und nur fortfahren, wenn die geschäftlichen Anforderungen erfüllt sind.

Nach erfolgreicher Tokenisierung können Sie die transactionreference in Ihren Unterlagen. Diese werden später benötigt, um eine neue Zahlung mit den gespeicherten Zahlungsdaten zu verarbeiten. Sie können auch die letzten vier Ziffern der maskedpan und paymenttypedescription um sie wiederkehrenden Kunden bei der Wahl der Zahlungsmethode für ihren nächsten Einkauf anzuzeigen.

Konfiguration für tokenisierte Zahlung

Aktualisieren Sie Ihr Zahlungsformular

Für die tokenisierte Zahlung müssen Sie zunächst sicherstellen, dass Sie die Drop-In Payment View in Ihr Layout eingefügt haben:

(XML)

<?xml version="1.0" encoding="utf-8"?>
<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:fillViewport="true">

<com.trustpayments.mobile.ui.dropin.DropInPaymentView
android:id="@+id/dropInPaymentView"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:padding="20dp" />

</ScrollView>

Hier ist ein Beispiel für einen Drop-In Payment View Controller, bei dem nur das Feld für den Sicherheitscode sichtbar ist, um eine Transaktion auf der Grundlage eines gespeicherten transactionreference für Zahlungsnachweise:

(Beispiel)

class SampleActivity : AppCompatActivity(R.layout.activity_sample),
DropInPaymentView.DropInPaymentViewListener {

  private var paymentSession: PaymentSession

  private val paymentTransactionManager =
  PaymentTransactionManager(
    context = this,
    gatewayType = TrustPaymentsGatewayType.EU,
    isCardinalLive = false,
    merchantUsername = BuildConfig.MERCHANT_USERNAME
    cardinalStyleManager = null,
    isLocationDataConsentGiven = false
  )

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    dropInPaymentView.dropInPaymentViewListener = this
    dropInPaymentView.setupForTokenizedPayment(setOf(PaymentInputType.CVV), CardType.Visa)
    paymentSession = paymentTransactionManager.createSession({jwtToken})
  }

  // notify about the payment form data changes, this time we're only interested in CVV
  override fun onInputValid(paymentInputType: PaymentInputType, input: String) {
    when (paymentInputType) {
      PaymentInputType.CVV -> paymentSession.cardSecurityCode = input
    }
  }

  // notify about the Pay Button click event
  override fun onPayButtonClicked() {
    val result: PaymentSessionResponse = paymentTransactionManager.executeSession(paymentSession)
    // process the result
  }
}

Wenn das Feld für den Sicherheitscode angefordert wird, muss auch der Kartentyp angegeben werden (die Eingabelänge des Sicherheitscodes wird anhand seines Wertes bestimmt).

Die Drop-In Payment View kann so konfiguriert werden, dass eine beliebige Kombination von Eingabefeldern angezeigt wird:

(Beispiel)

PaymentInputType {
  PAN,
  ExpiryDate,
  CVV
}

Konfigurieren Sie das JWT

Zusätzlich zu den Feldern, die im JWT angegeben werden müssen (wie unter diese Seite), die payload müssen die parenttransactionreference Feld, dessen Wert in der Datei transactionreference Feld des Account check Antwort. Sie muss außerdem das Feld credentialsonfile mit dem Wert "2", um anzuzeigen, dass die neue Transaktion zuvor gespeicherte Anmeldedaten verwendet.

(Payload)

{
  "payload":{
    "accounttypedescription":"ECOM",
    "baseamount":"1050",
    "currencyiso3a":"GBP",
    "sitereference":"test_site12345",
    "parenttransactionreference":"1-2-345",
    "credentialsonfile":"2",
    "termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener",
    "requesttypedescriptions":["THREEDQUERY","AUTH"]
  },
  "iat":1559033849,
  "iss":"jwt.user"
}

Feldspezifikation

	Feld	Format	Beschreibung
	credentialsonfile	Numerisch (1)	Dies muss auf "2" gesetzt werden, um anzuzeigen, dass die neue Transaktion zuvor gespeicherte Anmeldeinformationen verwendet.
	parenttransactionreference	Alphanumerisch & Bindestriche (25)	Geben Sie die Transaktionsnummer des vorherigen Antrags ein, von dem die Kartendaten übernommen werden sollen.
	requesttypedescriptions	Liste	Diese muss mindestens die folgenden Anfragearten enthalten: [“THREEDQUERY”,”AUTH”] Klicken Sie hier, um mehr zu erfahren.