λ³Έλ¬Έ λ°”λ‘œκ°€κΈ°
μΉ΄ν…Œκ³ λ¦¬ μ—†μŒ

λ„€μ΄λ²„νŽ˜μ΄ 포인트 지급 API 생성 및 ν™œμš© κ°€μ΄λ“œ

by pa2 2024. 12. 22.

λ„€μ΄λ²„νŽ˜μ΄ 포인트λ₯Ό μ‚¬μš©ν•˜μ—¬ μ‚¬μš©μž 행동을 μœ λ„ν•˜κ±°λ‚˜ μƒν’ˆ νŽ˜μ΄μ§€ μœ μž…μ„ 늘리고 μ‹ΆμœΌμ‹ κ°€μš”? λ„€μ΄λ²„μ˜ APIλ₯Ό ν™œμš©ν•˜λ©΄ 포인트 지급을 μžλ™ν™”ν•˜κ³  λ§ˆμΌ€νŒ… ν™œλ™μ„ 효과적으둜 μš΄μ˜ν•  수 μžˆμŠ΅λ‹ˆλ‹€. 이번 ν¬μŠ€νŒ…μ—μ„œλŠ” λ„€μ΄λ²„νŽ˜μ΄ 포인트 지급 API 생성 방법과 μ‹€μ œ 적용 방법을 λ‹¨κ³„λ³„λ‘œ μ•ˆλ‚΄λ“œλ¦½λ‹ˆλ‹€.


1. λ„€μ΄λ²„νŽ˜μ΄ API μ‹œμž‘ν•˜κΈ°

λ„€μ΄λ²„νŽ˜μ΄ APIλ₯Ό ν™œμš©ν•˜λ €λ©΄ λ¨Όμ € 넀이버 κ°œλ°œμžμ„Όν„°μ—μ„œ APIλ₯Ό ν™œμ„±ν™”ν•΄μ•Ό ν•©λ‹ˆλ‹€.

1) 넀이버 κ°œλ°œμžμ„Όν„° κ°€μž… 및 둜그인

  • 넀이버 κ°œλ°œμžμ„Όν„° 접속: developer.pay.naver.com
  • 넀이버 κ³„μ •μœΌλ‘œ λ‘œκ·ΈμΈν•˜κ±°λ‚˜ μƒˆλ‘œ κ°€μž…ν•˜μ„Έμš”.
  • κ°€μž… ν›„ κ°œλ°œμžμ„Όν„°μ˜ λŒ€μ‹œλ³΄λ“œμ— μ ‘κ·Όν•  수 μžˆμŠ΅λ‹ˆλ‹€.

2) μ• ν”Œλ¦¬μΌ€μ΄μ…˜ 등둝

  • μƒˆ μ• ν”Œλ¦¬μΌ€μ΄μ…˜ 등둝:
    1. κ°œλ°œμžμ„Όν„°μ—μ„œ μ• ν”Œλ¦¬μΌ€μ΄μ…˜ 등둝 λ²„νŠΌμ„ ν΄λ¦­ν•©λ‹ˆλ‹€.
    2. μ• ν”Œλ¦¬μΌ€μ΄μ…˜ 이름을 μž…λ ₯ν•©λ‹ˆλ‹€.
    3. API μ‚¬μš© κΆŒν•œμ—μ„œ λ„€μ΄λ²„νŽ˜μ΄λ₯Ό μ„ νƒν•©λ‹ˆλ‹€.
    4. 등둝 ν›„ ν΄λΌμ΄μ–ΈνŠΈ ID와 ν΄λΌμ΄μ–ΈνŠΈ μ‹œν¬λ¦Ώ ν‚€λ₯Ό λ°œκΈ‰λ°›μŠ΅λ‹ˆλ‹€.

2. λ„€μ΄λ²„νŽ˜μ΄ 포인트 지급 API 연동

1) API 연동을 μœ„ν•œ 사전 μ€€λΉ„

API 연동을 μœ„ν•΄ λ‹€μŒ 정보가 ν•„μš”ν•©λ‹ˆλ‹€:

  • ν΄λΌμ΄μ–ΈνŠΈ ID와 μ‹œν¬λ¦Ώ ν‚€: μ• ν”Œλ¦¬μΌ€μ΄μ…˜ 등둝 μ‹œ λ°œκΈ‰λ°›μ€ κ°’.
  • λ„€μ΄λ²„νŽ˜μ΄ 체인 ID: λ„€μ΄λ²„νŽ˜μ΄ 상점 ID.
  • μ„œλ²„ ν™˜κ²½: API ν˜ΈμΆœμ„ μ²˜λ¦¬ν•  μ„œλ²„ ν™˜κ²½(예: AWS, Naver Cloud λ“±).

2) API μ—”λ“œν¬μΈνŠΈ

λ„€μ΄λ²„νŽ˜μ΄ 포인트 지급 API의 μ—”λ“œν¬μΈνŠΈλŠ” λ‹€μŒκ³Ό κ°™μŠ΅λ‹ˆλ‹€:

3) API μš”μ²­ ꡬ쑰

API ν˜ΈμΆœμ€ POST μš”μ²­μœΌλ‘œ 이루어지며, μš”μ²­ 본문은 JSON ν˜•μ‹μœΌλ‘œ κ΅¬μ„±λ©λ‹ˆλ‹€.

μš”μ²­ μ˜ˆμ‹œ:

json
μ½”λ“œ 볡사
{ "campaignId": "your_campaign_id", "userId": "user12345", "point": 100, "description": "μƒν’ˆ νŽ˜μ΄μ§€ μœ μž… 보상" }

헀더 μ˜ˆμ‹œ:

plaintext
μ½”λ“œ 볡사
Content-Type: application/json Authorization: Bearer {access_token}

ν•„μˆ˜ νŒŒλΌλ―Έν„°:

  • campaignId: 지급 λŒ€μƒ 캠페인 ID.
  • userId: 포인트λ₯Ό 지급받을 μ‚¬μš©μž ID.
  • point: 지급 포인트 κΈˆμ•‘.
  • description: 지급 μ‚¬μœ .

3. λ„€μ΄λ²„νŽ˜μ΄ 포인트 지급 API ν™œμš©

1) μ‹€μ œ 포인트 지급 흐름

  1. μ‚¬μš©μž 행동 μœ λ„: 예λ₯Ό λ“€μ–΄, νŠΉμ • μƒν’ˆ νŽ˜μ΄μ§€μ— λ°©λ¬Έν•˜κ±°λ‚˜ κ΅¬λ§€ν•˜λŠ” μ‚¬μš©μžμ—κ²Œ 포인트λ₯Ό μ§€κΈ‰ν•˜λ„λ‘ μ„€μ •.
  2. API 호좜: μ‚¬μš©μžμ˜ 행동이 μ™„λ£Œλ˜λ©΄ μ„œλ²„μ—μ„œ APIλ₯Ό ν˜ΈμΆœν•˜μ—¬ 포인트λ₯Ό 지급.
  3. 지급 μ™„λ£Œ 확인: API μ‘λ‹΅μ—μ„œ 성곡 μ—¬λΆ€λ₯Ό ν™•μΈν•˜κ³ , 성곡 μ‹œ μ‚¬μš©μžμ—κ²Œ 포인트 지급 μ™„λ£Œ μ•Œλ¦Ό.

2) 보상 캠페인 아이디어

  • μƒν’ˆ νŽ˜μ΄μ§€ μœ μž… μœ λ„: μƒν’ˆ νŽ˜μ΄μ§€ λ°©λ¬Έ μ‹œ μ†Œμ•‘ 포인트 지급.
  • 리뷰 μž‘μ„± μœ λ„: ꡬ맀 ν›„ 리뷰λ₯Ό μž‘μ„±ν•˜λ©΄ 포인트 지급.
  • μ°Έμ—¬ 이벀트: νŠΉμ • 이벀트 μ°Έμ—¬ μ‹œ 포인트 보상.

