포인트 변경이 발생할 때마다 고객사 관리자(https://moneytree.bz/admin)에서 설정한 URL로 HTTP POST 요청을 보냅니다. body 필드 내에 포함되는 항목은 이벤트 종류에 따라 달라질 수 있습니다.
URI
고객사에서 등록한 사용자 포인트 적립/차감 웹훅 주소
1. 리워드 지급
Headers
Name | Description | Required |
Idempotency-Key | 멱등키 | O |
Body
Name | Type | Description | Required |
user | object | 리워드를 지급받은 고객사 사용자 정보 | O |
user.uniqueId | string | 사용자를 구분하기 위해 부여된 고유한 아이디 | O |
point | int | 사용자에게 지급된 리워드 포인트 | O |
campaignType | string | 사용자가 캠페인을 통해 리워드를 획득한 경우 캠페인 종류 | X |
remainingPoints | number | 고객사에서 설정한 캠페인 내 지급 가능 잔여 포인트 | X |
maxTotalPoints | number | 고객사에서 설정한 캠페인 내 지급 가능 총 포인트 | X |
2. 포인트 변경
Headers
Name | Description | Required |
Idempotency-Key | 멱등키 | O |
Body
Name | Type | Description | Required |
user | object | 리워드를 지급받은 고객사 사용자 정보 | O |
user.uniqueId | string | 사용자를 구분하기 위해 부여된 고유한 아이디 | O |
point | number | 포인트 변경된 후의 보유 포인트 | O |
reason | string | 주문이 완료되었거나 래플 이벤트에 참여하는 등, 특정 활동에 의해 포인트가 변경되는 이유 | X |