Connect Lovable

Integrate Partnero affiliate and referral tracking into this app.

Partnero is an affiliate and referral management platform.
- API base URL: https://api.partnero.com/v1/
- Authentication: Bearer token in the Authorization header
- The API key is already stored as the Cloud secret PARTNERO_API_KEY
- OpenAPI spec: https://docs.partnero.com/api-reference/openapi.json
- Program ID: YOUR_PROGRAM_ID

What needs to happen:

1. FRONTEND — add this snippet to the <head> of index.html so it loads on
every page:

<script>
    (function(p,t,n,e,r,o){ p['__partnerObject']=r;function f(){
    var c={ a:arguments,q:[]};var r=this.push(c);return "number"!=typeof r?r:f.bind(c.q);}
    f.q=f.q||[];p[r]=p[r]||f.bind(f.q);p[r].q=p[r].q||f.q;o=t.createElement(n);
    var _=t.getElementsByTagName(n)[0];o.async=1;o.src=e+'?v'+(~~(new Date().getTime()/1e6));
    _.parentNode.insertBefore(o,_);})(window, document, 'script', 'https://app.partnero.com/js/universal.js', 'po');
    po('settings', 'assets_host', 'https://assets.partnero.com');
    po('program', 'YOUR_PROGRAM_ID', 'load');
</script>

This reads the partner key from referral URLs such as ?ref=PARTNER_KEY and
stores it in a first-party cookie called "partnero_partner".

2. BACKEND — create an Edge Function that runs when someone signs up. Read
the "partnero_partner" cookie from the request and call:

POST https://api.partnero.com/v1/customers
Headers: Authorization: Bearer PARTNERO_API_KEY, Content-Type: application/json
Body:
{
  "partner": { "key": "VALUE_FROM_COOKIE" },
  "key": "unique_customer_id",
  "email": "[email protected]",
  "name": "Customer Name"
}

3. BACKEND — create an Edge Function that runs after a successful payment:

POST https://api.partnero.com/v1/transactions
Headers: Authorization: Bearer PARTNERO_API_KEY, Content-Type: application/json
Body:
{
  "customer": { "key": "unique_customer_id" },
  "key": "unique_transaction_id",
  "amount": 99.99,
  "action": "sale"
}

Important rules:
- Create a customer only when the "partnero_partner" cookie is present. In
  an affiliate program the API rejects a customer with no partner attached.
- Send transactions for every purchase. Ones for customers that were never
  referred are rejected, which is expected and harmless.
- Make the calls non-blocking. If Partnero is unreachable, the sign-up or
  payment must still succeed. Wrap them in try/catch and log failures.
- Use the same customer "key" in both calls. That is how Partnero links a
  purchase back to the partner who referred the customer.
- Use your order or invoice ID as the transaction "key" so refunds can be
  matched later.