Gdy posiadacz karty jest zalogowany w sklepie internetowym sprzedawcy, wyświetlany jest przycisk „Płatność jednym kliknięciem” umożliwiający łatwą płatność za pomocą jednego kliknięcia.

Token karty jest rozszyfrowywany, a kontekst płatności jednym kliknięciem jest sprawdzany przed przedstawieniem transakcji IPS z odniesieniem do początkowej transakcji. Pozwala to ominąć proces autoryzacji.

Jak to działa?

Aby wykonać płatność z autoryzacją 3DS, najpierw utwórz zamówienie zgodnie z instrukcjami zawartymi w Przewodniku integracji API (FULL CODE).

Należy pamiętać, że do żądania zamówienia należy dołączyć dodatkowe parametry OneClick i Tokenization jak pokazano poniżej:

Przykład żądania:

{"merchant": {
 "terminalId": {{TerminalID}},
 "channel": "web",
 "merchantTransactionId": "Order Id: r7cxvi0saj"},"transaction": {
 "transactionTimestamp": "{{trxDatetime}}",
 "description": "Transaction for order number 4908 terminalId 100886",
 "moto": false,
 "paymentType": "PURS",
 "amount": {
 "value": 50.50,
 "currency": "PLN"},"paymentMethod": [
 "CARD"]
 },"tokenisation": {
 "paymentTokens": [{
 "tokenType": "Card",
 "value": "{{purchaseTokenValue}}" }
 ]
 }
}

Po zakończeniu tworzenia zamówienia, możesz przejść do dokonania płatności.

Należy pamiętać, że poniższe żądanie wymaga nagłówka autoryzacji z podpisem transakcji zwróconym z operacji zlecenia płatności.

W tym żądaniu zakupu należy uwzględnić dodatkowe parametry DeviceInfo, OneClick and TokenInfo jak pokazano ponizej:

Przykład żądania:

{"info": {
 "deviceInfo": {
 "browserAcceptHeader": "application/json, text/plain, */*",
 "browserJavaEnabled": "false",
 "browserLanguage": "en",
 "browserColorDepth": "24",
 "browserScreenHeight": "1080",
 "browserScreenWidth": "1920",
 "browserTZ": "-60",
 "browserUserAgent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Safari/537.36",
 "geoLocalization": "Lat: 38.7350528 | Long: -9.2143616",
 "systemFamily": "Windows",
 "systemVersion": "Windows",
 "deviceID": "498bfd4c3a3645b38667a7037b616c18",
 "applicationName": "Chrome",
 "applicationVersion": "106" },
 "customerInfo": [
 {
 "key": "customerName",
 "value": "User X" },
 {
 "key": "customerEmail",
 "value": "testingemail@gmail.com" }
 ]
 },"tokenInfo": {
 "value": "{{purchaseTokenValue}}",
 "tokenType": "Card"},"oneClick": {
 "oneClickApplication": true}
}

Oczekiwana odpowiedź:

Otrzymasz odpowiedź zawierającą w wiadomości.status płatności. Informuje ona, czy transakcja została zaakceptowana, odrzucona, nadal oczekuje na ostateczny wynik lub wymaga dodatkowych działań.

• Success(sukces): zakup został pomyślnie przetworzony, a klient został obciążony.
• Declined (odrzucona): zakup został odrzucony.
• Pending: (oczekująca): ostateczny wynik zakupu nie jest jeszcze znany. Konieczne będzie zapytanie o status tej transakcji, dopóki nie osiągnie ona stanu końcowego lub użytkownik nie zdecyduje się jej anulować.
• Partial: (częściowy): zakup został częściowo zaakceptowany, ale wymaga wykonania dodatkowych czynności (np. Uwierzytelnianie 3D-Secure). Element actionResponse zawiera instrukcje dotyczące dalszego postępowania.

Wykonaj polecenie Uzyskaj Status

Po pełnym przetworzeniu płatności można sprawdzić status transakcji, wysyłając żądanie GET.

Upewnij się, że nagłówek HTTP autoryzacji jest ustawiony na ten sam token okaziciela, który został użyty w początkowym zleceniu płatności.

Adres URL żądania:

https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/status

Nagłówki żądań:

Authorization: ‘Bearer <AuthToken>’
X-IBM-Client-Id: ‘<ClientId>’
Content-Type: application/json

Pomyślna odpowiedź techniczna składa się z statusu HTTP-200 i returnStatus.statusCode=”000″.

Oto kilka przykładów możliwych kodów wyników: