# Pobieranie informacji o płatności

Metoda służy do pobrania podstawowych informacji o płatności. Metoda nigdy nie zwraca danych wrażliwych związanych z płatnością. Podstawowy przypadek użycia dla metody to inicjalizacja bramki web (channel=PAYWALL), która posiada początkowo wyłącznie informacje o paymentId i musi pobrać brakujące informacje w celu prezentacji klientowi.

Endpoint: GET /v1/ecommerce/payment/{paymentId}
Version: 2.1.15
Security: bearerAuth

## Path parameters:

  - `paymentId` (string, required)
    Identyfikator płatności w systemie operatora płatności

## Response 200 fields (*/*):

  - `paymentId` (string)
    Identyfikator płatności w systemie operatora płatności

  - `status` (string)
    Aktualny status płatności

  - `merchant` (object,null)
    Dane merchanta pośredniczącego (operator aplikacji mobilnej)

  - `merchant.merchantId` (string, required)
    Identyfikator merchanta nadany przez operatora płatności (MID)

  - `merchant.name` (string,null)
    Nazwa merchanta

  - `merchant.mcc` (string,null)
    MCC

  - `merchant.url` (string,null)
    Adres URL sklepu

  - `merchant.redirectURL` (string,null)
    Adres URL przekierowania

  - `merchant.terminalId` (string,null)
    Id terminala

  - `merchant.location` (object,null)
    Adres merchanta

  - `merchant.location.street` (string, required)
    Adres (ulica i numer domu)

  - `merchant.location.postal` (string, required)
    Kod pocztowy

  - `merchant.location.state` (string)
    Województwo (kod ISO 3166-2 np. 12 dla województwa małopolskiego
    Example: "12"

  - `merchant.location.city` (string, required)
    Miasto

  - `merchant.location.country` (string, required)
    Kraj (kod ISO np. PL)
    Example: "POL"

  - `merchant.location.countryOfOrigin` (string)
    Kraj pochodzenia (kod ISO np. PL)
    Example: "POL"

  - `merchant.taxId` (string,null)
    Nip

  - `merchant.acsNotificationURL` (string,null)
    Adres publicznego endpointu do odebrania notyfikacji CRes z ACS (jezeli obslugiwany przez merchanta)

  - `merchant.amexMerchantId` (string,null)
    Id merchanta dla płatności AMEX

  - `merchant.dpaId` (string,null)

  - `merchant.organizationId` (string,null)

  - `merchant.merchantName` (string,null)
    Nazwa merchanta

  - `customer` (object)
    Dane właściciela karty

  - `customer.email` (string)
    Adres email klienta

  - `customer.extCustomerId` (string,null)
    Identyfikator klienta w systemie merchanta

  - `customer.name` (string,null)
    Imię i nazwisko klienta

  - `customer.billing` (object,null)
    Adres rozliczeniowy klienta (wymagany dla method = CARD)

  - `customer.billing.state` (string)
    Wojewodztwo
    Example: "mazowieckie"

  - `customer.risk` (object,null)
    Dodatkowe parametry analizy ryzyka na potrzeby 3DS

  - `customer.risk.scaPreference` (string)
    Preferencje dotyczące silnego uwierzytelnienia klienta (SCA)
    Enum: "RISK_VERIFIED", "DATA_SHARE", "USE_WL", "SCA_PERFORMED", "PROMPT_WL", "LOW_VALUE", "LOW_RISK"

  - `customer.risk.accountAuthDate` (string,null)
    Data i godzina (UTC) uwierzytelnienia klienta (Format: yyyy-MM-dd'T'HH:mm:ss.SSSX) (wymagane dla scaPreference = LOW_RISK)
    Example: "2022-02-15T18:35:24.00Z"

  - `customer.risk.accountCreateDate` (string,null)
    Data zalożenia konta u merchanta/agenta (Format: yyyy-MM-dd) (wymagane dla scaPreference = LOW_RISK)
    Example: "2022-02-15"

  - `customer.risk.accountChangeDate` (string,null)
    Data ostatniej zmiany danych konta (Format: yyyy-MM-dd) (wymagane dla scaPreference = LOW_RISK)
    Example: "2022-02-15"

  - `customer.risk.accountActiveDate` (string,null)
    Data od kiedy posiadacz karty aktywował płatności na koncie merchanta/agenta (Format: yyyy-MM-dd) (wymagane dla scaPreference = LOW_RISK)
    Example: "2022-02-15"

  - `customer.risk.passChangeDate` (string,null)
    Data ostatniej zmiany hasła do konta (Format: yyyy-MM-dd) (wymagane dla scaPreference = LOW_RISK)
    Example: "2022-02-15"

  - `customer.risk.purchaseCount6M` (integer,null)
    Liczba zakupów wykonana za pomoca konta w ciągu ostatnich sześciu miesiecy (wymagane dla scaPreference = LOW_RISK)

  - `customer.risk.tokenizationCountDay` (integer,null)
    Liczba prób dodania kart do konta z ostatnich 24 godzin (wymagane dla scaPreference = LOW_RISK)

  - `customer.risk.shipAddressDate` (string,null)
    Data pierwszego użycia adresu, który został wybrany dla aktualnej transakcji (Format: yyyy-MM-dd) (wymagane dla scaPreference = LOW_RISK)
    Example: "2022-02-15"

  - `customer.risk.shipNameIndicator` (boolean,null)
    Wskazuje czy nazwa posiadacza karty zdefiniowana na koncie operatora jest identyczna jak ta w nazwie do wysyłki bieżacej transakcji

  - `customer.risk.suspiciousActivity` (boolean,null)
    Wskazuje czy kiedykolwiek zachowanie posiadacza karty zostało potraktowane jako podejrzane (wymagane dla scaPreference = LOW_RISK)

  - `customer.risk.authenticatedTransaction` (boolean,null)
    Wskazuje czy transakcja była dodatkowo uwierzytelniona

  - `customer.risk.transactionSCountDay` (integer,null)
    Liczba transakcji udanych z ostatnich 24 godzin

  - `customer.risk.transactionUCountDay` (integer,null)
    Liczba transakcji nieudanych z ostatnich 24 godzin

  - `customer.risk.transactionSCountYear` (integer,null)
    Liczba transakcji udanych z ostatniego roku

  - `customer.risk.transactionUCountYear` (integer,null)
    Liczba transakcji nieudanych z ostatniego roku

  - `customer.risk.transactionCountDay` (integer,null)
    Liczba transakcji udanych oraz nieudanych z ostatnich 24 godzin

  - `customer.risk.transactionCountYear` (integer,null)
    Liczba transakcji udanych oraz nieudanych z ostatniego roku

  - `customer.phone` (object,null)
    Obiekt zawierający dane telefoniczne klienta

  - `customer.phone.countryCode` (string, required)
    Kod kraju
    Example: "48"

  - `customer.phone.phoneNo` (string, required)
    Numer telefonu
    Example: "123456789"

  - `customer.firstName` (string,null)
    Imię i nazwisko klienta

  - `customer.lastName` (string,null)
    Imię i nazwisko klienta

  - `customer.extAccountNo` (string)
    Zewnętrzny numer rachunku

  - `order` (object)
    Dane zamówienia podlegajacego płatności

  - `order.amount` (number,null)
    Kwota transakcji (Format: 000.00)

  - `order.currency` (string,null)
    Waluta transakcji (kod ISO np. PLN)

  - `order.commission` (number,null)
    Kwota prowizji obciażajaca klienta (dodawana do kwoty oryginalnej transakcji)

  - `order.extOrderId` (string,null)
    Identyfikator zamówienia z systemu merchanta

  - `order.shipping` (object,null)
    Adres rozliczeniowy klienta (wymagany dla method = CARD)

  - `order.description` (string,null)
    Opis zamówienia (do prezentacji na ekranie potwierdzenia)

  - `order.subpayments` (array,null)
    Podział na transakcje przy płatności z MARKETPLACE

  - `order.subpayments.subpaymentId` (string,null)
    Identyfikator subtransakcji

  - `order.subpayments.merchantId` (string, required)
    Identyfikator merchanta

  - `order.subpayments.amount` (number)
    Kwota transakcji

  - `order.subpayments.commission` (number, required)
    Prowizja dla MARKETPLACE

  - `order.subpayments.extOrderId` (string,null)
    Identyfikator zamowienia w systemie merchanta

  - `order.subpayments.extCustomerId` (string,null)
    Identyfikator klienta w systemie submerchanta (Płatności multikoszykowe)

  - `order.subpayments.productId` (string,null)
    Identyfikator produktu wg systemu submerchanta

  - `order.subpayments.productName` (string,null)
    Nazwa produktu

  - `order.subpayments.productNumber` (string,null)
    Numer katalogowy produktu

  - `order.subpayments.productDescription` (string,null)
    Opis produktu

  - `order.subpayments.productCategory` (string,null)
    Kategoria produktu

  - `order.subpayments.companyId` (string,null)
    Identyfikator firmy

  - `order.subpayments.operatorName` (string,null)
    Nazwa operatora

  - `rejectCode` (string)
    Powód odrzucenia (w przypadku niepowodzenia)

  - `rejectInfo` (string)
    Dodatkowe informacje o powodzie odrzucenia płatności

  - `options` (object)
    Inne parametry sterujace

  - `options.tokenize` (boolean)
    Zadanie tokenizacji karty

  - `options.recurring` (string)
    Flaga płatności cyklicznych

  - `options.transKind` (string)
    Rodzaj transakcji dla transakcji kartowych

  - `options.methods` (array,null)
    Dostępne metody płatności
    Enum: "CARD", "PBL", "BLIK", "GPAY", "APAY", "UNKNOWN", "C2P"

  - `options.registerAlias` (boolean,null)
    Rejestracja aliasu na potrzeby transparentnych płatności

  - `channel` (string)
    Kanał płatności
    Enum: "PAYWALL", "MOBILE", "WEBAPI", "EBOK", "CSS"

  - `method` (string)
    Metoda płatności
    Enum: "CARD", "PBL", "BLIK", "GPAY", "APAY", "UNKNOWN", "C2P"

  - `orderAmount` (number)
    Aktualna kwota płatności, która może być modyfikowana przez adjustment lub cancel. W standardowym przypadku jest równa kwocie z sekcji order (ta oryginalna kwota nigdy nie ulega zmianie)

  - `captureAmount` (number)
    Zatwierdzona kwota płatności (dotyczy preautoryzacji). Dla regularnych płatności równa kwocie z sekcji order, dla preautorycji aktualizowana po każdej akcji capture

  - `redirectURL` (string)
    Adres URL dla kontynuacji flow webowego

  - `forceSca` (boolean)
    Flaga wymuszenia silnego uwierzytelnienia klienta (SCA)

  - `recipient` (object)
    Informacje o weryfikacji odbiorcy (w przypadku transferu srodkow P2P)

  - `recipient.nameVerificationResult` (string)
    Flaga informujaca czy przeprowadzono weryfikacje odbiorcy
    Enum: "MATCH", "NO_MATCH", "PARTIAL", "UNVERIFIED", "PERFORMED"

  - `recipient.firstNameMatch` (string)
    Zgodność imienia odbiorcy
    Enum: "MATCH", "NO_MATCH", "PARTIAL", "UNVERIFIED", "PERFORMED"

  - `recipient.lastNameMatch` (string)
    Zgodność nazwiska odbiorcy
    Enum: "MATCH", "NO_MATCH", "PARTIAL", "UNVERIFIED", "PERFORMED"

  - `reattempt` (string)
    Informacja o ograniczeniach w wykonywaniu płatności. Dopuszczalne wartosci:NEVER - nie wysyłaj więcej komunikatow na ten numer karty; NEVER_RECURRING - nie wysyłaj wiecej komunikatow dla płatności powtarzalnej; LATER - sprobuj później
    Enum: "NEVER", "NEVER_RECURRING", "LATER"


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 500 fields