Pobieranie danych sklepu

Gdzie znaleźć shopId

Aby pobrać dane sklepu przez API PayU, potrzebujesz jego shopId, który znajdziesz w panelu menedżerskim. W zakładce Moje sklepy kliknij nazwę sklepu w jego kafelku.

Otworzy się zakładka Dane sklepu. Skopiuj wartość Id sklepu.

Mając shopId, możesz pobrać dane sklepu potrzebne do utworzenia wypłaty.

Uwierzytelnianie żądania

Aby pobrać dane sklepu, uwierzytelnij żądanie tokenem OAuth w trybie client_credentials. Wygeneruj token przy użyciu kluczy konfiguracyjnych punktu płatności (POS) należącego do sklepu, z którego chcesz pobrać dane.

Pobieranie danych sklepu

Ciało żądania metody GET

Wysyłając żądania z metodą GET, upewnij się, że w ciele żądania nie przesyłasz żadnych danych. Zgodnie ze standardem RFC 9110 żądania, które nie spełniają tego wymogu, zostaną odrzucone przez PayU i zwrócony zostanie kod HTTP 403.

Aby pobrać dane sklepu, wyślij żądanie HTTP GET na endpoint /api/v2_1/shops/{shopId}.

Przykład żądania pobrania danych sklepu

curl -X GET https://secure.payu.com/api/v2_1/shops/QFw0KGSX \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer 3e5cac39-7e38-4139-8fd6-30adc06a61bd'

Przykład odpowiedzi na żądanie pobrania danych sklepu

{
  "shopId": "QFw0KGSX",
  "name": "Shop Checkout",
  "currencyCode": "PLN",
  "balance": {
    "currencyCode": "PLN",
    "total": "220839",
    "available": "220839"
  }
}

W odpowiedzi otrzymasz identyfikator i nazwę sklepu oraz obiekt balance z parametrami potrzebnymi do utworzenia wypłaty:

• total – aktualne saldo sklepu;
• available – środki dostępne do wypłaty, czyli saldo po odjęciu blokady / rezerwy wypłat.

Szczegółowe informacje o parametrach znajdziesz w sekcji Retrieve Shop Data w naszej referencji API.

Gdy masz już shopId sklepu i znasz jego dostępne saldo, możesz przejść do tworzenia wypłaty.