Rejestracja transakcji przez API

Komunikacja 

API dostępne jest wyłącznie z użyciem protokołu HTTPS pod adresem https://shop-api.buybox.click/.

POST /registerEntry

Zapytanie zgłaszające przekierowanie z widgetu. Należy wywołać kiedy sklep zostanie odwiedzony z parametrem bbclid. Jeśli w adresie URL znajdzie się parametr “_ga”, to należy go również przekazać.

Przykładowe zapytanie:

{
  "bbclid": "{bbclid}",
  "bb_cid": {your-shop-ID},
  "_ga": "{_ga}",
}

Przykładowa odpowiedź:

{
  "bbuuid": "{visitor-ID}",
  "expiry": 90,
}

POST /registerOrder

Zapytanie zgłaszające nam zamówienie / transakcję, wraz z informacją o zamówionych produktach i szczegółach rozliczeniowych (prowizje). Należy je wywołać po potwierdzeniu zamówienia (ostatni krok procesu zakupowego).

Przykładowe zapytanie:

Transakcja z produktami

{
  "campaignId": {your-shop-ID},
  "bbuuid": "{visitor-ID}",
  "orderId": "{your-order-ID}",
  "products": [
	{
  	"productId": "{your-product-ID}",
  	"quantity": {item-quantity},
  	"gross": {item-gross-price},
  	"net": {item-net-price},
  	"commissionId": {your-commission-id}
	}
  ]
}

Transakcje bez produktów

{
  "campaignId": {your-shop-ID},
  "bbuuid": "{visitor-ID}",
  "orderId": "{your-order-ID}",
  "commissionId": {your-commission-id},
  "gross": {item-gross-price}
}

Przykładowa odpowiedź:
Serwer zwróci pustą odpowiedź ze statusem 200.

Omówienie:

Wyboldowane parametry są obowiązkowe.

• {bbclid} – identyfikator przejścia do sklepu (kliknięcia) – wartość parametru bbclid

• {your-shop-ID} – unikalny identyfikator sklepu podany w panelu systemu BUY.BOX

• {visitor-ID} – identyfikator nadawany odwiedzającemu, należy go przechowywać, przez ilość dni podanych w “expiry”. Użytkownik musi być identyfikowalny przy każdorazowym powrocie do sklepu

• {your-order-ID} – identyfikator zamówienia / transakcji w sklepie

• {your-product-ID} – identyfikator produktu zgodny z identyfikatorem oferty przekazywanej nam w pliku XML

• {item-quantity} – liczba zamówionych produktów

• {item-gross-price} – cena jednostkowa produktu brutto

• {your-commission-id} – identyfikator prowizji używanej do rozliczeń dla danej pozycji zamówienia