9LINK 주요문서
매체 API 연동문서
리워드 지급형 매체가 클릭, 유저 식별값, 리워드 거래번호를 9LINK로 전달하고, 전환 발생 후 콜백을 수신하기 위한 연동 문서입니다.
연동 준비값
| 항목 | 설명 | 전달 방식 |
|---|---|---|
| partner_code | 매체 코드 | 9LINK 총관리자가 생성 후 전달 |
| media_key | 매체키 | 9LINK 총관리자가 생성 후 전달 |
| callback_url | 전환/리워드 결과를 받을 매체 URL | 매체가 9LINK에 전달 |
클릭 URL
매체는 발급받은 추적 URL로 사용자를 이동시킵니다. 리워드 지급형 매체는 유저 식별값과 리워드 거래번호를 함께 전달해야 합니다.
https://api.9link.co.kr/t/{tracking_code}?media_user_id={user_id}&reward_tx_id={reward_tx_id}&sub1={optional}media_user_id
매체 내부 유저 식별값입니다. 중복 전환 판단과 리워드 지급 확인에 사용됩니다.
reward_tx_id
매체 리워드 거래번호입니다. 동일 리워드 중복 지급 방지에 사용됩니다.
매체 콜백 수신 예시
전환이 승인/거절/취소되면 9LINK가 매체 콜백 URL로 결과를 전송합니다.
POST {callback_url}
Content-Type: application/json
X-9LINK-Signature: {hmac_sha256}
{
"click_id": "clk_...",
"conversion_id": "conv_...",
"advertiser_conversion_id": "order_12345",
"partner_code": "media001",
"media_user_id": "user_1004",
"reward_tx_id": "reward_20260708_001",
"reward_status": "approved",
"reject_reason": null,
"payout_amount": 700,
"converted_at": "2026-07-08T12:00:00.000Z"
}보안 권장사항
- 매체키는 외부에 노출하지 말고 서버 환경변수로 보관합니다.
- 콜백 수신 시 HMAC 서명을 검증합니다.
- 동일 reward_tx_id는 한 번만 리워드 지급 처리합니다.
- 콜백 실패에 대비해 중복 수신을 허용하되 멱등 처리합니다.