---
title: "Rejestracja transakcji przez API"
description: "Jeżeli nie chcesz instalować naszych skryptów rejestrujących transakcje, możesz skorzystać z API"
url: https://advertisers.getbuybox.com/pl/articles/9-rejestracja-transakcji-przez-api
collection: "Integracja"
updated: 2026-07-15
language: pl
---

# Rejestracja transakcji przez API

Jeżeli nie chcesz instalować naszych skryptów rejestrujących transakcje, możesz skorzystać z 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:**

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

Przykładowa odpowiedź:

```json
{
  "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

```json
{
  "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

```json
{
  "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