Program partnerski

W celu otrzymania wszelkich informacji związanych z warunkami współpracy i tym jak zostać partnerem PayU, prosimy o kontakt z nami pod adresem partnerzy@payu.pl.

Poniżej znajdują się informacje o tym jak zarejestrować poleconego klienta ("merchanta") w systemie PayU.

Uwaga: obecnie poprzez link można rejestrować tylko sklepy internetowe zamierzające działać na rynku polskim.

Link może być wysłany do potencjalnych klientów PayU pocztą elektroniczną lub zostać umieszczony na stronie internetowej partnera PayU. Link może być użyty dowolną ilość razy, każdy kto w niego kliknie zostanie przekierowany do procesu rejestracji PayU. Tak zarejestrowany merchant zostanie od razu oznaczony jako polecony przez partnera.

Link wygląda następująco:

https://secure.payu.com/boarding/#/form?lang=pl&nsf=false&partnerId=someid

Parametry są opisane poniżej:

Poprzednia wersja regulaminu jest tutaj.

Materiały graficzne do pobrania:

Standardowe

Alternatywne

"Merchant Registration API" pozwala partnerom rejestrować merchantow bezpośrednio w systemie PayU. API jest skierowane w szczególności do integratorów usług płatniczych i operatorów platform typu SaaS (eng. Software as a Service).

Pomimo automatycznego utworzenia merchanta (wspomaganego przez partnera), "Merchant Registration API" zakłada, że PayU wykonuje następujące procesy:

1. Weryfikację merchanta poprzez procedurę KYC (eng. Know-Your-Customer) w tym kontrolę AML (eng. Anti-Money-Laundering).
2. Zawieranie umów handlowych, zazwyczaj przez Internet za pośrednictwem panelu merchanta.
3. Aktywację merchanta w celu umożliwienia akceptowania płatności.

Dla celów tej dokumentacji "merchant" oznacza zestaw podmiotów wyznaczających rodzaj klienta, który generuje płatności i otrzymuje zapłaty od płatników.

W skrócie tymi podmiotami są:

1. Firma - osoba prawna (nazwa, adres, identyfikator podatkowy itp.).
2. Adres URL strony - adres internetowy sklepu, działalności charytatywnej lub innego płatnego serwisu.
3. Sklep - na tym poziomie, zdefiniowane są: waluta płatnicza, saldo oraz szczegóły dotyczące wypłat (wraz z numerem konta merchanta).
4. POS (eng. point of sale) - punkt płatności, na którym konfigurowane są dostępne metody płatności. Zlecenia płatności są generowane na tym poziomie.

Aby móc korzystać z "Registration API", musisz zarejestrować się jako "partner" (tj. zapisać się do programu partnereskiego PayU) i otrzymać własne klucze client_id i client_secret umożliwiające uwierzytelnienie połączenia z API.

"Registration API" jest również dostępne na sandbox.

Zanim uzyskasz klucze produkcyjne, możesz użyć ponizszych kluczy testowych:

• client_id = egmcvdo5
• client_secret = 9e0cad643b2d4f0bc1fe1750b9b706ec

Pełen proces rejestracji nowego merchanta w PayU:

1. Uzyskanie ogólnego tokena dostępowego OAuth w celu stworzenia Firmy.
2. Stworzenie nowej firmy, otrzymanie publicznego firmId.
3. Uzyskanie tokena dostępowego w kontekście danej Firmy dla tworzenia kolejnych encji dla Firmy.
4. Stworzenie URL dla Firmy, uzyskanie publicznego urlId.
5. Stworzenie Sklepu przypisanego do URL, uzyskanie publicznego shopId.
6. Stworzenie POSa dla sklepu, uzyskanie publicznego posId.
7. Uzyskanie danych konfiguracyjnych POSa i dodanie ich do twojej paltformy SaaS w celu tworzenia transakcji płatniczych w imieniu merchanta.
8. Uzyskanie tokena dostępowego OAuth2 w celu pobrania metod płatności z POSa.
9. Pobranie metod płatności wraz z ich statusami. Początkowo POS ma dostępną jedynie testową płatność i nie ma włączonych automatycznych wypłat. Dodanie aktywnych metod płatności oznacza aktywację merchanta przez PayU.

