W tym wpisie znajdziesz przykłady mapowań płatności dla wybranych integracji. Jeśli nie widzisz tutaj swojej platformy, w większości przypadków wystarczą standardowe ustawienia opisane w artykule Mapowania płatności.
W tym artykule znajdziesz
- jak czytać przykłady mapowań
- mapowanie płatności w integracji Allegro
- mapowania w integracjach ze sklepami internetowymi
- przykłady mapowań w integracji InPost Buy
- mapowania w integracji IdoSell (IAI)
Jak czytać przykłady mapowań
W aktualnym formularzu mapowań płatności uzupełniasz przede wszystkim pola:
- E-commerce – nazwa płatności zwracana przez sklep lub marketplace,
- Waluta – waluta przypisana do mapowania, jeśli chcesz ją rozróżniać,
- xSale – forma płatności, która ma zostać ustawiona w xSale,
- Rejestr i Operacja – pola używane wtedy, gdy konfiguracja przewiduje przekazywanie tych danych dalej do ERP.
Najważniejsza zasada jest zawsze taka sama: nazwa w kolumnie E-commerce musi odpowiadać nazwie zwracanej przez źródło zamówienia.
Mapowanie płatności w integracji Allegro
W Allegro możesz spotkać m.in. poniższe nazwy płatności. Wpisz je w polu E-commerce i przypisz odpowiednią formę płatności z xSale:
- CASH_ON_DELIVERY – pobranie,
- PAYU – PayU,
- P24 – Przelewy24,
- EXTENDED_TERM – płatność odroczona,
- AF – Allegro Finance.
Jeśli w Twojej bazie nazwy form płatności wyglądają inaczej, nie musisz ich zmieniać. Wystarczy, że w mapowaniu połączysz nazwę z Allegro z właściwą formą płatności w xSale.
Mapowania w integracjach ze sklepami internetowymi
Dla sklepów internetowych dokładną nazwę formy płatności znajdziesz w panelu administracyjnym sklepu. To właśnie tę wartość należy wpisać w polu E-commerce.
Płatność przez InPost Pay
Przy dodawaniu płatności InPost Pay w integracji ze sklepem konfiguracja przebiega tak samo, jak przy każdej innej nowej metodzie płatności:
- sprawdź w sklepie nazwę płatności używaną dla zamówień opłaconych przez InPost Pay,
- utwórz w xSale formę płatności o takiej samej nazwie albo wybierz istniejącą formę, do której chcesz ją przypisać,
- dodaj odpowiednie mapowanie w ustawieniach integracji.
Jeśli chcesz, możesz pozostawić w xSale własną nazwę formy płatności. Kluczowe jest tylko poprawne powiązanie jej z nazwą zwracaną przez sklep.
Przykłady mapowań w integracji InPost Buy
W integracji InPost Buy mapowanie płatności polega na przypisaniu nazw zwracanych przez marketplace do form płatności używanych już w systemie xSale.
Dzięki temu zamówienia pobrane z InPost Buy od razu otrzymują właściwą formę płatności w xSale i nie wymagają późniejszego ręcznego poprawiania.
Z InPost Buy mogą przyjść następujące wartości, które można wykorzystać w polu E-commerce:
- CARD
- CARD_TOKEN
- GOOGLE_PAY
- APPLE_PAY
- BLIK_CODE
- BLIK_TOKEN
- PAY_BY_LINK
- SHOPPING_LIMIT
- DEFERRED_PAYMENT
- CASH_ON_DELIVERY
Przykładowo:
- CASH_ON_DELIVERY możesz zmapować na formę płatności oznaczającą pobranie,
- BLIK_CODE lub BLIK_TOKEN możesz przypisać do formy płatności BLIK,
- PAY_BY_LINK, CARD, CARD_TOKEN, GOOGLE_PAY oraz APPLE_PAY możesz przypisać do odpowiednich form płatności online używanych w Twojej organizacji,
- DEFERRED_PAYMENT oraz SHOPPING_LIMIT możesz powiązać z formą płatności odroczonej lub inną formą stosowaną do takiego sposobu rozliczenia.
Integracja z IdoSell (IAI)
Sklepy IdoSell zwracają osobno formy płatności i sposoby zapłaty. W praktyce oznacza to, że możesz używać mapowań na dwa sposoby, zależnie od tego, co chcesz osiągnąć.
Zamówienia
Dla zamówień najczęściej wykorzystywane są trzy nazwy:
- cash_on_delivery – pobranie,
- prepaid – przedpłata,
- tradecredit – kredyt kupiecki.
Tworząc mapowania dla zamówień, wpisz te wartości w polu E-commerce, a po stronie xSale wybierz odpowiednią formę płatności. Dzięki temu pobrane zamówienia otrzymają prawidłową formę płatności w xSale i, jeśli korzystasz z ERP, dane będą mogły zostać przekazane dalej.
Płatności
W IdoSell możesz dodatkowo rozróżniać sposoby zapłaty na potrzeby zapisu płatności w ERP, np. w odpowiednim rejestrze kasowym lub bankowym.
- W kolumnie E-commerce wpisz wartość odpowiadającą sposobowi zapłaty z IdoSell.
- W kolumnie Rejestr i polu Operacja podaj dane potrzebne do zapisania płatności w odpowiednim rejestrze ERP.
- W kolumnie xSale ustaw formę płatności, która ma być używana dla tego typu zapłaty.
W wielu konfiguracjach dla sposobów zapłaty IAI w kolumnie xSale ustawia się tę samą wartość, która została użyta wcześniej dla płatności typu prepaid.

Przykładowe mapowanie
Na poniższym przykładzie:
- pierwsze mapowania pokazują przypisanie płatności do zamówień,
- kolejne pokazują przypisanie sposobu zapłaty do odpowiedniego rejestru.
