개요

엑솔라 트랜잭션에 발생한 이벤트에 대한 알림을 받으려면 Webhook을 사용하십시오. Webhook을 사용하면 상태 및 기타 트랜잭션 관련 정보 제공과 같은 백오피스 및 관리 기능을 자동화할 수 있습니다.

인게임 재화, 아이템, 게임, 실물 상품 등의 구매를 포함한 지불 시 웹훅을 사용합니다.

많은 경우에 Webhook을 작동시키는 것은 개발자 웹 사이트에서의 게임유저 작업입니다. 하지만 그외 작업도 Webhook을 작동시킬 수 있습니다. 예를 들어, 개발자 사이트의 백오피스 프로세스가 환불을 위해 엑솔라 API를 호출하거나, 결제 시스템이 엑솔라에게 부정 결제를 알릴 수 있습니다.

Webhook은 개발자가 직접 작성한 프로그램인 수신기(핸들러)를 통해 수신하여 처리합니다. 이 프로그램은 Webhook을 대기했다가, 적절히 응답하여 관리자 프로세스로 전달합니다.

예를 들어, 웹훅 수신 후 다음 작업을 할 수 있습니다:

  • 사용자 잔고 충전
  • 사용자를 위하여 신규 아이템 해제
  • 사용자에게 실질 상품 배달

다음 IP 주소의 Webhook을 수락해야 합니다: 185.30.20.0/24, 185.30.21.0/24, 185.30.23.0/24.

Notice: 데이터베이스에 동일한 ID의 트랜잭션이 중복 되어서는 안됩니다. 시스템이 데이터베이스에 이미 존재하는 ID로 Webhook을 다시 보내면 이전 요청 처리 결과를 리턴합니다. 게임유저에게 구매 정보를 다시 제공하거나 데이터베이스에 중복된 값을 생성하지 마십시오.

Webhook 서비스는 알림을 받을 서버에서 모든 Webhook을 수신할 것이라고 가정하지 않습니다. 인터넷 안정성은 100%가 아니기에 웹훅이 소실되거나 지연될 수 있습니다. 또한, 수신 장치에서 귀하의 서버의 일시적인 오류에 대해 5xx HTTP 코드를 반환할 수도 있습니다. 예를 들어 사용자가 구매한 가상 상품을 성공적으로 사용자 인벤토리에 추가하지 못한 경우 수신 장치는 500 HTTP 응답 코드를 반환합니다.

메시지 누락의 위험을 줄이기 위해 엑솔라 알림 서비스는 재시도 메커니즘을 사용합니다. 해당 서비스가 목적지에 도착하지 않는 메시지를 다시 전송하는 빈도:

  • 5분 간격으로 2번
  • 15분 간격으로 7번
  • 60분 간격으로 10번
반복된 웹훅이 그 전의 웹훅이 전송된 후 12시간 내로 전송될 수 있습니다. 최대 재시도 횟수는 20번입니다.

Note: 연결 문제로 인해 웹훅 소실, 지연, 중복 현상이 나타나더라도 보통 수신측의 자체 논리 오류로 인해 이러한 문제가 발생하는 경우가 많습니다.
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
이 페이지 평가
이 페이지 평가
개선해야 할 점이 있을까요?

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!
마지막 업데이트: 2021년 8월 4일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누릅니다.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!