설명
유저의 리워드 지급/차감이 필요할 때, 버즈부스터 서버에서 파트너사로 포인트 지급/차감을 요청합니다. BuzzBooster 서버는 Request Body에 유저 정보와 지급/차감할 포인트 정보를 포함하여 전송합니다. 파트너사는 해당 요청을 처리한 후 처리 결과에 따라 Response를 반환하세요.
[POST] /points
BuzzBooster Request
Request Parameter
종류 | 파라미터명 | 타입 | 값 |
Header | Content-Type | string | application/json |
Request Body
파라미터명 | 타입 | 설명 |
transaction_id | string | 포인트 지급/차감에 발급되는 ID입니다. 포인트 중복 지급/차감을 방지하기 위해 사용합니다.
같은 transaction_id로 요청이 온 경우에는 반드시 포인트 중복 적립/차감이 되지 않도록 처리해야 합니다. |
user_id | string | 파트너사에서 정의한 유저의 식별값입니다. |
points | array | 적립/차감 해야되는 포인트 금액 배열 입니다. 여러 리워드가 동시발생하여 지급/차감될 수 있습니다. |
custom | object | 적립 요청에는 유저가 참여한 캠페인 ID와 이름, 차감 요청에는 차감 사유가 포함됩니다. |
{
"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": "네이버페이 포인트 전환"
}
},
],
}
JSON
복사
Retry Policy
적립/차감에 실패 시 응답 코드가 500번대(501 Not Implemented 제외) 또는 429 Too Many Requests라면, 200 OK, 201 Created 혹은 409 Conflict 를 응답받을 때까지 BuzzBooster 서버에서 동일한 request body로 최대 4회 재시도합니다.
Partner Response
200, 201 - 포인트 적립/차감이 성공한 경우
4xx - 올바르지 않은 요청으로 인하여 포인트 적립/차감이 실패한 경우
409 - 이미 정상 처리된 트랜잭션이 중복 요청된 경우
5xx - 예상치 못한 문제로 인하여 포인트 적립/차감이 실패한 경우