Płatności kartami to popularna metoda umożliwiająca dokonywanie transakcji przy użyciu kart debetowych lub kredytowych. Proces ten polega na wprowadzeniu danych karty, takich jak numer karty, data ważności oraz kod CVC/CVV, w formularzu płatności. Następnie, w celu weryfikacji tożsamości i zabezpieczenia transakcji, może być wymagane dodatkowe potwierdzenie, np. poprzez użycie 3D Secure, np. potwierdzenie w aplikacji wydawcy karty, kod na SMS lub kod PIN).
Upewnij się, że:
Realizuj płatności kartowe wykorzystując endpoint zakładania transakcji podając groupId: 103.
Aby utworzyć transakcję kartową, wyślij żądanie POST na endpoint:
https://api.tpay.com/transactions
Sprawdź szczegóły w dokumentacji API Reference: POST /transactions
W zapytaniu określ następujące parametry:
amount * | Kwota transakcji. |
description * | Opis transakcji widoczny dla płatnika. |
payer.email | Adres e-mail płatnika. |
payer.name | Imię i nazwisko płatnika. |
payer.ip | Adres IP płatnika (IPv4 lub IPv6). Uwaga: wymagany w integracji z agentem rozliczeniowym Pekao. |
pay.groupId | Identyfikator grupy płatności dla kart: 103. |
* Pola obowiązkowe.
Podstawowe body żądania powinno wyglądać następująco:
{ "amount": 0.1, "description": "Testowa płatność kartowa", "payer": { "email": "[email protected]", "name": "Jan Nowak" }, "pay": { "groupId": 103 } }
Po wysłaniu żądania otrzymasz w odpowiedzi schemat TransactionCreated.
Najważniejsze parametry odpowiedzi:
result | success - Transakcja została utworzona pomyślnie. |
status | pending - Transakcja oczekuje opłacenia. |
transactionPaymentUrl | Adres URL, na który należy przekierować płatnika. |
Przykładowa odpowiedź:
{ "result": "success", "requestId": "858fa92dc62db44e2c1f", "transactionId": "01K5BK4HEPB0WBCGT51FMTYSYJ", "title": "TR-CWM-CNYHA6X", "posId": "ps_e4dkPVDEm4Jg7267", "status": "pending", "date": { "creation": "2024-06-06 21:31:35", "realization": null }, "amount": 0.1, "currency": "PLN", "description": "Testowa płatność kartowa", "hiddenDescription": "", "payer": { "payerId": "py_a9rjlZWxRLdG1bqY", "email": "[email protected]", "name": "Jan Nowak", "phone": "", "address": "", "city": "", "country": "PL", "postalCode": "" }, "payments": { "status": "pending", "method": "pay_by_link", "amountPaid": 0, "date": { "realization": null } }, "transactionPaymentUrl": "https://secure.tpay.com/?title=TR-CWM-CNYHA6X&uid=01HZQGHZP5P3P7YV8A4BRVDX17" }
Przekieruj płatnika na URL zawarty w odpowiedzi w polu transactionPaymentUrl.
Następnie płatnik wypełnia formularz danymi karty i zatwierdza formularz.
Jeśli zajdzie taka potrzeba, przekierujemy płatnika na stronę organizacji wydającej kartę płatniczą w celu uwierzytelnienia 3DS.
3DS to protokół uwierzytelniania płatnika, który ma na celu zwiększenie bezpieczeństwa transakcji internetowych realizowanych kartami płatniczymi. 3DS jest realizowany poprzez dodanie dodatkowego kroku uwierzytelnienia, zanim transakcja zostanie przekazana do autoryzacji.
Płatnik jest proszony o podanie dodatkowych danych uwierzytelniających. Mogą to być hasło, kod SMS, odcisk palca, autoryzacja w aplikacji lub inne metody weryfikacji tożsamości.
Jeśli płatnik pomyślnie przejdzie proces uwierzytelniania, transakcja zostanie skierowana do autoryzacji. W przeciwnym razie transakcja jest odrzucana.
Gdy płatność kartą zostanie zakończona, płatnik zostanie przekierowany na stronę sukcesu (success page) lub stronę porażki (error page) w zależności czy transakcja się udała.
Poinformujemy Ciebie o statusie transakcji za pośrednictwem notyfikacji po zaksięgowaniu transakcji.
Transakcja kartowa on-site polega na zaprezentowaniu w Twojej witrynie formularza do wprowadzenia danych karty płatniczej, który uzupełni płatnik.
Następnie podczas tworzenia transakcji, szyfrujesz dane karty kluczem publicznym RSA, dostępnym w Panelu Akceptanta
Zaszyfrowaną wartość przekazujesz w polu pay.cardPaymentData.card.
Pamiętaj, że każdego umożliwiającego płatności kartami, w szczególności udostępniającego je w swojej witrynie, obowiązują wytyczne bezpieczeństwa danych branży kart płatniczych PCI DSS (Payment Card Industry Data Security Standard), które są opisane na stronie standardu. Rozpocznij od strony: Czym jest kwestionariusz samooceny PCI DSS?
W celu realizacji płatności kartowej wyświetl formularz płatności w swojej witrynie.
Aby utworzyć transakcję kartową, wyślij żądanie POST na endpoint:
https://api.tpay.com/transactions
Sprawdź szczegóły w dokumentacji API Reference: POST /transactions
W zapytaniu określ następujące parametry:
amount * | Kwota transakcji. |
description * | Opis transakcji widoczny dla płatnika. |
payer.email | Adres e-mail płatnika. |
payer.name | Imię i nazwisko płatnika. |
payer.ip | Adres IP płatnika (IPv4 lub IPv6). Uwaga: wymagany w integracji z agentem rozliczeniowym Pekao. |
payer.groupId | Identyfikator grupy płatności dla kart: 103. |
* Pola obowiązkowe.
Podstawowe body żądania powinno wyglądać następująco:
{ "amount": 0.1, "description": "Testowa płatność kartowa", "payer": { "email": "[email protected]", "name": "Jan Nowak" }, "pay": { "groupId": 103 } }
Po wysłaniu żądania otrzymasz w odpowiedzi schemat TransactionCreated.
Najważniejsze parametry odpowiedzi:
result | success - Transakcja została utworzona poprawnie. |
status | pending - Transakcja oczekuje opłacenia. |
transactionPaymentUrl | Adres URL, na który należy przekierować płatnika. |
transactionId | Unikalny identyfikator transakcji - przechowaj go w swoim systemie. |
Przykładowa odpowiedź:
{ "result": "success", "requestId": "858fa92dc62db44e2c1f", "transactionId": "01K5BK4HEPB0WBCGT51FMTYSYJ", "title": "TR-CWM-CNYHA6X", "posId": "ps_e4dkPVDEm4Jg726q", "status": "pending", "date": { "creation": "2024-06-06 21:31:35", "realization": null }, "amount": 0.1, "currency": "PLN", "description": "Testowa płatność kartowa", "hiddenDescription": "", "payer": { "payerId": "py_a9rjlZWxRLdG1bqY", "email": "[email protected]", "name": "Jan Nowak", "phone": "", "address": "", "city": "", "country": "PL", "postalCode": "" }, "payments": { "status": "pending", "method": "pay_by_link", "amountPaid": 0, "date": { "realization": null } }, "transactionPaymentUrl": "https://secure.tpay.com/?title=TR-CWM-CNYHA6X&uid=01HZQGHZP5P3P7YV8A4BRVDX17" }
Przygotuj ciąg znaków według wzoru:
Przykład:
Zaszyfruj ciąg znaków, używając klucza publicznego RSA oraz schematu wypełniania zgodnego ze standardem PKCS#1 v1.5.
W celu opłacenia transakcji kartowej wykorzystaj wcześniej przechowany parametr transactionId, wysyłając żądanie POST na adres:
https://api.tpay.com/transactions/{transactionId}/pay
Umieść transactionID w adresie URL np.:
https://api.tpay.com/transactions/01K5BK4HEPB0WBCGT51FMTYSYJ/pay
Sprawdź szczegóły w dokumentacji API Reference: POST /transactions/{transactionId}/pay
W zapytaniu określ następujące parametry:
groupId * | Identyfikator grupy płatności dla karty: 103. |
cardPaymentData.card * | Zaszyfrowane dane karty. |
* Pola obowiązkowe.
Podstawowe body żądania powinno wyglądać następująco:
Przykład:
curl --location 'https://api.tpay.com/transactions/01K5BK4HEPB0WBCGT51FMTYSYJ/pay'\ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <access_token> '\ --data '{ "groupId": 103, "cardPaymentData": { "card": "SxzdtoeZWhbQ2jufH7qBj55KGMc722+ULiNZN0ZSYff5keLEtfw6PP+aVCxZBRigaUyN2krJ3xy/0zREs59j6EclpPrEGtdtHOow1iNaLaabNvTN9mVN2FVeV1BRzDD4FSex9V2AK7j0+YII4JtPhYlYx4URWHe/5UqEYQjyoWc=", } }'
Po wysłaniu żądania otrzymasz w odpowiedzi schemat TransactionCreated.
Parametr status o wartości pending, oznacza, że transakcja wymaga dodatkowego uwierzytelnienia 3DS. Przekieruj płatnika na adres zawarty w parametrze transactionPaymentUrl, gdzie będzie mógł zrealizować uwierzytelnienie 3DS.
Oczekuj na swoim URL do powiadomień, notyfikacji o statusie płatności. Gdy płatność zostanie zakończona, otrzymasz dane transakcji wraz z jej statusem.
Poinformujemy Ciebie o statusie transakcji za pośrednictwem notyfikacji po zaksięgowaniu transakcji.
Jeśli chcesz obsłużyć płatności rekurencyjne za pomocą kart płatniczych przejdź do Tokenizacji.