OAuth

Aby móc komunikować się z serwerami PayU, musisz pobrać token uwierzytelniający w standardzie OAuth.

Przykładowe żądanie pobrania tokena OAuth na sandbox:

                    curl -X POST 'https://secure.snd.payu.com/pl/standard/user/oauth/authorize' \
                    -d 'grant_type=client_credentials' \
                    -d 'client_id=egmcvdo5' \
                    -d 'client_secret=9e0cad643b2d4f0bc1fe1750b9b706ec'
    

Przykład odpowiedzi:

                    {
                        "access_token":"7524f96e-2d22-45da-bc64-778a61cbfc26",
                        "token_type":"bearer",
                        "expires_in":43199, //expiration time in seconds
                        "grant_type":"client_credentials"
                    }
    

Tworzenie firmy

Poniżej znajdują się przykłady żądań zawierających minimum danych koniecznych do utworzenia czeskiej i polskiej firmy. Więcej szczegółów na temat parametrów firmy możesz znaleźć w sekcji Parametry firmy.

               curl -X POST https://secure.snd.payu.com/api/v2_1/firms \
               -H "Content-Type: application/json" \
               -H "Authorization: Bearer d9a4536e-62ba-4f60-8017-6053211d3f47" \
               -d '{
	                   	"name": "Testowa sp. z o.o.",
	                   	"type": "SO",
	                   	"taxId": "3771910486",
	                   	"taxIdType": "NIP",
	                   	"cin": "138237420",
	                   	"bankAccount": "PL92906300080597567560803897",
	                   	"partnerId": "egmcvdo5",
	                   	"businessArea": {
	                   		"origin": "PL"
	                   	},
	                   	"users": [
	                   		{
	                   			"name": "Jan",
	                   			"surname": "Nowak",
	                   			"email": "jan.nowak@testowa.pl",
	                   			"phone": "123123123",
	                   			"role": "manager"
	                   		}
	                   	],
	                   	"representatives": [
	                   		{
	                   			"name": "Jan",
	                   			"surname": "Nowak",
	                   			"nin": "80010104578",
	                   			"countryCode": "PL"
	                   		}
	                   	],
	                   	"contactData": {
	                   		"phone": "123123123",
	                   		"email": "biuro@@testowa.pl"
	                   	},
	                   	"address": {
	                   		"street": "Grunwaldzka",
	                   		"houseNo": "186",
	                   		"apartmentNo": "1",
	                   		"postalCode": "61-166",
	                   		"city": "Poznań",
	                   		"countryCode": "PL"
	                   	}
                   }'
    

W odpowiedzi otrzymasz parametr firmId, który powinien być przechowywany w twoim systemie. Zostanie on użyty w celu stworzenia kolejnych podmiotów należących do danej firmy.

		{
			"firmId": "KzXy4ZzD"
		}
	

W celu utworzenia podmiotów, w ramach wcześniej zarejestrowanej firmy, potrzebujesz konkretnego dla danej firmy tokena OAuth.

Przykładowe żądanie pobrania tokena na sandbox:

                    curl -X POST 'https://secure.snd.payu.com/pl/standard/user/oauth/authorize' \
                    -d 'grant_type=partner' \
                    -d 'client_id=egmcvdo5' \
                    -d 'client_secret=9e0cad643b2d4f0bc1fe1750b9b706ec' \
                    -d 'firm_id=nZzFT4I5'
    

Przykładowa odpowiedź:

                    {
                        "access_token": "2f8fc432-81df-4cc6-8286-d1115214aca5",
                        "token_type": "bearer",
                        "refresh_token": "c4326c52-53b0-4191-850c-cb52a9f8da4c",
                        "expires_in": 43199,
                        "grant_type": "partner"
                    }
    

Po stworzeniu firmy i uzyskaniu tokena OAuth, musisz stworzyć adres URL.

URL powinien być prawdziwym adresem, z którego rozpoczynana jest "podróż klienta" (np. strona sklepu internetowego albo organizacji charytatywnej itp.).

Przy tworzeniu URL musisz wskazać pożądane usługi płatnicze.

W ścieżce endpointu zawiera się parametr firmId.

