Wypłaty wielowalutowe

Wypłaty wielowalutowe rozszerzają API wypłat o wypłaty w walucie innej niż waluta sklepu. Przewalutowanie jest dostępne między walutami PLN, CZK, EUR i HUF.

Wymagania

Wypłaty wielowalutowe wymagają specjalnej konfiguracji po stronie PayU i spełnienia określonych wymagań formalnych.

Wypłaty wielowalutowe są dostępne tylko przy wypłatach na rachunek bankowy submerchanta marketplace.

Pobieranie tabeli kursów

Do przewalutowania wypłat używaj kursów udostępnianych przez PayU. Aby pobrać tabelę kursów, wygeneruj token OAuth i wyślij żądanie HTTP GET na endpoint /api/v2_1/mcp-partners/{fxPartnerId}/fx-table.

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.

Przykład żądania pobrania tabeli kursów
curl -X GET https://secure.payu.com/api/v2_1/mcp-partners/9999e44b-f68f-42e1-ad6c-3735ba1e2954/fx-table \
-H "Authorization: Bearer 3e5cac39-7e38-4139-8fd6-30adc06a61bd"

Szczegóły parametrów znajdziesz w sekcji Retrieve Rate Table w naszej referencji API.

W odpowiedzi PayU zwraca obiekt zawierający pary walutowe wraz z ich kursami.

Odświeżanie tabeli kursów

Zawsze korzystaj z najnowszej tabeli kursów. Nową tabelę pobieraj natychmiast po wygaśnięciu poprzedniej.

Przykład odpowiedzi na żądanie pobrania tabeli kursów
{
    "id": "3050",
    "validTo": "2024-05-12T20:20:00Z",
    "currencyPairs": [
        {
            "baseCurrency": "EUR",
            "exchangeRate": 4.2556,
            "termCurrency": "PLN"
        }
        ...
    ]
}

Rozszerzenie żądania wypłaty

Aby wykonać wypłatę z przewalutowaniem, wyślij rozszerzone żądanie wypłaty metodą HTTP POST na endpoint /api/v2_1/payouts. Dodaj do żądania następujące obiekty:

account – zawierający identyfikator submerchanta,
payout – zawierający walutę sklepu i kwotę wypłaty,
fxData – zawierający dane potrzebne do przewalutowania.

Przykład żądania wypłaty wraz z przewalutowaniem
{
  "shopId": "JahDKDVm",
  "account": {
    "extCustomerId": "submerchant1"
  },
  "payout": {
    "currencyCode": "PLN",
    "description": "Some payout",
    "extPayoutId": "my_payout_id_123455",
    "amount": 49
  },
  "fxData": {
    "partnerId": "9999e44b-f68f-42e1-ad6c-3735ba1e2954",
    "currencyCode": "EUR",
    "amount": 11,
    "rate": 0.22458,
    "tableId": "2055"
  }
}

Szczegółowe informacje na temat parametrów znajdziesz w sekcji Create a Payout w naszej referencji API.

Odpowiedź na żądanie wypłaty wielowalutowej

Jeśli wypłata została zlecona poprawnie, PayU zwraca potwierdzenie z danymi wypłaty.

Przykład odpowiedzi na żądanie wypłaty
{
    "payout": {
        "payoutId": "bd71af6089ed4723b8699a9b4d14432c",
        "extPayoutId": "my_payout_id_123455",
        "extCustomerId": "submerchant1",
        "amount": 49,
        "currencyCode": "PLN",
        "status": "PENDING",
        "fxData": {
            "currencyCode": "EUR",
            "amount": 11,
            "rate": 0.22458,
            "partnerId": "9999e44b-f68f-42e1-ad6c-3735ba1e2954",
            "tableId": "2055"
        }
    },
    "status": {
        "statusCode": "SUCCESS"
    }
}

Pobieranie danych wypłaty wielowalutowej

Aby pobrać dane wypłaty wielowalutowej, wyślij żądanie HTTP GET na endpoint /api/v2_1/payouts/{payoutId}. Parametr payoutId jest zwracany w odpowiedzi na żądanie wypłaty.

Odpowiedź zawiera dane wypłaty i jej bieżący status.

Odpowiedź na żądanie pobrania danych wypłaty
{
    "payout": {
        "payoutId": "bd71af6089ed4723b8699a9b4d14432c",
        "extPayoutId": "my_payout_id_123455",
        "amount": 49,
        "currencyCode": "PLN",
        "description": "Billing: 5000000444",
        "status": "PENDING",
        "fxData": {
            "currencyCode": "EUR",
            "amount": 11,
            "rate": 0.22458,
            "partnerId": "9999e44b-f68f-42e1-ad6c-3735ba1e2954",
            "tableId": "2055"
        }
    },
    "status": {
        "statusCode": "SUCCESS"
    }
}

Szczegółowe informacje na temat parametrów znajdziesz w sekcji Retrieve a Payout w naszej referencji API.