웹훅을 사용하면 엑솔라에서 발생하는 구성된 이벤트에 대해 빠르게 알림을 받을 수 있습니다. 웹훅을 사용하여 애플리케이션의 백엔드 및 추가 기능을 자동화할 수 있습니다.
알림을 받을 수 있는 이벤트의 예:
- 게임머니 및 아이템 구매를 포함한 결제
- 정기 결제 및 구독 작업
- 환불
구성된 이벤트가 발생하면 엑솔라가 웹훅을 통해 시스템에 알립니다. 예를 들어, 웹훅을 수신한 후 다음을 수행할 수 있습니다:
- 사용자의 잔액에 추가
- 새 아이템 잠금 해제
- 구독 서비스 시작
- 부정결제 감지 후 게임유저를 차단합니다
결제 처리 웹훅이 작동하는 방식은 다음과 같습니다.
웹훅이 제대로 작동하려면 다음 설정을 적용해야 합니다:
- 다음 IP 주소의 웹훅을 수락해야 합니다:
185.30.20.0/24,185.30.21.0/24,185.30.23.0/24. - 애플리케이션 데이터베이스에 동일한 ID의 트랜잭션이 중복 되어서는 안됩니다.
공지
시스템이 데이터베이스에 이미 존재하는 ID로 웹훅을 다시 보내면 이전 요청 처리 결과를 리턴합니다. 게임유저에게 구매 정보를 다시 제공하거나 데이터베이스에 중복된 값을 생성하지 마십시오.
- 생성된 서명이 HTTP 헤더에서 통과된 서명과 동일해야 합니다.
- 오류가 발생한 경우, 코드 400을 반환합니다(예: 필수 매개 변수 누락, 결제 실패). 코드 500은 일시적 서버 오류를 나타냅니다.
주의
엑솔라는 기본 HTTP 응답 코드를 사용하여 결제 알림(IPN) 요청의 성공 또는 실패를 표시합니다. 코드 204는 성공적인 처리를 나타냅니다.
인터넷 연결이 항상 100% 신뢰할 수 있는 것은 아니므로, 웹훅이 소실되거나 지연될 수 있습니다. 이 문제를 해결하기 위해 엑솔라는 수신기에서 웹훅을 수신할 때까지 실패한 웹훅을 다시 보냅니다. 웹훅 재전송은 수신기에서 수신을 확인할 때까지 이전 전송 후 12시간 이내에 전송됩니다. 최대 재시도 횟수는 12회입니다.
주의
연결 문제로 인해 웹훅 소실, 지연, 중복 현상이 나타나더라도 보통 수신측의 자체 논리 오류로 인해 이러한 문제가 발생하는 경우가 많습니다.
전자 서명은 데이터 전송에 보안을 제공합니다. 서명을 생성하려면:
- 요청의 JSON 콘텐츠와 프로젝트 시크릿 키를 연결합니다.
- 결과 문자열에 SHA-1 해싱을 적용합니다.
POST /your_uri HTTP/1.1
host: your.host
accept: application/json
content-type: application/json
content-length: 165
authorization: Signature 52eac2713985e212351610d008e7e14fae46f902
{
"notification_type":"user_validation",
"user":{
"ip":"127.0.0.1",
"phone":"18777976552",
"email":"email@example.com",
"id":1234567,
"name":"Xsolla User",
"country":"US"
}
}
curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'authorization: Signature 52eac2713985e212351610d008e7e14fae46f902' \
-d '{
"notification_type":
"user_validation",
"user":
{
"ip": "127.0.0.1",
"phone": "18777976552",
"email": "email@example.com",
"id": 1234567,
"name": "Xsolla User",
"country": "US"
}
}'