작동 방식
사용자는 친구를 위한 선물 기능을 통해 가상 화폐, 가상 아이템또는 실제 통화를 위한 게임 액세스 키를 구입하고 인게임 친구에게 선물로 보낼 수 있습니다. 성공적으로 결제한 후, 제공자는 영수증을 받게 되고 수령인은 선물 세부 정보가 포함된 이메일을 받게 됩니다. 제공자는 자신의 데이터를 감추어 선물을 익명으로 보낼 수도 있습니다.
이 옵션에는 다양한 통합 옵션이 있으며 게임 프로젝트에서 다음을 제공할 수 있습니다.
Note:
이 옵션은 엑솔라 측 사용자 데이터 저장소가 비활성화된 프로젝트에만 사용할 수 있습니다.
사용자
스토어를 통합하고 가상 아이템/가상 화폐/게임 키 모듈을 활성화한 파트너.
획득 방법
기능 활성화 방법:
- 가상 화폐 패키지, 가상 아이템 및/또는 게임 키 패키지를 구성합니다.
- 친구 가져오기 API 메소드를 구현하고 토큰 요청에 친구 오브젝트를 추가합니다.
- 선물 데이터를 비롯한 결제 웹훅을 성공적으로 처리합니다.
- 계정 관리자에게 문의하여 이 옵션을 활성화하도록 요청합니다.
토큰을 통해 친구 목록 전송
필요할 경우 사용자의 친구 배열을 요청에 추가 할 수 있습니다. 친구 배열에 요소가 하나만 포함되어 있으면 해당 친구가 자동으로 선물 수령자로 간주됩니다. 토큰 요청에 최대 100명의 친구를 보낼 수 있습니다. 요청에 선물 데이터를 포함시킬 수도 있습니다.
요청 예시
"purchase":{
"virtual_currency":{
"quantity":100
},
"description":{
"value":"Test Purchase"
},
"gift":{
"giver_id":"John Smith",
"message":"GG WP",
"hide_giver_from_receiver" : true,
"friends": [
{
"id": "123",
"name": "captain",
"email": "captain@ship.com"
}]
}
}
API 요청을 통해 친구 목록 전송
엑솔라는 친구 목록 요청을 프로젝트를 위해 설정된 웹훅 URL로 보냅니다.
서명 생성
전자 서명 생성 방법:
- 엑솔라에서 수신한 매개변수를 알파벳순으로 정렬합니다.
- 매개변수 값과 비밀 키(프로젝트 설정 페이지에서 생성)를 하나의 문자열로 연결합니다.
- SHA1 알고리즘을 사용하여 문자열을 해시합니다.
- 서명을 sign 매개변수에 전송합니다.
Note:
API 요청 처리 시, 수신된 서명이 sign 매개변수에 전송한 서명과 동일한지 확인합니다
친구 목록 입수
요청 예시
$ curl -v 'https://your.webhook.url?notification_type=friends_list&user=user_id&query=frien&offset=10&limit=20&sign=12dfg3f5gdsf4g5s6dfg2sdg1' \
-X GET \
-u merchant_id:merchant_api_key
응답 예제
[
{
"friends": [
{
"id": "1",
"name": "John Carter",
"email": "carter@xsolla.com",
"image_url": "https://partner/link/doctor.jpg"
},
{
"id": "2",
"name": "John Smith",
"email": "smith@xsolla.com",
"image_url": "https://partner/link/cook.jpg"
}
],
"total": 10
}
]