# Utworzenie linku płatności

**POST /{merchantId}/payment**

Zapytanie umożliwia utworzenie linku do bramki płatniczej imoje ze wszystkimi dostępnymi metodami płatności lub z tylko wybranymi za pomocą tablicy `visibleMethod`.
>Każdy nieopłacony link wygaśnie automatycznie po upływie 15 miesięcy od daty jego utworzenia. Jeśli chcesz aby wygasał szybciej, skorzystaj z parametru `validTo`.



## Servers
- Środowisko produkcyjne: https://api.imoje.pl/v1/merchant (Środowisko produkcyjne)
- Środowisko testowe: https://sandbox.api.imoje.pl/v1/merchant (Środowisko testowe)


## Authentication methods
- Token autoryzacyjny


## Parameters

### Path parameters
- **merchantId** (string)
  Identyfikator klienta


### Body: application/json (object)

- **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
- **customer** (object)
  Dane płatnika
- **title** (string)
  Tytuł transakcji
- **additionalDescription** (string)
  Szczegóły zamówionych produktów lub usług
- **visibleMethod** (array[string])
  Metody płatności widoczne na bramce płatności. Jeśli tego pola nie ma lub jest puste to są wyświetlane wszystkie włączone w sklepie klienta metody płatności. Istnieje wiele konfiguracji wyświetlania metod płatności. Należy je zawsze rozdzielać przecinkiem.
- **preselectMethodCode** (string)
  Kanał płatności ustawiony jako domyślny i automatycznie wybrany po otwarciu bramki płatności. Jeśli tego pola nie ma to bramka otwiera się bez wybranego zaznaczonego kanału płatności. Pole nie może być zdefiniowane i pozostawione bez wartości.
- **returnUrl** (string(uri))
  Adres powrotu z zewnętrznej strony obsługującej płatność w przypadku nie rozstrzygnięcia statusu transakcji. Adres musi być zgodny ze standardem URL `RFC 3986`.
- **successReturnUrl** (string(uri))
  Adres powrotu z zewnętrznej strony obsługującej płatność w przypadku dokonania płatności z powodzeniem. Adres musi być zgodny ze standardem URL `RFC 3986`.
- **failureReturnUrl** (string(uri))
  Adres powrotu z zewnętrznej strony obsługującej płatność w przypadku wystąpienia błędu płatności. Adres musi być zgodny ze standardem URL `RFC 3986`.
- **notificationUrl** (string(uri))
  Dynamiczny adres notyfikacji, możliwość ustawienia konkretnego adresu dla pojedynczej transakcji.
  Adresy zawierające `localhost` oraz porty zostaną odrzucone.
- **validTo** (integer | null)
  Data ważności transakcji jako **timestamp w sekundach**. Brak realizacji płatności do tego czasu spowoduje jej anulowanie. Jeżeli nie jest przekazane to transakcja ważna jest do czasu ustawionego w parametrze *Aktywność płatności* w Panelu Administracyjnym imoje (ustawienia sklepu) lub po upływie 15 miesięcy. Przekazanie parametru `validTo`= `NULL` powoduje brak wygaśnięcia transakcji z pominięciem ustawień w parametrze *Aktywność płatności* na Panelu Administracyjnym imoje (ustawienia sklepu). **Minimalny** czas ważności linku to **60 sekund**.
- **billing** (object)
  Adres rozliczeniowy płatnika
- **shipping** (object)
  Adres dostawy
- **cart** (object)
  Informacje o zamówionych produktach. Wymagane przy aktywnej usludze [ING Lease Now](https://bump.sh/pgw/doc/imoje-api#topic-ing-lease-now).
- **multipayout** (array[object])
  Informacje na temat numerów rachunków, na jakie mają zostać wypłacone środki z transakcji. <br> Wymagana aktywna funkcja [multiwypłat](https://bump.sh/pgw/doc/imoje-api#topic-multiwyplaty).

  > info
  > W przypadku korzystania z płatności Split Payment, maksymalna dopuszczalna kwota, jaką można przekazać w ramach multiwypłat jest równa kwocie netto zamówienia.
- **invoice** (object)
  Dane do faktury wymagane przy aktywnej usłudze [ING Księgowość](https://bump.sh/pgw/doc/imoje-api#topic-ing-ksiegowosc) oraz przy płatności `Split payment`.

  > info
  > Obiekt nie może być użyty, jeśli w sklepie włączona jest opłata serwisowa.
- **isKsef** (boolean)
  Czy generować identyfikator płatności KSeF (IPKSeF)


## Responses
### 200
Zapytanie wykonane poprawnie


#### Body: application/json (object)
- **payment** (object)


### 422
Payload nie zawiera wymaganaych parametrów, zawiera niedopuszczalne parametry, lub przesłane w nich wartości nie spełniają wymogów.


#### Body: application/json (object)
- **apiErrorResponse** (object)
  Szczegóły błędu 


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