Pobieranie danych transakcji

Pobieranie danych transakcji stanowi cenne narzędzie do odzyskiwania szczegółów transakcji powiązanych z określonym numerem zamówienia. Ta funkcjonalność umożliwia dostęp do istotnych informacji, takich jak szczegóły konta bankowego lub dane karty użytej w transakcji.

Przykład pobrania danych transakcji

Ciało żądania metody GET

Wysyłając żądania z metodą GET upewnij się, że w ciele żądania nie przesyłasz żadnych danych. Zgodnie ze standardem RFC 9110 żądania, które nie spełniają tego wymogu, zostaną odrzucone przez PayU i zwrócony zostanie kod HTTP 403.

Aby pobrać dane transakcji, wywołaj enpoint v2_1/orders/{orderId}/transactions używając metody GET, gdzie orderId to identyfikator zamówienia pobrany po utworzeniu zamówienia.

Przykład żądania pobrania danych transakcji

curl -X GET https://secure.payu.com/api/v2_1/orders/{orderId}/transactions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 3e5cac39-7e38-4139-8fd6-30adc06a61bd" \

Odpowiedź na pobranie danych transkacji

Notatka

Dane karty są dostępne natychmiast po przetworzeniu transakcji. Dane bankowe mogą być dostępne po kilku minutach lub następnego dnia roboczego, w zależności od banku.

Card

Przykład odpowiedzi na pobranie danych transakcji

{
  "transactions": [
    {
      "payMethod": {
        "value": "c"
      },
      "paymentFlow": "FIRST_ONE_CLICK_CARD",
      "validUntil": "2024-06-20T09:05:44.238+02:00",
      "card": {
        "cardData": {
          "cardNumberMasked": "543402******4014",
          "cardScheme": "MC",
          "cardProfile": "CONSUMER",
          "cardClassification": "DEBIT",
          "cardResponseCode": "000",
          "cardResponseCodeDesc": "000 - OK",
          "cardEciCode": "2",
          "card3DsStatus": "Y",
          "card3DsStatusDescription": "MessageVersion=2.1.0,browser flow,3DS method not available,dynamic authentication,no cancel indicator,no status reason",
          "cardBinCountry": "PL",
          "firstTransactionId": "MCC0111LL1121"
        }
      }
    }
  ]
}

Maskowany numer karty

Dla parametru paymentFlow o wartości APPLE_PAY, GOOGLE_PAY_TOKENIZED lub CLICK_TO_PAY, wartość parametru cardNumberMasked stanowi token, który zastępuje rzeczywisty numer karty płatniczej.

PBL / Bank Transfer

Przykład odpowiedzi po pobraniu informacji o transakcji pay-by-link

{
  "transactions": [
    {
      "payMethod": {
        "value": "m"
      },
      "paymentFlow": "PBL",
      "bankAccount": {
        "number": "80607787095718703296721164",
        "name": "JAN KOWALSKI",
        //uwaga: zależnie od banku, imię, nazwisko i adres
        //mogą zostać dopasowane do dowolnego z poniższych pól
        "city": "WARSZAWA",
        "postalCode": "02-638",
        "street": "UL.NOWOWIEJSKIEGO 8",
        "address": "Warszawa Nowowiejskiego 8"
      }
    }
  ]
}

Szczegółowe informacje na temat parametrów z sekcji cardData zawartej w odpowiedzi znajdziesz w sekcji Szczegóły 3DS w danych transakcji.

Natomiast informacje na temat wszystkich parametrów znajdziesz w sekcji Retrieve a Transaction w naszej referencji API.

Wartości parametru paymentFlow

Poniżej znajduje się tabela z wartościami parametru paymentFlow, które mogą wystąpić w odpowiedzi na pobranie danych transakcji. Parametr ten określa rodzaj płatności, która została zrealizowana:

Wartości parametru paymentFlow

Wartość	Opis
FIRST_ONE_CLICK_CARD	Transakcja zapisująca kartę (dla transakcji CIT/MIT/cyklicznych).
ONE_CLICK_CARD	Transakcja zapisaną kartą (CIT/MIT/cykliczna).
ONE_CLICK_CARD_RECURRING	Transakcja cykliczna zapisaną kartą.
ONE_CLICK_MAIL_ORDER	Zamówienie pocztowe zapisaną kartą.
ONE_CLICK_PHONE_ORDER	Zamówienie telefoniczne zapisaną kartą.
ONE_CLICK_MAIL_RECURRING	Cykliczne zamówienie pocztowe zapisaną kartą.
ONE_CLICK_PHONE_RECURRING	Czykliczne zamówienie telefoniczne zapisaną kartą.
PEX_BANK	PEX Bank (jak PBL dla niektórych banków).
PBL	Transakcja Pay-by-link.
CARD	Standardowa transakcja kartą.
CARD_INSTALLMENTS	Transakcja ratalna kartą.
GOOGLE_PAY	Transakcja Google Pay.
GOOGLE_PAY_TOKENIZED	Transakcja Google Pay Tokenized.
APPLE_PAY	Transakcja Apple Pay.
CLICK_TO_PAY	Transakcja Click to Pay.
VISA_MOBILE	Transakcja Visa Mobile.
BLIK_PBL	Transakcja BLIK.
BLIK_AUTHORIZATION_CODE	Transakcja BLIK z kodem autoryzacyjnym.
BBLIK_AUTHORIZATION_CODE_WITH_UID_TOKEN_REGISTERING	Transakcja BLIK z zapisaniem tokena UID.
BLIK_UID_TOKEN	Transakcja BLIK z zapisanym tokenem.
BLIK_AUTHORIZATION_CODE_WITH_PAYID_TOKEN_TYPE_O_REGISTERING	Transakcja cykliczna BLIK z zapisaniem tokena PAYID.
BLIK_PAYID_TOKEN_TYPE_O	Transakcja cykliczna BLIK z zapisanym tokenem PAYID.