Pay By Link to znana w Polsce metoda płatności, która umożliwia klientom płacenie za zakupy w Internecie za pomocą konta bankowego. SIBS Payment Gateway zapewnia interfejs API umożliwiający integrację z usługami Pay By Link poprzez wzorzec Web Redirect.

Interfejs API umożliwia przedstawienie klientowi płatności ze wszystkimi adresowalnymi podmiotami. Gdy klient wybierze podmiot, którego chce użyć, wystarczy wywołać API, które poda Ci odpowiedni adres URL przekierowania.

Jak to działa

Zanim zaczniesz, powinieneś utworzyć żądanie zamówienia z PayByLink jako metodą płatności.

Następnie należy wykonać następujące kroki:

Krok 1: Uzyskaj listę wszystkich podmiotów PayByLink i przedstaw je klientowi

Krok 2: Wywołaj API, aby uzyskać ważny Link do płatności dla wybranego podmiotu

Krok 3: Uzyskaj status płatności, aby poznać wynik płatności

Krok 1: Uzyskaj listę podmiotów PayByLink i przedstaw je klientowi

Możesz sprawdzić listę wszystkich podmiotów PayByLink składających żądanie GET.

Należy pamiętać, że żądanie wymaga nagłówka autoryzacji ze znakiem mark, transactionsSignature zwróconym z operacji realizacji transakcji.

Sprawdź poniżej jak uzyskać listę kanałów płatności:

Oczekiwana odpowiedź:

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

W przypadku pomyślnych odpowiedzi otrzymasz następujące dodatkowe dane:

"paymentChannels": [
 {"gatewayId": "PBL Gateway ID","gatewayName": "Name to present to customer","gatewayType": "PBL","bankName": "technical bank name","iconURL" : "https://paybylink.bank.pl/grafika/pbl.gif"}
]

"paymentChannels": [
 {"gatewayId": "PBL Gateway ID","gatewayName": "Name to present to customer","gatewayType": "PBL","bankName": "technical bank name","iconURL" : "https://paybylink.bank.pl/grafika/pbl.gif"}
]

W przypadku otrzymania wykazu regulaminów należy je pokazać Klientowi wraz z hiperłączem do adresu URL.

Krok 2: Wywołaj API, aby uzyskać ważny Link do płatności dla wybranego podmiotu

Pamiętaj, że poniższe żądanie wymaga nagłówka autoryzacji z podpisem transakcji zwróconym z operacji realizacji transakcji i powinieneś uwzględnić te dwa elementy poniżej:

W tym żądaniu token okaziciela zostaje zastąpiony odpowiedzią kasy „transactionSignature”.

Oto przykład:

Adres URL żądania:

https://stargate-cer.qly.site1.sibs.pt/api/v2/payments/{transactionID}/pbl/payment-link

Nagłówki żądań:

Authorization: Digest {transactionSignature}
X-IBM-Client-Id: b4480347-9fc8-4790-b359-100a99c60ea3
Content-Type: application/json

{
 "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": "DIOGO M"
 },
 {
 "key": "customerEmail",
 "value": "{{CustomerEmail}}"
 }
 ]
 },
 "gatewayId": "PL_TEST",
 "userAcceptanceIndicator": true,
 "merchant": {
 "merchantURL": "https://egadget2.azurewebsites.net/#/returns?id=4qm1q5p6eTgzREWYHRPA"
 }
}

Po zakończeniu operacji powinieneś otrzymać status oczekującej płatności.

Użytkownik zostanie przekierowany do środowiska PBL w celu potwierdzenia płatności, a następnie z powrotem na adres URL sprzedawcy.

{
 "transactionID": "UEBfud1Xg5XZwwfCWWR8",
 "execution": {
 "startTime": "2023-06-20T09:24:25.504Z",
 "endTime": "2023-06-20T09:24:28.415Z"
 },
 "paymentStatus": "Pending",
 "returnStatus": {
 "statusCode": "000",
 "statusMsg": "Success",
 "statusDescription": "Success"
 },
 "redirectURL": "https://psd2.kevin.eu/login/1c5c539b-3e48-4971-bed5-4172a58601a9?redirectPreferred=true&bankId=KEVIN_PL_TEST&lang=PL"
}

Krok 3: Uzyskaj status płatności, aby poznać wynik płatności

Po całkowitym przetworzeniu płatności możesz sprawdzić status swojej transakcji, wysyłając żądanie GET.

Nagłówek HTTP autoryzacji jest ustawiony na token okaziciela, tak jak był używany podczas początkowej realizacji transakcji.

Body:

Oczekiwana odpowiedź pomyślna:

{
 "merchant": {
 "terminalId": "101778",
 "merchantTransactionId": "Order Id: r7cxvi0saj"
 },
 "transactionID": "J120XDzUq2u4UwVDSZBt",
 "amount": {
 "currency": "PLN",
 "value": "50.50"
 },
 "paymentType": "PURS",
 "paymentStatus": "Success",
 "paymentMethod": "PBLKV",
 "execution": {
 "endTime": "2023-06-20T10:07:27.771Z",
 "startTime": "2023-06-20T10:07:27.701Z"
 },
 "returnStatus": {
 "statusCode": "000",
 "statusMsg": "Success",
 "statusDescription": "Success"
 }
}

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

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