주문 상태 추적 설정하기

실행 예시로 다음 테스트 웹 애플리케이션 사용:

사용자에게 아이템을 부여하려면 결제가 성공적으로 완료되었는지 확인해야 합니다.

생성된 주문의 상태를 추적하고 유효성을 검사하려면 애플리케이션의 서버 측에서 웹훅 처리를 구성해야 합니다.

인게임 스토어를 제대로 운영하려면 메인 웹훅 처리를 구현해야 합니다:

웹훅	알림 유형	설명
사용자 유효성 검사	`user_validation`	사용자가 게임에 등록되어 있는지 확인하기 위해 결제를 처리하는 여러 단계에서 전송됩니다.
결제	`payment`	주문이 결제되면 전송되며 결제 데이터 및 거래 세부 정보가 포함됩니다.
주문 결제 성공	`order_paid`	결제 웹훅이 성공적으로 처리되었을 때 전송되며 여기에는 구매한 아이템 및 거래 ID에 대한 정보를 포함되어 있습니다. 사용자에게 아이템을 추가할 때 웹훅 데이터를 사용할 수 있습니다.
환불	`refund`	주문이 취소되면 전송되며 취소된 결제 데이터 및 거래 세부 정보가 포함됩니다.
주문 취소	`order_canceled`	환불 웹훅이 성공적으로 처리되었을 때 전송되며, 구매 아이템에 대한 정보와 취소된 거래의 ID가 포함되어 있습니다. 웹훅의 데이터를 사용하여 구매한 아이템을 제거합니다.

웹훅의 전체 목록과 웹훅 작업에 대한 일반적인 정보는 웹훅 문서를 참조해 주세요.

웹훅 처리용으로 준비된 클래스 사용.

웹훅 전송 설정

엑솔라 측에서 웹훅 구성 방법:

웹훅을 수신하려면 https://example.com 형식으로 서버의 URL을 지정하십시오. 데이터 전송에는 HTTPS 프로토콜이 사용되며 HTTP 프로토콜은 지원되지 않습니다.

웹훅을 테스트하기 위해 webhook.site와 같은 전용 사이트나 ngrok과 같은 플랫폼을 선택할 수도 있습니다. 실제 프로젝트의 경우 구매 유효성 검사 논리를 추가해야 합니다.

웹훅 수신기는 지정된 URL 주소에서 들어오는 웹훅을 수신하고 서명을 생성한 후 엑솔라 웹훅 서버로 응답을 전송할 수 있는 프로그램 코드입니다.

웹훅을 수신할 때는 데이터 전송의 보안을 보장해야 합니다. 이를 위해서는 웹훅 데이터에서 서명을 생성하고 생성된 서명이 HTTP 요청 헤더에 전송된 서명과 일치하는지 확인해야 합니다.

서명 생성 방법:

웹훅 수신을 확인하려면 서버가 다음을 반환해야 합니다.

서버에 일시적인 문제가 발생한 경우 웹훅 핸들러가 5xx 코드를 반환할 수도 있습니다.

주문 결제 성공 및 주문 취소 웹훅에 대한 응답을 받지 못했거나 5xx 코드가 포함된 응답을 받은 경우, 다음 일정에 따라 웹훅이 다시 전송됩니다.

웹훅 전송은 처음 시도 후 12시간 이내에 최대 20번까지 시도할 수 있습니다.

결제 웹훅에 대한 응답이 수신되지 않았거나 5xx 코드가 포함된 응답이 수신된 경우 웹훅도 증가된 시간 간격으로 재전송됩니다. 12시간 동안 최대 12번 시도할 수 있습니다.

사용자 유효성 검사 웹훅에 대한 응답이 수신되지 않았거나 400 또는 5xx 코드가 포함된 응답이 수신된 경우 사용자 유효성 검사 웹훅이 재전송되지 않습니다.

이 경우 사용자에게 오류가 표시되며 결제와 주문 결제 성공 웹훅은 전송되지 않습니다.

전체 웹훅 목록 및 메커니즘과 상세한 처리 예제는 웹훅 문서에 설명되어 있습니다.

의견을 보내 주셔서 감사드립니다!

메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.

마지막 업데이트: 2024년 11월 26일

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