# Utworzenie zamówienia linku płatności

**POST /merchant/{merchantId}/payment-link**




## 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)

- **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ł zamówienia, dopuszczalne znaki: A-Za-z0-9#&_-"',./ oraz znak spacji(0x20) i znaki z zakresu UNICODE 00C0 - 02C0 (m.in. polskie znaki diakrytyczne).

- **customer** (object)

- **returnUrl** (string(uri))
  Adres powrotu z zewnętrznej strony obsługującej płatność w przypadku nie rozstrzygnięcia statusu 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

- **visibleMethod** (array)
  Widoczność metod płatności, domyślnie widoczne są wszystkie dostępne dla sklepu. [Opis w punkcie 5.3 Widoczność metod płatności](https://bump.sh/pgw/doc/axepta-api/topic/topic-5-3-widocznosc-metod-platnosci)

- **paywall.forceCardChannel** (string)
  Wymuszenie trybu płatności kartą. Pozwala na inicjalizację płatności kartą w trybie zapisywania profilu kartowego.
  Dostępne wartości: ecom3ds, oneclick, recurring. W przypadku korzystania z oneclick lub recurring. wymagane jest przekazanie parametru customer.cid.

- **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.

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

- **surcharge** (boolean)
  Flaga determinujaca czy zostanie użyte obciazenie platnika dla danego zamowienia. Wartość dopuszczalna: 'true', 'false' (wymagane ustawienie flagi surcharge w procesie boardingu).



## Responses

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