사용자에게 구매 권한 부여

엑솔라에서 웹훅으로 받은 거래 세부 정보 및 구매한 아이템에 대한 정보를 사용하여 애플리케이션에서 사용자에게 구매 권한을 부여하도록 구현합니다.

결합된 웹훅을 수신하는 새 옵션으로 전환하려면 고객 성공 관리자에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요.

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

• 결합된 웹훅을 수신하는 경우
• 별도로 제공된 웹훅을 수신하는 경우

웹훅 이름	설명
사용자 유효성 검사 > 사용자 유효성 검사(user_validation)	사용자가 게임에 등록되어 있는지 확인하기 위해 결제를 처리하는 여러 단계에서 전송됩니다.
게임 서비스 > 결합된 웹훅 > 주문 결제 성공(order_paid)	여기에는 결제 데이터, 트랜잭션 세부 사항 및 구매한 아이템에 대한 정보가 포함되어 있습니다. 웹훅의 데이터를 사용하여 사용자에게 구매한 아이템을 추가합니다.
게임 서비스 > 결합된 웹훅 > 주문 취소(order_canceled)	여기에는 취소된 결제 데이터, 트랜잭션 세부 사항 및 구매한 아이템에 대한 정보가 포함되어 있습니다. 웹훅의 데이터를 사용하여 구매한 아이템을 제거합니다.

다음 구조는 결합된 웹훅을 사용하여 아이템을 구매하고 반품하는 절차를 보여줍니다.

웹훅 이름	설명
사용자 유효성 검사 > 사용자 유효성 검사(user_validation)	사용자가 게임에 등록되어 있는지 확인하기 위해 결제를 처리하는 여러 단계에서 전송됩니다.
결제 > 결제(payment)	여기에는 결제 데이터와 트랜잭션 세부 사항이 포함되어 있습니다.
게임 서비스 > 별도로 제공된 웹훅 > 주문 결제 성공(order_paid)	여기에는 구매한 아이템 및 트랜잭션 세부 사항에 대한 정보가 포함되어 있습니다. 웹훅의 데이터를 사용하여 사용자에게 구매한 아이템을 추가합니다.
결제 > 환불(refund)	여기에는 결제 데이터와 트랜잭션 세부 사항이 포함되어 있습니다.
게임 서비스 > 별도로 제공된 웹훅 > 주문 취소(order_canceled)	구매 아이템에 대한 정보와 취소된 트랜잭션의 ID가 포함되어 있습니다. 웹훅의 데이터를 사용하여 구매한 아이템을 제거합니다.

다음 구조는 별도의 웹훅을 사용하여 아이템을 구매하고 반품하는 절차를 보여줍니다.

아이템 카탈로그 개인 설정을 애플리케이션 측에서 구현한 경우 파트너 측에서 카탈로그 개인 설정 처리를 설정합니다.

관리자 페이지에서 웹훅 설정하기

1. 관리자 페이지에서 프로젝트를 엽니다.
2. 사이드 메뉴에서 프로젝트 설정을 클릭하고 웹훅 탭으로 이동합니다.
3. 웹훅 서버 필드에서 https://example.com 형식으로 웹훅을 수신할 서버의 URL을 지정합니다. 웹훅 테스트용 도구에서 확인한 URL을 지정할 수도 있습니다.
4. 프로젝트 웹훅에 서명하는 비밀 키는 기본값으로 생성됩니다. 새 비밀 키를 생성하려면 새로 고침 아이콘을 클릭합니다.
5. 웹훅 사용을 클릭합니다.

관리자 페이지에서 웹훅 테스트하기

웹훅이 성공적으로 설정되면 웹훅 설정 블록 아래에 웹훅 테스트 블록이 표시됩니다.

관리자 페이지의 테스트 섹션은 웹훅 수신 옵션에 따라 달라집니다.

실제 값이 없는 경우 임의의 값을 입력할 수 있습니다.

샌드박스 또는 라이브 모드로 구매할 때 웹훅을 테스트할 수도 있습니다. 환불 테스트는 라이브 모드에서만 사용할 수 있습니다.

웹훅으로 응답 보내기

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

• 성공적인 응답의 경우 200, 201 또는 204 HTTP 코드
• 지정된 사용자를 찾을 수 없거나 잘못된 서명이 전달된 경우 문제 설명이 포함된 400 HTTP 코드

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

다음 단계

1. 정기 결제 정보 가져오기를 구현합니다.
2. 사용자 인증을 설정합니다.

유용한 링크

통합 절차