> For the complete documentation index, see [llms.txt](https://adpopcornssp.gitbook.io/ssp-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adpopcornssp.gitbook.io/ssp-sdk/undefined-2/popcontents/reward-callback.md).

# 리워드 콜백

{% hint style="warning" %}
팝콘텐츠 참여 완료시 리워드 콜백을 받을 서버의 URL과 메소드를 애드팝콘 SSP 사업실에 전달해주세요.
{% endhint %}

{% hint style="info" %}
리워드 콜백을 보낼 애드팝콘 서버의 IP는 아래와 같습니다.

* 52.193.130.252
* 35.72.69.220
* 1.232.152.178
  {% endhint %}

## Method

* GET
* POST

## Content-Type

* application/x-www-form-urlencoded  \[POST]

## Callback Parameter

| 파라미터 명         | 설명                                                  | 데이터 타입 |
| -------------- | --------------------------------------------------- | ------ |
| servicecode    | <p>리워드 서비스 코드 <br>(<code>POPCONTENTS</code> 고정)</p> | string |
| usn            | 리워드를 지급받을 유저의 아이디                                   | string |
| adid           | 유저의 구글 광고 아이디                                       | string |
| idfa           | 유저의 IDFA                                            | string |
| reward\_key    | 완료마다 발급되는 유니크한 리워드 트랜잭션 식별값                         | string |
| quantity       | 리워드 수량                                              | long   |
| service\_id    | 출석체크, 운세보기 등등 서비스의 고유 아이디                           | string |
| campaign\_id   | 유저가 참여한 캠페인의 고유 아이디                                 | string |
| campaign\_name | 유저가 참여한 캠페인의 이름                                     | string |

## Callback Response Parameter (JSON)

애드팝콘 리워드 서버에서 전달하는 리워드 지급 정보를 수신하여 처리한 후, 처리 결과를 JSON 타입으로 아래 정의된 케이스에 맞춰 응답해야합니다.

| 파라미터 명                    | 설명           | 데이터 타입  |
| ------------------------- | ------------ | ------- |
| Result                    | 리워드 지급 성공 유무 | boolean |
| [ResultCode](#resultcode) | 응답 코드        | int     |
| ResultMsg                 | 응답 메시지       | string  |

### ResultCode

| 응답코드 | 설명        | 예시                                                                     |
| ---- | --------- | ---------------------------------------------------------------------- |
| 1    | 성공        | {"Result":true,"ResultCode":1,"ResultMsg":"success"}                   |
| 3100 | 리워드 중복 지급 | {"Result":false,"ResultCode":3100,"ResultMsg":"duplicate transaction"} |
| 3200 | 유저 검증 실패  | {"Result":false,"ResultCode":3200,"ResultMsg":"invalid user "}         |
| 4000 | 예외 발생     | {"Result":false,"ResultCode":4000,"ResultMsg":"custom error message"}  |