Tworzenie wypłaty

Do zlecenia wypłaty przez API potrzebujesz tylko shopId sklepu, z którego salda chcesz wypłacić środki. Jak go uzyskać, dowiesz się ze strony Pobieranie danych sklepu.

Notatka

Wypłaty trafiają na rachunek bankowy zdefiniowany na poziomie sklepu lub firmy.

Uwierzytelnianie żądania

Aby utworzyć wypłatę, 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 wypłacasz środki.

Tworzenie wypłaty

Możesz zlecić wypłatę pełną lub częściową.

W obu przypadkach wyślij żądanie HTTP POST na endpoint /api/v2_1/payouts. W przypadku wypłaty częściowej dodaj też obiekt payout z parametrem amount, który określa kwotę wypłaty, oraz parametrem extPayoutId – Twoim unikalnym w obrębie sklepu identyfikatorem wypłaty. W przypadku wypłaty pełnej pomiń parametr amount – zostaną wypłacone wszystkie dostępne środki.

Pełna wypłata

curl -X POST https://secure.payu.com/api/v2_1/payouts \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 3e5cac39-7e38-4139-8fd6-30adc06a61bd" \
-d '{
    "shopId": "n7Cd7y1U"
}'

Częściowa wypłata

curl -X POST https://secure.payu.com/api/v2_1/payouts \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 3e5cac39-7e38-4139-8fd6-30adc06a61bd" \
-d '{
    "shopId": "n7Cd7y1U",
    "payout":
    {
        "extPayoutId": "123123",
        "amount": 1100
    }
}'

Notatka

Pozostałe dane potrzebne do wypłaty PayU uzupełni automatycznie na podstawie informacji przechowywanych w systemie PayU.

Przykłady odpowiedzi na żądanie utworzenia wypłaty:

Pełna wypłata

{
  "payout": {
    "payoutId": "133bfe5f400e4b2c8da44abfdf753d79",
    "status": "PENDING"
  },
  "status": {
    "statusCode": "SUCCESS"
  }
}

Częściowa wypłata

{
  "payout": {
    "payoutId": "133bfe5f400e4b2c8da44abfdf753d79",
    "extPayoutId": "123123",
    "status": "PENDING"
  },
  "status": {
    "statusCode": "SUCCESS"
  }
}

Na podstawie payoutId zwróconego w odpowiedzi możesz pobrać dane wypłaty, np. aby sprawdzić jej status.

Szczegółowe informacje o parametrach znajdziesz w sekcji Create a Payout w naszej referencji API.