Przejdź do głównej zawartości

Account Funding Transaction

Account Funding Transaction (AFT) to szczególny typ transakcji kartowej, wyróżniony przez organizacje kartowe Visa i Mastercard w celu odróżnienia standardowego zakupu towarów lub usług od transakcji polegających na pobraniu środków z jednego rachunku (np. karty) w celu zasilenia innego kwalifikowanego rachunku, portfela lub karty, a także na potrzeby późniejszego transferu środków. Jest to wymagane w przypadku takich operacji jak:

  • transfer między własnymi rachunkami użytkownika, tzw. account-to-account lub me-to-me,
  • doładowanie portfela elektronicznego lub wirtualnego,
  • doładowanie kart lub rachunku prepaid,
  • zasilenie rachunku wykorzystywanego do nabycia aktywów płynnych i finansowych, takich jak waluty, akcje, inne papiery wartościowe lub kryptowaluty.

Integracja AFT​

Przed aktywacją płatności w trybie AFT PayU musi przeprowadzić niezbędną konfigurację oraz uzyskać zgody organizacji Visa i Mastercard. Dlatego skontaktuj się z naszym przedstawicielem, aby rozpocząć ten proces jak najszybciej.

Po zakończeniu tego procesu PayU przygotowuje odpowiednią konfigurację sklepu lub POS-a, tak aby obsługiwać wymagane przypadki użycia. Klasyfikacja transakcji jako AFT wynika z konfiguracji wykonanej po stronie PayU, a nie z osobnego parametru przekazywanego w standardowym żądaniu utworzenia zamówienia.

Notatka

Aby poznać szczegóły procesu aktywacji AFT, skontaktuj się ze swoim opiekunem handlowym lub zespołem wsparcia PayU.

Aby obsługiwać AFT, musisz również rozszerzyć integrację z PayU o dodatkowe pola przedstawione w sekcji Rozszerzenie API dla AFT.

Rozszerzenie API dla AFT​

Z punktu widzenia API, aby poprawnie utworzyć zamówienie w trybie AFT, należy przekazać w sekcji buyer następujące pola:

  • firstName - użyj standardu kodowania ISO/IEC 8859-1,
  • lastName - użyj standardu kodowania ISO/IEC 8859-1,
  • birthDate - podaj w formacie ISO 8601 (np., 2006-12-03T00:00:00.000Z).

Pola te nie są oznaczone jako wymagane w ogólnej specyfikacji API Create an Order. Jednak po włączeniu trybu AFT dla sklepu lub POS-a, brak tych danych może skutkować odrzuceniem transakcji kartowej. Dlatego przed aktywacją AFT należy upewnić się, że integracja przekazuje wymagane dane kupującego.

Wartości tych pól muszą być poprawne i niepuste. Szczegółowa specyfikacja techniczna znajduje się w sekcji Create an Order naszej dokumentacji API. Podczas tworzenia zamówienia możesz skorzystać z Tokenizacji Kart, jak pokazano w poniższym przykładzie, lub z płatności z podaniem Danych Karty w Postaci Tekstowej.

Przykład żądania AFT z tokenem kartowym
curl -v -X POST https://secure.payu.com/api/v2_1/orders \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer 3e5cac39-7e38-4139-8fd6-30adc06a61bd" \
    -d '{
        "notifyUrl": "https://your.eshop.com/notify",
        "customerIp": "127.0.0.1",
        "merchantPosId": "145227",
        "description": "Account topup",
        "currencyCode": "PLN",
        "totalAmount":"15000",
        "extOrderId": "x25doraf1g5jite4uhrvlj",
        "buyer": {
            "email": "email@email.com",
            "firstName": "John",
            "lastName": "Doe",
            "birthDate": "2006-12-03T00:00:00.000Z"
        },
        "products": [
            {
                "name": "Invoice payment",
                "unitPrice": "15000",
                "quantity":"1"
            }
        ],
        "payMethods": {
            "payMethod": {
                 "value": "TOKC_2IHRST6HKSST3H62K2GS8pElI862",
                 "type":  "CARD_TOKEN"
            }
        }
    }'

Na tej stronie