...
파라미터명 | 타입 | 설명 |
transaction_id | string | 포인트 지급/차감에 발급되는 ID입니다. 포인트 중복 지급/차감을 방지하기 위해 사용합니다. 같은 transaction_id로 요청이 온 경우에는 반드시 포인트 중복 적립/차감이 되지 않도록 처리해야 합니다. |
user_id | string | 파트너사에서 정의한 유저의 식별값입니다. |
points | array | 적립/차감 해야되는 포인트 금액 배열 입니다. 여러 리워드가 동시발생하여 지급/차감될 수 있습니다. |
custom | object | 적립 요청에는 유저가 참여한 캠페인 ID와 이름, 차감 요청에는 차감 사유가 포함됩니다. |
JSON복사
Code Block |
---|
{ "transaction_id": "2195ffb0-8f64-44b2-8c85-4723b9ecb18a", "user_id": "USER_123456789", "points": [ { "point": 10, "custom": { "campaign_id": "1234-567890-abcd-efgh" "campaign_name": "대시보드에서 설정한 캠페인 이름" } }, { "point": -1500, "custom": { "reason": "네이버페이 포인트 전환" } }, ], } |
...
파라미터명 | 타입 | 설명 |
transaction_id | string | 포인트 지급/차감에 발급되는 ID입니다. 포인트 중복 지급/차감을 방지하기 위해 사용합니다. 같은 transaction_id로 요청이 온 경우에는 반드시 포인트 중복 적립/차감이 되지 않도록 처리해야 합니다. |
user_id | string | 파트너사에서 정의한 유저의 식별값입니다. |
coupon | object | 지급해야하는 쿠폰 객체입니다. |
coupon.code | string | 지급해야하는 쿠폰 코드로 쿠폰의 식별자입니다. 최대 250자까지 지원합니다.(ascii) |
amount | integer | 지급해야하는 쿠폰의 수량입니다. |
JSON복사
Code Block |
---|
{ "transaction_id": "2195ffb0-8f64-44b2-8c85-4723b9ecb18a", "user_id": "USER_123456789", "coupon": { "code": "ABC123", }, "amount": 2 } |
...