Przykład żądania

               curl -X POST 'https://secure.snd.payu.com/api/v2_1/firms/KzXy4ZzD/urls' \
               -H "Content-Type: application/json" \
               -H "Authorization: Bearer d9a4536e-62ba-4f60-8017-6053211d3f47" \
               -d '{
               "value":"http://www.test-url.com",
               "services":[
                  {
                  "type":"TRANSFERS"
                  },
                  {
                  "type":"CARD"
                  }
                 ]
               }'
   

W odpowiedzi otrzymasz parameter urlId, który powinien być zachowany w twoim systemie. Zostanie on wykorzystany do stworzenia sklepu.

    {
       "urlId": "PItR5x0v"
    }
  

Parametry żądania

Po stworzeniu firmy i adresu URL musisz założyć sklep.

Sklep wymaga odwołania do adresu URL. Jest on wykorzystywany do przechowywania salda konta płatniczego, dlatego jego najważniejszym parametrem jest currency.

W ścieżce endpointu zawiera się parametr firmId.

Przykład żądania

               curl -X POST 'https://secure.snd.payu.com/api/v2_1/firms/KzXy4ZzD/shops' \
               -H "Content-Type: application/json" \
               -H "Authorization: Bearer d9a4536e-62ba-4f60-8017-6053211d3f47" \
               -d '{
                     "name":"Shop name",
                     "description":"Shop description",
                     "currencyCode":"EUR",
                     "urlId":"PItR5x0v"
                 }'
   

W odpowiedzi otrzymasz parametr shopId, który powinien być przechowywany w twoim systemie i zostanie użyty przy tworzeniu POS.

       {
           "shopId": "ycmGyfCv"
       }
  

Parametry żądania

POS (eng. point of sale) jest ostatnim podmiotem, który powinieneś założyć.

POS jest zakładany w ramach sklepu, po którym dziedziczy waluty. Dane uwierzytelniające płatności są przechowywane na danym punkcie płatności.

W ścieżce endpointu powinien być zawarty parameter shopId.

Przykład żądania

               curl -X POST https://secure.snd.payu.com/api/v2_1/shops/ycmGyfCv/poses \
               -H "Content-Type: application/json" \
               -H "Authorization: Bearer d9a4536e-62ba-4f60-8017-6053211d3f47" \
               -d '{
                     "name":"Test POS",
                     "type":"REST"
                 }'
   

W odpowiedzi otrzymasz parametr posId, który powinien być przechowywany w twoim systemie, w celu pobrania danych POS.

       {
           "posId": "JyoMIVTY"
       }
  

Żądanie zawiera parametry name i type konkretnego POS. Parametr type domyślnie przyjmuje wartość REST i pozwala to na integrację płatności przez REST API.

W rzadkich przypakach, w których wymagane będzie użycie typu CLASSIC. W celu uzyskania dalszych wskazówek prosimy o kontakt z obsługą techniczą PayU.

Pobieranie danych POS

     curl -X POST 'https://secure.snd.payu.com/api/v2_1/poses/JyoMIVTY' \
     -H 'Authorization: Bearer d9a4536e-62ba-4f60-8017-6053211d3f47'
    

W odpowiedzi otrzymasz pełen zestaw danych, które pozwolą ci na uwierzytelnienie płatności, zwrotów, a także umożliwią sprawdzenie powiadomień o statusie płatności.

       {
          "posId": "JyoMIVTY",
          "type": "REST",
          "name": "Test POS",
          "encoding": "UTF-8",
          "authorization": {
              "standard": {
                  "merchantPosId": "385234",
                  "key": "9c0041e05fdee99749de4c2d2ce4c66e",
                  "secondKey": "f096a39d78fbe03b8d23dde43b728cfd",
                  "authKey": "uHcZ9Ly"
              }
          }
      }
  

Po otrzymaniu danych POS możesz rozważyć wykorzystanie ich, nie tylko w kontekście integracji usług płatniczych określonych w REST API, ale także do wywołań API niezwiązanych bezpośrednio z płatnościami, np.

• Pobranie dostępnych metod płatności, (metody płatności są zwracane tylko w przypadku gdy merchant został aktywowany).
• Pobranie salda merchanta.
• Ułatwienie wypłat.