Podczas tworzenia Zamówień za pomocą interfejsu API Montonio napotkasz wymagany parametr merchantReference.
Dla każdego zamówienia tworzonego w Montonio należy podać unikalną wartość parametru merchantReference. Ta unikalność jest wymuszana w zakresie każdego sklepu.
Wartością powinien być identyfikator zamówienia. Jako sprzedawca prawdopodobnie śledzisz swoje zamówienia za pomocą unikalnego numeru referencyjnego. W wielu platformach e-commerce (takich jak WooCommerce, PrestaShop i Magento) jest to identyfikator zamówienia. Należy po prostu przekazać swój identyfikator zamówienia do Montonio w parametrze merchantReference żądania POST /orders.
Oto kilka przykładów tego, jak mogą wyglądać identyfikatory zamówień:
123456
ORD-EE1234
RHJSWIKDL
907f07f9-5cd9-43f9-98ca-f79e2b274726
Nie musi to być identyfikator zamówienia w systemie. Może to być również identyfikator koszyka, identyfikator sesji, numer faktury lub dowolna inna unikalna wartość identyfikująca sesję płatności.
Kiedy powiadamiamy Cię o udanych płatnościach za pośrednictwem powiadomień webhook, odsyłamy Ci również podane przez Ciebie merchantReference. Pomaga to w dalszym dopasowywaniu i sprawdzaniu, które zamówienie zostało opłacone. MerchantReference jest używany w dodatku do identyfikatora UUID zamówienia Montonio, który przekazujemy jako odpowiedź na wywołanie POST /orders.
⚠️ Co jeśli podam ten sam merchantReference dla dwóch różnych zamówień?
Dla każdego zamówienia należy przesłać nam unikalny merchantReference. Jeśli wyślesz nam ten sam merchantReference, wykorzystamy w takim przypadku ponownie istniejące zamówienie.
Jeśli zamówienie nie zostało jeszcze opłacone, zastąpimy szczegóły zamówienia (w tym kwotę) i podamy nowy adres URL płatności, umożliwiając klientowi opłacenie tego samego zamówienia z nowymi danymi.
Jeśli zmieniasz kwotę zamówienia (grandTotal), prosimy o utworzenie nowego zamówienia zamiast ponownego wykorzystywania już istniejącego. Ponowne użycie zamówienia przy jednoczesnej zmianie jego wartości może umożliwić klientom zrealizowanie płatności na kwotę niższą niż pierwotnie zamierzona.
Jeśli jednak zamówienie z tym merchantReference zostało już opłacone, interfejs API zgłosi błąd.
🔍 Ale nie mam identyfikatorów zamówień
Jeśli nie masz unikalnego identyfikatora dla sesji płatności lub zamówienia bieżącego użytkownika, należy go utworzyć. Unikalny identyfikator będzie potrzebny do identyfikacji sesji płatności klienta niezależnie od używanej bramki płatności.
Jeśli naprawdę nie chcesz tworzyć identyfikatorów dla swoich sesji, możesz przekazać nam świeżo wygenerowany identyfikator UUID v4 przy każdym zamówieniu. Jednak w takim przypadku należy zapisać ten identyfikator UUID w bazie danych, aby później dopasować nasze powiadomienia webhook do sesji. Alternatywnie, w celu późniejszego dopasowania zamówień, można użyć naszego identyfikatora UUID zamówienia, który podajemy w odpowiedzi na punkt końcowy POST /orders.
❓Dlaczego muszę przekazać mój identyfikator zamówienia do Montonio?
Wymagamy przesłania nam identyfikatora zamówienia głównie w celu zapewnienia dobrego doświadczenia użytkownika i klientów.
Dla naszych partnerów wyświetlamy merchantReference lub identyfikator zamówienia w naszym systemie partnerskim oraz w eksportach zamówień otrzymywanych z systemu partnerskiego. Ułatwia to wyszukiwanie zamówień w Montonio, a księgowym dopasowywanie płatności przychodzących do zamówień w eksporcie.
Dla płatników/klientów końcowych wyświetlamy merchantReference w bramce płatności, w opisach płatności i w innych odpowiednich miejscach. Ułatwia to klientom sprawdzenie, za które zamówienia płacą, i późniejsze sprawdzenie płatności w wyciągach z konta bankowego.