PSN 유저 토큰 폐기

기본 정보

1. 빌링 시스템에 보관 중인 PSN 유저 토큰을 폐기하는 API입니다.
2. 게임 종료 또는 테스트 중 토큰 초기화 시 사용합니다.

호출 시점

• PSN 공식개발 문서에서 권고하는 호출 시점은 게임 종료 시점입니다
• 종료시점을 항상 알 수 없는 케이스도 존재하나 이 경우 다음 케이스로 인해서 토큰 라이프사이클이 정상 유지됩니다
  • 새로운 게임 시작시 토큰 발급(기존 토큰 폐기됨)
  • 기존 토큰 최대 12시간 후 제거

항목	내용	비고
호출주체	게임서버(s2s API)
도메인	각 환경별 도메인
인증 방식	HTTP 헤더 인증 정보	다른 게임서버 API와 동일
HTTP 메소드	POST
Content-Type	application/x-www-form-urlencoded
응답 HTTP 코드	성공·비즈니스 실패 모두 200 / 빌링 내부 오류(SYSTEM_ERROR) 500	resultCode로 판단

Request

HTTP Request end point

POST https://각 환경별 빌링시스템 도메인/billing/api-game/v1/psn/auth/revoke

HTTP Request Header

• 아래의 HTTP Header들을 API 요청에 포함시켜야합니다.

이름	값	비고
X-Req-Pjid	프로젝트ID	기술 PM 등에게 전달받은 프로젝트ID
X-Auth-Access-Key	인증용 키	기술 PM 등에게 전달받은 해당 게임용 인증 키

HTTP Request Parameter

• 아래 파라미터들을 Content-Type: application/x-www-form-urlencoded 으로 호출하면 됩니다.

key	type	required	설명
pjid	String	Y	프로젝트ID
playerId	String	Y	토큰을 폐기할 유저 ID

Response

• 별도 resultData 없이 resultCode로 성공 여부를 판단합니다.

Success sample

{ "resultCode": "SUCCESS", "resultMessage": "success" }

실패 응답

• 비즈니스 실패도 HTTP 200으로 응답됩니다. HTTP status가 아닌 resultCode로 분기하세요. SYSTEM_ERROR(500)·NOT_ALLOW_AUTH(인증 헤더 오류)는 전 API 공통.

resultCode	HTTP	발생 조건	게임서버 처리
INVALID_PARAMETER	200	필수값 누락, pjid에 PSN 설정 없음	요청값 수정 후 재요청
EXTERNAL_API_ERROR	200	PSN revoke API 오류·통신 실패. 빌링 보관 토큰은 삭제되지 않음(TTL 12시간으로 소멸)	재호출 시 다시 시도됨

{
  "resultCode": "INVALID_PARAMETER",
  "resultMessage": "playerId: must not be blank",
  "traceId": "billing_01H..."
}

요청 curl 샘플

• 샘플 curl 커맨드입니다. 요청 정보에 맞게 변경해서 호출하세요.

curl -X 'POST' \
  'https://API도메인/billing/api-game/v1/psn/auth/revoke' \
  -H 'X-Req-Pjid: PJID값' \
  -H 'X-Auth-Access-Key: API 인증키' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'pjid=1201' \
  --data-urlencode 'playerId=tester01'