tokenisatie voor Android SDK

U kunt onze Mobile SDK gebruiken om terugkerende klanten in staat te stellen betalingen op uw app te verwerken zonder al hun kaartgegevens opnieuw te hoeven invoeren. Dit leidt niet alleen tot snellere en eenvoudigere betalingen voor uw klanten, maar uw bedrijf profiteert er ook van dat het geen gevoelige kaartnummers hoeft op te slaan (dit kan uw PCI-accreditatieproces vereenvoudigen).

Dit proces wordt Tokenisatie genoemd.

Voorwaarden

• Rekeningcontrolen worden ondersteund voor winkeliers met een Trust Payments acquiring account. Als je een andere acquiring bank gebruikt, moet je contact opnemen met ons Support Team om te controleren of deze functie wordt ondersteund voordat je verder gaat.
• Rekeningcontrolen kan alleen worden uitgevoerd voor betalingsmethoden op basis van kaarten.

Configuratie voor het opslaan van betalingsgegevens

De JWT configureren

U moet ervoor zorgen dat uw JWT payload bevat de volgende velden:

Specificatie veld

	Veld	Formaat	Beschrijving
	credentialsonfile	Numeriek (1)	Dit moet worden ingesteld op "1", om aan te geven dat de klant ermee instemt dat de betalingsgegevens worden opgeslagen voor toekomstige transacties. Zie hieronder voor meer informatie.
	requesttypedescriptions	Lijst	Wanneer u een betaling verwerkt, dient u deze in: [“THREEDQUERY”,”AUTH”] Wanneer niet een betaling verwerkt, indienen: [“THREEDQUERY”,”ACCOUNTCHECK”] Klik hier voor meer informatie.

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

Over Gevevens in Bestand

Het identificeren van transacties als gebruikmakend van CoF biedt de volgende voordelen:

• Verhoogt de kans op transacties autorisatie en afwikkeling.
• Meer transparantie en een betere ervaring vanuit het perspectief van de klant.
• Het is minder waarschijnlijk dat emittenten het ontbreken van een beveiligingscode gebruiken als reden om een transactie te weigeren.

Behandeling van het antwoord

Nadat het verzoek is verwerkt, ontvangt u een enkel antwoord JWT dat het antwoord op het ACCOUNTCHECK verzoek bevat:

• Zorg ervoor dat de errorcode geretourneerde waarde is "0", wat wijst op succes. (U mag geen referenties opslaan als er een fout is opgetreden)
• Controleer de waarden die terugkomen in de securityresponseaddress, securityresponsepostcode en securityresponsesecuritycode velden. Klik hier voor meer informatie over deze controles en alleen doorgaan als aan de zakelijke eisen is voldaan.

Na een succesvolle tokenisatie kunt u de transactionreference in uw administratie. Dit is later nodig om een nieuwe betaling te verwerken met de opgeslagen betalingsgegevens. U kunt ook de laatste vier cijfers van de maskedpan en paymenttypedescription om aan terugkerende klanten te tonen wanneer zij hun betalingswijze voor hun volgende aankoop kiezen.

Configuratie voor tokenized betaling

Uw betalingsformulier bijwerken

Voor de tokenized betaling moet u er eerst voor zorgen dat u de Drop-In Payment View in uw lay-out heeft opgeblazen:

(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 is een voorbeeld van een Drop-In Payment View controller met alleen het beveiligingscodeveld zichtbaar, om een transactie uit te voeren op basis van een opgeslagen transactionreference voor betalingsgegevens:

(Voorbeeld)

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

Wanneer het veiligheidscodeveld wordt gevraagd, moet ook de kaartsoort worden opgegeven (de invoerlengte van de veiligheidscode wordt bepaald op basis van de waarde ervan).

De Drop-In Payment View kan worden geconfigureerd om elke combinatie van invoervelden weer te geven:

(Voorbeeld)

PaymentInputType {
  PAN,
  ExpiryDate,
  CVV
}

De JWT configureren

Naast de velden die binnen het JWT moeten worden ingediend (zoals beschreven op deze pagina), de payload zal de parenttransactionreference veld, waarvan de waarde wordt teruggegeven in de transactionreference veld van de Rekeningcontrole antwoord. Het moet ook het veld credentialsonfile met waarde "2", om aan te geven dat de nieuwe transactie gebruik maakt van eerder opgeslagen referenties.

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

Specificatie veld

	Veld	Formaat	Beschrijving
	credentialsonfile	Numeriek (1)	Dit moet op "2" staan, om aan te geven dat de nieuwe transactie gebruik maakt van eerder opgeslagen referenties.
	parenttransactionreference	Alfanumeriek en koppeltekens (25)	Dien de Transactiereferentie van het vorige verzoek in waarvan de kaartgegevens zullen worden overgenomen.
	requesttypedescriptions	Lijst	Deze moet ten minste de volgende soorten verzoeken bevatten: [“THREEDQUERY”,”AUTH”] Klik hier voor meer informatie.