Server to Server 설정

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

아이템 지급, 로그인 검증을 위해 서버에서 서버로 요청을 발송하도록 설정하는 방법을 설명합니다.

결제 아이템 지급 요청

웹훅을 통해 HTTP 요청을 발송하여 결제 또는 쿠폰 사용에 따른 아이템 지급을 진행하도록 설정할 수 있습니다.

아이템 지급을 위해 웹훅으로 HTTP 요청을 발송하도록 설정하는 방법은 아래와 같습니다.

  1. 관리자 계정으로 대시보드에 로그인해 주십시오.
  2. 프로젝트 설정 > 일반 메뉴를 차례대로 클릭해 주십시오.
  3. 웹훅 영역의 아이템 구매 (운영) 또는 쿠폰 아이템 (운영) 입력란에 아래 가이드를 참조하여 HTTP/ HTTPS URL 를 입력해 주십시오.
    • 결제 후 아이템 지급은 결제 후 요청 및 응답을 참조해 주십시오.
    • 쿠폰 사용 후 아이템 지급은 쿠폰 사용 후 요청 및 응답을 참조해 주십시오.
    • 테스트 사용자에게 아이템을 지급하는 경우 (테스트 사용자) 표시가 있는 입력란에 요청을 입력해 주십시오.
  4. [저장] 버튼을 클릭해 주십시오.

결제 후 요청 및 응답

아래 표 및 코드를 참조하여 HTTP 요청 및 응답을 설정해 주십시오.

  • 요청

    https://{domain}?
userId={userId}&orderId={orderId}&projectId={projectId}&platform={platform}&productId={productId}&store={store}&payment={payment}&transactionId={transactionId}&gamepotOrderId={gamepotOrderId}&uniqueId={uniqueId}&tp={tp}&server_id={server_id}&player_id={player_id}&status={status}&remoteip={remoteip}&userdata={userdata}
    속성 타입 최대 길이 설명
    userId String 128 사용자 ID
    transactionId String 512 주문번호(GPA-xxxx-xxxx-)
    store String 64 스토어 정보(apple, google, one)
    projectId String 128 프로젝트ID
    productId String 256 구글/애플/원스토어에 등록된 상품 ID
    platform String 128 운영 Platform 정보 (android, ios)
    payment String 64 결제 방식
    uniqueId String 512 GAMEPOT에서 관리하는 Order ID
    gamepotOrderId String 512 GAMEPOT에서 관리하는 Order ID
    orderId String 512 GAMEPOT에서 관리하는 Order ID
    serverId String - serverId (setServerId api 호출 시 입력한 serverId)
    playerId String - playerId (setPlayerId api 호출 시 입력한 playerId)
    tp Integer -
    • 1: 테스트 결제
    • 0: 일반 결제
    remoteip String - IP 주소
    userdata String - 사용자 데이터 (JSON 형식) - {"player_id" : String, "server_id" : String, "metadata" : String, "options" : String}
    • player_id: 플레이어 ID 값 (setPlayerId api 호출 시 입력한 playerId)
    • server_id: 서버 ID 값 (setServerId api 호출 시 입력한 serverId)
    • metadata: metadata (purchase 시 입력한 메타데이터 값)
    • options: options (purchase 시 입력한 추가 옵션 값)

  • 응답

    {
    "status": 1,
    "message" : ""
}
    속성 타입 설명
    status Integer 결괏값
    • 0: 실패, 1: 성공
    message String 오류 내용

선물하기 및 쿠폰 사용 후 요청 및 응답

아래 표 및 코드를 참조하여 HTTP 요청 및 응답을 설정해 주십시오.

  • 요청

    https://{domain}?
userId={userId}&projectId={projectId}&platform={platform}&store={store}&userData={userData}&itemId=[{itemData}, {itemData}, ...]&title={title}&content={content}&serverId={serverId}&playerId={playerId}
    속성 타입 최대 길이 설명
    userId String 128 사용자 ID (대시보드에서 게임 > 선물하기 > 대상 값이 전체인 경우 all )
    projectId String 128 프로젝트 ID
    platform String 128 운영 Platform 정보 (android, ios)
    store String 64 스토어 정보(apple, google, one)
    title String - 대시보드 > 게임 > 선물 > 제목에 입력한 값
    content String - 대시보드 > 게임 > 선물 > 설명에 입력한 값
    target String - 게임팟 대시보드 > 게임 > 선물 > 대상 값 - 전체 : all / 사용자ID : user
    userData String - 클라이언트 SDK 쿠폰 API 호출 시 두 번째 파라미터에 입력한 값 또는 대시보드 > 게임 > 선물 > UserData에 입력한 값
    serverId String - 서버 ID 값 (setServerId api 호출 시 입력한 serverId)
    playerId String - 플레이어 ID 값 (setPlayerId api 호출 시 입력한 playerId)
    itemId Array - itemData Array - itemData(JSON) {"item_id" : String, "store_item_id" : String, "count" : Number}
    • item_id: 대시보드 게임 > 아이템에서 생성한 아이템 항목의 고유 ID
    • store_item_id: 지급할 아이템 ID
    • count: 지급할 아이템 수

  • 응답

    {
    "status": 1,
    "message" : ""
}
    속성 타입 설명
    status Integer 결괏값
    • 0: 실패, 1: 성공
    message String 오류 내용