Bramki Płatności

ID zamówienia w PayU to unikalny identyfikator przypisany każdemu zamówieniu utworzonemu za pośrednictwem systemu płatności PayU. Służy do jednoznacznego rozpoznawania oraz zarządzania zamówieniami i powiązanymi z nimi transakcjami online. Jest kluczowym elementem zarówno przy integracji technicznej sklepu internetowego z PayU, jak i w codziennym zarządzaniu płatnościami przez sprzedawcę.

Czym dokładnie jest ID zamówienia w PayU?

  • Unikalny identyfikator zamówienia – każde zamówienie utworzone w systemie PayU dostaje swój własny, unikalny identyfikator określany jako „orderId” (lub w niektórych dokumentacjach, po prostu ID zamówienia);
  • Znaczenie techniczne – ID zamówienia pozwala systemowi PayU oraz sklepom internetowym jednoznacznie odróżnić każde zamówienie. Dzięki temu możliwe jest monitorowanie statusu płatności, rozliczeń, zwrotów i ewentualnych reklamacji;
  • Wykorzystywanie w integracjach – ID zamówienia jest przekazywane w żądaniach API podczas komunikacji sklepu z PayU. Na jego podstawie można później pobrać lub zweryfikować szczegóły transakcji w systemie sklepu lub poprzez panel merchant (sprzedawcy);
  • Dostępność w panelu PayU – ID zamówienia można wyszukać w panelu administracyjnym PayU, co ułatwia obsługę klienta i księgowość.

Gdzie znaleźć ID zamówienia?

  • W panelu PayU sprzedawcy – po zalogowaniu do panelu administracyjnego PayU, każde zamówienie ma przypisane ID, które jest widoczne na liście transakcji lub w szczegółach płatności;
  • W komunikacji API – w odpowiedzi na utworzenie zamówienia PayU zwraca parametr „orderId” – należy go przechowywać w bazie danych sklepu, aby pozwolić na późniejszą identyfikację zamówienia w przyszłości.

Instrukcja – jak stworzyć zamówienie i odnaleźć jego ID w PayU (z użyciem API)

  1. Autoryzacja –
  • Uzyskaj token autoryzacyjny (tzw. access_token), korzystając z danych dostępowych do swojego konta PayU.
  1. Tworzenie zamówienia –
  • Wyślij żądanie POST do endpointu PayU (np. https://secure.payu.com/api/v2_1/orders) z danymi zamówienia w formacie JSON.
  • Minimalne wymagane dane to:
    • continueUrl: adres przekierowania po płatności
    • customerIp: IP klienta
    • merchantPosId: identyfikator punktu płatności
    • description: opis zamówienia
    • currencyCode: kod waluty (np. PLN)
    • totalAmount: kwota zamówienia w groszach
    • products: lista produktów (nazwa, cena jednostkowa, ilość)
  1. Odbiór odpowiedzi z PayU –
  • W odpowiedzi PayU przekaże m.in. parametr "orderId" – to właśnie szukane ID zamówienia.
  1. Zarządzanie statusem zamówienia –
  • Wszelkie późniejsze zapytania API do PayU (np. sprawdzanie statusu, anulowanie, zwroty) powinny wskazywać właśnie na ten numer ID zamówienia.

Przykład tworzenia zamówienia poprzez API (fragment danych JSON):

{
  "continueUrl": "https://twoj-sklep.pl/podsumowanie",
  "customerIp": "123.45.67.89",
  "merchantPosId": "145227",
  "description": "Zamówienie nr 1234",
  "currencyCode": "PLN",
  "totalAmount": 2899,
  "products": [
    {
      "name": "Słuchawki",
      "unitPrice": 2899,
      "quantity": 1
    }
  ]
}

W odpowiedzi otrzymasz między innymi:

{
  "status": "SUCCESS",
  "orderId": "XT56P8BQJF123456LIV000KS9B",
  ...
}

Najważniejsze funkcje ID zamówienia PayU

  • Monitorowanie statusu (np. oczekuje na płatność, opłacone, anulowane);
  • Weryfikacja w panelu sprzedawcy oraz w logach własnego sklepu;
  • Podstawa do obsługi zwrotów i reklamacji;
  • Niezbędny do komunikacji z PayU w sprawie jakiegokolwiek zamówienia.

Często zadawane pytania

Czy ID zamówienia PayU jest widoczne dla klienta?
Zazwyczaj nie jest domyślnie widoczne dla kupującego, choć nic nie stoi na przeszkodzie, aby sklep przekazał je klientowi np. w mailu potwierdzającym zamówienie.

Czym różni się ID zamówienia od PAYMENT_ID?

  • orderId – unikalny identyfikator zamówienia w systemie PayU;
  • PAYMENT_ID (Trans ID) – identyfikator konkretnej płatności/przelewu, który może być powiązany z orderId. Przydaje się przy rozliczeniach lub analizach wyciągów bankowych.

Podsumowanie

ID zamówienia w PayU jest fundamentalnym identyfikatorem całej operacji sprzedażowej obsługiwanej przez ten system. Powinno być archiwizowane przez sklep i wykorzystywane do wszelkich interakcji technicznych oraz obsługi zamówień wewnętrznie i na linii ze wsparciem PayU. Jego znajomość jest niezbędna zarówno w przypadku integracji automatycznych, jak i ręcznej obsługi płatności.