게임 프로모션 에러코드

개발
1

게임 프로모션 기능이 새로 나와 구현중인데요.

에러 리턴이 이전 프로모션과 같은데 상황별로 유저안내를 잘 띄우기 위해 에러코드별 어떤 상황인지 문의드려봅니다.

현재 오해가 없는 코드를 제외하고 헛갈리는 부분이 아래와 같습니다.

  1. 4109 : 중지는 일시중지 등이고 종료/미검토 정보찾을 수 없을때는 확인했는데 실행중이 아니라는건 어떤 상태인지 확인이 어렵습니다. 위와 같은 형태로 프로모션이 종료/중지되었다고 안내하면 될까요?
  2. 4110 : 리워드를 지급할 수 없을때는 토스지급api쪽 에러로 이해했습니다. 나중에 재시도를 안내하면 되는 에러인지 궁금합니다. 추가로 회수api는 구현이 안되어있는데 에러엔 포함되어있는 부분이죠?
  3. 4113: 이미 지급된 내역이라는 것은 중복 지급쪽 반환값으로 이해했습니다.
    1. 중복제한은 일/회 제한 등 개발사에서 로직을 구현하는걸로 확인했는데 그것과 별개로 토스쪽에서 중복으로 판단하는 기준이 있는지 궁금합니다.
    2. 이전 프로모션때는 지급시마다 지급키가 생성되어 이것 기준으로 중복체크를 했던걸로 보이는데 그것의 영향일까요?

답변 감사드립니다.

2

@IAN_R 님 안녕하세요

프로모션의 실행 상태를 확인하기 위해 API 생성 요청을 주셔서 현재 개발을 진행하고 있습니다. 언제 필요하신걸까요?

4110 에러는 토스 내부적으로 유저에게 프로모션 지급이 어려울 경우 에러코드입니다. 넵 유저에게 안내 후 다시 함수를 호출하시어 포인트 지급 부탁드립니다.

4113 에러는 확인 후 답변드리겠습니다.

3

@IAN_R 님 에러코드 관련해서 개발자 문서를 보완해두었습니다.

추가로 필요하신 내용이 있다면 말씀 부탁드려요.

4

@seonjeong

안녕하세요 선정님

문서확인했습니다. 4113 삭제 확인했고 다른 것들은 상세 내용 확인하여 대응했습니다.

게임프로모션에 에러 4111이 추가된걸 봤습니다.

지급내역 조회는 grantPromotionRewardForGame에서 회신온 리워드 키를 이용하여 /api-partner/v1/apps-in-toss/promotion/execution-result에 POST로 했을 경우 리턴될 것 같은데 맞을까요? 이후 같은 함수 등을 이용해서 조회기능을 추가예정이신거라 해당 에러코드가 존재한다면 해당 에러코드도 대응분기해놓겠습니다.

가이드 업데이트 감사합니다!

5

grantPromotionRewardForGame 함수 호출 시 지급 성공이라면 success 응답을 내려드리고 있습니다.

한번 더 확인하시려면 API 호출을 해주시면 되는데 일부 서버가 없는 제휴사도 계셔서 지급 조회 SDK 함수를 제공해야할 것으로 사료됩니다. 내부 얘기해보고 말씀드릴게요.

6

@seonjeong

답변 감사합니다.

저희는 grantPromotionRewardForGame 응답 값으로 지급 성공여부를 파악하고 처리하려 하고 있어서 추가적으로 서버 api 호출을 하진 않을 것 같습니다.

지급이 성공해서 리워드 키가 응답으로 온다면 4111은 grantPromotionRewardForGame에서는 볼일이 없는 에러코드인 것 같아 질문드렸던 부분입니다.