쇼핑몰 주문을 링크팜에 연결하기

이 프로젝트에 링크팜 전환 추적을 붙여줘.

문서: https://openapi.linkfarm.ai/llms-full.txt
OpenAPI: https://openapi.linkfarm.ai/openapi.json

요구사항:
- 랜딩 URL 쿼리의 lf_click 을 서버에서 HttpOnly 쿠키로 저장(쿠키 수명 13개월.
  단, 귀속 인정은 제품별 어트리뷰션 윈도우(기본 30일)로 서버가 별도 판정)
- 결제 성공 후 서버에서 order.paid 전송
- occurred_at 을 보낼 땐 UTC 오프셋 필수(예: +09:00) — 오프셋 없으면 422
- 환불 완료 후 refund.created 전송 (refund_id 포함)
- 시크릿 키는 LINKFARM_SECRET_KEY 환경변수에서만 읽기
- 429/5xx 만 재시도, 4xx 는 재시도 금지
- 먼저 GET /v1/ping 으로 연결을 확인하고, 테스트 주문까지 넣어서 검증해줘

// 랜딩 진입점(공통 미들웨어)에서 한 번만.
app.use((req, res, next) => {
  const click = req.query.lf_click;
  if (typeof click === 'string' && click) {
    res.cookie('lf_click', click, {
      httpOnly: true, secure: true, sameSite: 'lax',
      maxAge: 400 * 24 * 60 * 60 * 1000,   // 13개월(쿠키 수명 — 귀속 인정은 별도)
      domain: '.example.com',              // 서브도메인에서도 읽히게
    });
  }
  next();
});

<?php
// 공통 헤더에서 한 번만.
if (!empty($_GET['lf_click'])) {
    setcookie('lf_click', $_GET['lf_click'], [
        'expires'  => time() + 400 * 24 * 60 * 60,  // 13개월(쿠키 수명 — 귀속 인정은 별도)
        'path'     => '/',
        'domain'   => '.example.com',
        'secure'   => true,
        'httponly' => true,
        'samesite' => 'Lax',
    ]);
}

// 매일 밤 한 번. 이미 반영된 주문은 그대로 두고 빠진 것만 채워집니다.
const orders = await db.ordersCreatedOn(yesterday);

await fetch('https://openapi.linkfarm.ai/v1/events/batch', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${process.env.LINKFARM_SECRET_KEY}`,
  },
  body: JSON.stringify({
    events: orders.map((o) => ({
      type: 'order.paid',
      occurred_at: o.paidAt.toISOString(),
      data: {
        order_id: o.id,
        amount: o.commissionableAmount,
        click_ref: o.lfClick,
        coupon_code: o.couponCode,
      },
    })),
  }),
});