Kreditkarten-Onboarding

Bevor Sie beginnen

Ihre API-Anfragen werden mit einem Zugriffstoken authentifiziert. Jede Anfrage, die kein gültiges Zugriffstoken enthält, gibt einen Fehler zurück. Erfahren Sie mehr unter Authentifizierung.

Basis-URL

• UAT: https://transactions.transactional.uat.unico.app/api/public/v1
• Produktion: https://transactions.transactional.unico.app/api/public/v1

Wichtig

Das Kreditkarten-Onboarding kann entweder durchgeführt werden, indem ein Selfie vom Endbenutzer angefordert und die vollständige Registrierung abgeschlossen wird, oder indem biometrische Erfassungen aus Prozessen wiederverwendet werden, die von anderen Produkten der Unico-IDCloud-Plattform ausgeführt wurden:

• Um von anderen IDCloud-Produkten generierte Prozesse wiederzuverwenden, geben Sie die Referenzprozess-ID in additionalInfo.processID an;
• Der verwendete Referenzprozess darf höchstens 1 Stunde zuvor abgeschlossen worden sein.

Kreditkarte validieren

POST /walletid/transaction — validiert eine Kreditkarte.

Header

Header	Wert
Authorization	Bearer {token} — ein gültiges Zugriffstoken.

Body

{
  "identity": { "key": "cpf", "value": "12345678900" },
  "orderNumber": "onboarding-98765",
  "company": "company-id",
  "redirectUrl": "https://yourapp.com/wallet/return",
  "card": {
    "binDigits": "12345678",
    "lastDigits": "1234",
    "expirationDate": "12/2028",
    "name": "John Doe"
  },
  "value": 5000.00
}

Feld	Typ	Erforderlich	Beschreibung
identity	object	ja	Identitätsinformationen des Benutzers.
identity.key	string	ja	Art des Identifikationsschlüssels des Benutzers.
identity.value	string	ja	Wert des Identifikationsschlüssels des Benutzers.
orderNumber	string	ja	Nummer im Zusammenhang mit dem Onboarding. Wird als Index im Portal und als Fremdschlüssel zwischen Ihrem System und Verifizierung ohne physische Karte verwendet.
company	string	ja	ID des für die Transaktion zuständigen Unternehmens, bereitgestellt von Unico.
redirectUrl	string	nein	URL, zu der der Benutzer nach Abschluss der Transaktion weitergeleitet wird (eine HTTPS-URL für Web oder eine Schema-URL für native mobile Apps).
card	object	ja	Bei der Transaktion verwendete Karteninformationen.
card.binDigits	string	ja	Erste 8 Ziffern der Karte.
card.lastDigits	string	ja	Letzte 4 Ziffern der Karte.
card.expirationDate	string	nein	Ablaufdatum der Karte.
card.name	string	ja	Name des Karteninhabers — stellen Sie sicher, dass er korrekt ist, um Kodierungsprobleme oder Genehmigungsprobleme zu vermeiden.
value	number	nein	Maximal abgesicherter Wert.
additionalInfo	object	nein	Senden Sie dieses Objekt mit processID, um biometrische Erfassungen von anderen Produkten der Unico-IDCloud-Plattform wiederzuverwenden.
additionalInfo.processID	string	ja (falls additionalInfo gesendet wird)	Referenzprozess-ID der IDCloud-Plattform.

Gefahr

Das Feld orderNumber muss mit der eindeutigen Bestellnummer dieses Kaufs im E-Commerce-System ausgefüllt werden — die Verwendung einer abweichenden Transaktions-ID ist falsch, und die Wiederverwendung von Werten kann replicated transaction-Fehler auslösen.

200 OK

{
  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
  "status": "processing",
  "link": "https://developers/regional-solutions/card-not-present-verification.unico.app/t/6ab1771e-dfab-4e47-8316-2452268e5481",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Feld	Beschreibung
id	ID der erstellten Transaktion.
status	Aktueller Transaktionsstatus.
link	Link im Zusammenhang mit der Transaktion. Wird nur zurückgegeben, wenn additionalInfo.processID nicht angegeben wurde.
token	Signiertes Token zur Initialisierung des Web-SDK von Verifizierung ohne physische Karte. Wird nur zurückgegeben, wenn additionalInfo.processID nicht angegeben wurde.

Validierungsstatus prüfen

GET /walletid/transactions/{transaction_id} — prüft den aktuellen Status einer bestimmten Transaktion.

Header

Header	Wert
Authorization	Bearer {token} — ein gültiges Zugriffstoken.

200 OK

{
  "status": "processing",
  "hasIdentityChanged": false
}

Feld	Beschreibung
status	Aktueller Status der Transaktion.
hasIdentityChanged	Optional. Gibt an, ob in der Transaktion ein Identitätswechsel stattgefunden hat.

Alle möglichen Status finden Sie unter Aufzählungen. Um die Leistung zu optimieren, implementieren Sie den Webhook, anstatt diesen Endpunkt abzufragen.

Fehlerantworten finden Sie unter Fehler — Kreditkarten-Onboarding.