# Postback Documentation

Base URL Example:

```
https://adclickforge.com/api/v1/pb/{SITE_KEY}/track
```

## Parameters

| Parameter     | Required | Description                     |
| ------------- | -------- | ------------------------------- |
| `subId`       | Yes      | Unique user identifier.         |
| `transId`     | Yes      | Unique transaction ID.          |
| `reward`      | Yes      | Virtual reward value.           |
| `payout_usd`  | Yes      | Payout in USD.                  |
| `ip`          | Yes      | User IP address.                |
| `offer_name`  | Yes      | Offer name completed.           |
| `status`      | Yes      | 1=credit, 2=reverse.            |
| `type`        | Yes      | Offer type.                     |
| `country`     | Yes      | Country ISO2.                   |
| `uuid`        | Yes      | Unique click ID.                |
| `signature`   | Yes      | MD5 hash for validation.        |
| `sign`        | Yes      | Secret site key.                |
| `campaign_id` | Optional | Campaign ID.                    |
| `goal_id`     | Optional | Goal ID.                        |
| `event`       | Optional | Event name.                     |
| `currency`    | Optional | Currency (default: USD).        |
| `timestamp`   | Optional | Conversion timestamp (ISO8601). |

***

## Example Postback

```
https://adclickforge.com/api/v1/pb/XYZ123/track?subId=USER123&transId=TX456&reward=50&payout_usd=0.5&ip=1.2.3.4&country=US&offer_name=Survey+ABC&status=1&type=Survey&uuid=UUID789&signature=abc123&sign=SECRETKEY&campaign_id=99&goal_id=1&event=registration&currency=USD&timestamp=2025-08-18T12:30:00Z
```