4. λ„€μ΄λ²„νŽ˜μ΄ API 연동 μ‹œ μ£Όμ˜μ‚¬ν•­

  • 인증 토큰 관리: ν΄λΌμ΄μ–ΈνŠΈ ID와 μ‹œν¬λ¦Ώ ν‚€λŠ” μ ˆλŒ€ 외뢀에 λ…ΈμΆœλ˜μ§€ μ•Šλ„λ‘ λ³΄κ΄€ν•˜μ„Έμš”.
  • HTTPS μ‚¬μš©: λͺ¨λ“  API μš”μ²­μ€ λ³΄μ•ˆ ν”„λ‘œν† μ½œ(HTTPS)을 톡해 이루어져야 ν•©λ‹ˆλ‹€.
  • 포인트 지급 ν•œλ„ 확인: μΊ νŽ˜μΈλ‹Ή 지급 κ°€λŠ₯ν•œ 포인트 ν•œλ„λ₯Ό μ΄ˆκ³Όν•˜μ§€ μ•Šλ„λ‘ μ„€μ •ν•˜μ„Έμš”.

5. FAQ

Q: λ„€μ΄λ²„νŽ˜μ΄ 포인트 지급 API μ‚¬μš©μ΄ 처음인데, μ–΄λ””μ„œλΆ€ν„° μ‹œμž‘ν•΄μ•Ό ν•˜λ‚˜μš”?
A: 넀이버 κ°œλ°œμžμ„Όν„°μ—μ„œ μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ„ λ“±λ‘ν•˜κ³ , ν΄λΌμ΄μ–ΈνŠΈ ID와 μ‹œν¬λ¦Ώ ν‚€λ₯Ό λ°œκΈ‰λ°›λŠ” 것뢀터 μ‹œμž‘ν•˜μ„Έμš”.

Q: 포인트 지급이 μ‹€νŒ¨ν•˜λŠ” κ²½μš°λŠ” μ–΄λ–»κ²Œ μ²˜λ¦¬ν•˜λ‚˜μš”?
A: API μ‘λ‹΅μ—μ„œ μ‹€νŒ¨ μ‚¬μœ λ₯Ό ν™•μΈν•˜κ³ , μ‚¬μš©μžκ°€ 캠페인 쑰건을 μΆ©μ‘±ν–ˆλŠ”μ§€ μ κ²€ν•˜μ„Έμš”.

Q: ν…ŒμŠ€νŠΈ ν™˜κ²½μ—μ„œ APIλ₯Ό μ‚¬μš©ν•  수 μžˆλ‚˜μš”?
A: 넀이버 κ°œλ°œμžμ„Όν„°μ—μ„œ μ œκ³΅ν•˜λŠ” ν…ŒμŠ€νŠΈ ν™˜κ²½μ„ 톡해 APIλ₯Ό μ•ˆμ „ν•˜κ²Œ ν…ŒμŠ€νŠΈν•  수 μžˆμŠ΅λ‹ˆλ‹€.


κ²°λ‘ 

λ„€μ΄λ²„νŽ˜μ΄ 포인트 지급 APIλ₯Ό ν™œμš©ν•˜λ©΄ μ‚¬μš©μžμ˜ 행동을 μœ λ„ν•˜κ³  λ§ˆμΌ€νŒ… μΊ νŽ˜μΈμ„ 효과적으둜 μš΄μ˜ν•  수 μžˆμŠ΅λ‹ˆλ‹€. μœ„μ˜ κ°€μ΄λ“œλ₯Ό μ°Έκ³ ν•˜μ—¬ 포인트 지급 μ‹œμŠ€ν…œμ„ κ΅¬ν˜„ν•˜κ³ , μ‚¬μš©μž μ°Έμ—¬λ₯Ό μœ λ„ν•˜λŠ” 성곡적인 μΊ νŽ˜μΈμ„ 진행해 λ³΄μ„Έμš”.

λŒ“κΈ€