# Utworzenie transakcji

**POST /merchant/{merchantId}/transaction**

Zgodnie z wymaganiami PCI DSS (ustalonymi przez organizacje płatnicze) zabronione jest przetwarzanie, przekazywanie czy przechowywanie numerów i innych danych dotyczących kart płatniczych. Jeśli posiadasz właściwy certyfikat PCI DSS i chcesz udostępnić formatkę płatności kartami na stronie Twojego sklepu - prosimy o kontakt z obsługą Axepta.
W przypadku bezpośredniego przekierowania na formatkę płatności kartami Axepta nie ma takiego wymogu.



## Servers
- Serwer produkcyjny.: https://api.axepta.pl/v1 (Serwer produkcyjny.)
- Sandbox - serwer testowy.: https://api.sandbox.axepta.pl/v1 (Sandbox - serwer testowy.)


## Authentication methods
- Token autoryzacyjny


## Parameters

### Path parameters

- **merchantId** (string)
  Identyfikator klienta



### Body: application/json (object)

- **type** (string)
  Typ transakcji. Dopuszczalne wartości: sale

- **serviceId** (string(uuid))
  Identyfikator sklepu jako `UUID v4`

- **amount** (integer)
  Kwota transakcji w najmniejszej jednostce waluty np. **grosze**

- **currency** (string)
  Waluta transakcji w standardzie `ISO 4217`

- **orderId** (string)
  Numer zamówienia akceptanta, dopuszczalne znaki: A-Za-z0-9#_-./ oraz znak spacji(0x20) i znaki z zakresu UNICODE 00C0 - 02C0 (m.in. polskie znaki diakrytyczne)        

- **title** (string)
  Tytuł transakcji, dopuszczalne znaki: A-Za-z0-9#&_-"',./ oraz znak spacji(0x20) i znaki z zakresu UNICODE 00C0 - 02C0 (m.in. polskie znaki diakrytyczne)

- **paymentMethod** (string)
  Metoda realizacji zamówienia. Więcej informacji w rozdziale [1.4 Metody i kanały realizacji transakcji]

- **paymentMethodChannel** (string)
  Oznaczenie kanału płatności. Więcej informacji w rozdziale [1.4 Metody i kanały realizacji transakcji]

- **successReturnUrl** (string(uri))
  Adres powrotu z zewnętrznej strony obsługującej płatność w przypadku dokonania płatności z powodzeniem

- **failureReturnUrl** (string(uri))
  Adres powrotu z zewnętrznej strony obsługującej płatność w przypadku wystąpienia błędu płatności

- **returnUrl** (string(uri))
  Domyślny adres powrotu.

- **clientIp** (string(ipv4, ipv6))
  Rzeczywisty adres IP płatnika podany w protokole `IPv4` lub `IPv6`. Wymagany przy podaniu [blikCode](#operation-post-parameter-transaction-body-application-json-blikCode).

- **activeTo** (integer, null)
  Data ważności transakcji jako unix timestamp w sekundach (czas mierzony w sekundach od początku 1970 roku UTC) (wartość musi być większa, bądz równa: 1 i mniejsza bądź równa 4294967295). Jeżeli nie jest przekazana lub jest null to transakcja ważna jest zawsze. Brak realizacji płatności do tego czasu spowoduje jej anulowanie.

- **blikCode** (integer)
  Wartość kodu blik dla transakcji z przekazaniem kodu po API.

- **distributor** (string)
  Nazwa dystybutora, wartość dopuszczalna: "shoper".

- **customer** (object)

- **card** (object)
  Dane dot. płatności kartą. (Wymagane podczas płatności card)   

- **additionalData** (object)
  Informacje o przeglądarce płatnika, wymagane podczas wykonywania płatności kartą z autoryzacją 3ds.



## Responses

[Powered by Bump.sh](https://bump.sh)