Admin: Mobile App (S2S Direct) Integration

What Is Mobile App (S2S Direct)?

Mobile App (S2S Direct) is for iOS/Android apps (or any integration where the visitor does not click a link in a browser). Conversions are reported using affiliate_id and campaign_id instead of click_token. Your app captures the referring affiliate when the user opens the app (e.g. via deep link), then when a sale or booking happens your server POSTs to the S2S endpoint with those IDs and order details. No click_token or cookies needed.

Where You Configure It

All integration methods are in the campaign form, under the Integration Setup tab. Use the AffiliatePro application admin.

How to Open the Form and Choose Mobile App

1. Log in to the AffiliatePro application admin.
2. In the top bar, open the Marketing dropdown → click Campaigns.
3. On the Campaigns page you will see four campaign type cards: Banner Campaign, Text Campaign, Link Campaign, Video Campaign. Click Create New on any card to create a campaign, or click the Edit button on an existing campaign to open it.
4. In the General Settings tab, fill in the Campaign Name and set the Tool Type (Sale Integration is typical for purchase-based mobile tracking). Add other settings as needed.
5. Click the Integration Setup tab (plug icon).
6. Under Choose Your Integration Method, click the Mobile App (S2S Direct) card.

Critical Dependency: Save First

The API key, S2S Endpoint URL, Direct Mode parameter table, example cURLs, and Register Click Endpoint are only shown after you save the campaign at least once. Until saved, the form shows: "Save this campaign first. Your API key and endpoint documentation will appear here after saving."

Click Save (stays on the form) — not Save & Close — so you can immediately copy the API key and endpoint URLs that appear.

How Direct Mode Works

1. The app captures the referring affiliate’s ID when a user opens it via a referral link (e.g. deep link).
2. When a sale or booking happens, the app’s server sends a POST request to the S2S endpoint with affiliate_id, campaign_id, and order details.
3. The system identifies the affiliate, calculates commission, and distributes it automatically — no click_token or cookies needed.

What the Form Shows After Saving

• API Key — copy it with the Copy button. Send with every request.
• S2S Endpoint URL — POST conversion data here. The exact URL is shown in the form; it follows the pattern .../integration/s2sConvert (same endpoint as S2S API, but with different parameters).
• Direct Mode Parameters table — api_key, affiliate_id, campaign_id, order_id, order_total, order_currency. The form shows the full documentation table and a JSON example cURL with your actual API key, campaign ID, and endpoint pre-filled.
• Register Click Endpoint — optional. Use this if your app wants to register a referral event before the conversion (e.g. when the user opens the app). The endpoint follows the pattern .../integration/s2sRegisterClick. The form shows the exact URL and an example POST body with api_key, campaign_id, affiliate_id, visitor_id.

Response Examples

• Success — {"status":"success","message":"S2S conversion recorded successfully"}
• Duplicate — {"status":"duplicate","message":"Order already recorded"}
• Error — e.g. {"status":"error","message":"Invalid API key"}

Quick Access from the Campaigns List

In the Campaigns table, Mobile App campaigns show a Mobile / S2S Direct badge in the Integration Status column. Click the phone icon button next to the badge to open the Mobile setup modal and view API key and endpoint details without entering the full form.