curl -X GET "https://api.linquid.io/api/conversions/postback?lw_cid=abc123xyz789&amount=99.99¤cy=USD&event=purchase&orderId=ORD-12345" \
-H "X-API-Key: lw_your_api_key_here"
const params = new URLSearchParams({
lw_cid: 'abc123xyz789',
amount: '99.99',
currency: 'USD',
event: 'purchase',
orderId: 'ORD-12345',
});
const response = await fetch(
`https://api.linquid.io/api/conversions/postback?${params}`,
{ headers: { 'X-API-Key': 'lw_your_api_key_here' } }
);
import requests
response = requests.get(
'https://api.linquid.io/api/conversions/postback',
params={
'lw_cid': 'abc123xyz789',
'amount': 99.99,
'currency': 'USD',
'event': 'purchase',
'orderId': 'ORD-12345',
},
headers={'X-API-Key': 'lw_your_api_key_here'}
)
{
"success": true,
"data": {
"conversionId": "conv_def456",
"clickId": "abc123xyz789",
"tracked": true
}
}
Conversions and Tracking
S2S Postback
Track a conversion via server-to-server postback
GET
/
api
/
conversions
/
postback
curl -X GET "https://api.linquid.io/api/conversions/postback?lw_cid=abc123xyz789&amount=99.99¤cy=USD&event=purchase&orderId=ORD-12345" \
-H "X-API-Key: lw_your_api_key_here"
const params = new URLSearchParams({
lw_cid: 'abc123xyz789',
amount: '99.99',
currency: 'USD',
event: 'purchase',
orderId: 'ORD-12345',
});
const response = await fetch(
`https://api.linquid.io/api/conversions/postback?${params}`,
{ headers: { 'X-API-Key': 'lw_your_api_key_here' } }
);
import requests
response = requests.get(
'https://api.linquid.io/api/conversions/postback',
params={
'lw_cid': 'abc123xyz789',
'amount': 99.99,
'currency': 'USD',
'event': 'purchase',
'orderId': 'ORD-12345',
},
headers={'X-API-Key': 'lw_your_api_key_here'}
)
{
"success": true,
"data": {
"conversionId": "conv_def456",
"clickId": "abc123xyz789",
"tracked": true
}
}
Query Parameters
string
required
The click ID from the original redirect
number
Conversion value/amount
string
default:"USD"
ISO currency code
string
default:"conversion"
Conversion event type
string
Your unique order/transaction ID
number
Cost/payout amount for ROI tracking
curl -X GET "https://api.linquid.io/api/conversions/postback?lw_cid=abc123xyz789&amount=99.99¤cy=USD&event=purchase&orderId=ORD-12345" \
-H "X-API-Key: lw_your_api_key_here"
const params = new URLSearchParams({
lw_cid: 'abc123xyz789',
amount: '99.99',
currency: 'USD',
event: 'purchase',
orderId: 'ORD-12345',
});
const response = await fetch(
`https://api.linquid.io/api/conversions/postback?${params}`,
{ headers: { 'X-API-Key': 'lw_your_api_key_here' } }
);
import requests
response = requests.get(
'https://api.linquid.io/api/conversions/postback',
params={
'lw_cid': 'abc123xyz789',
'amount': 99.99,
'currency': 'USD',
'event': 'purchase',
'orderId': 'ORD-12345',
},
headers={'X-API-Key': 'lw_your_api_key_here'}
)
{
"success": true,
"data": {
"conversionId": "conv_def456",
"clickId": "abc123xyz789",
"tracked": true
}
}
Integration Examples
Shopify Webhook
// Shopify order webhook handler
app.post('/webhooks/shopify/order', async (req, res) => {
const order = req.body;
// Extract click ID from order note attributes or URL params
const clickId = order.note_attributes?.find(
attr => attr.name === 'lw_cid'
)?.value;
if (clickId) {
await fetch(
`https://api.linquid.io/api/conversions/postback?` +
`lw_cid=${clickId}&amount=${order.total_price}¤cy=${order.currency}&orderId=${order.id}`,
{ headers: { 'X-API-Key': process.env.LINQUID_API_KEY } }
);
}
res.sendStatus(200);
});
WordPress/WooCommerce
// WooCommerce order completed hook
add_action('woocommerce_thankyou', function($order_id) {
$order = wc_get_order($order_id);
$click_id = WC()->session->get('lw_cid');
if ($click_id) {
$url = 'https://api.linquid.io/api/conversions/postback?' . http_build_query([
'lw_cid' => $click_id,
'amount' => $order->get_total(),
'currency' => $order->get_currency(),
'orderId' => $order_id,
]);
wp_remote_get($url, [
'headers' => ['X-API-Key' => LINQUID_API_KEY]
]);
}
});
Best Practices
Store the click ID early - Capture
lw_cid from the landing page URL and store it in session/cookie immediately. Pass it through your checkout flow.Idempotency - Include a unique
orderId to prevent duplicate conversions if the postback is retried.Was this page helpful?