친구를 위한 선물

작동 방식

사용자는 친구를 위한 선물 기능을 통해 가상 화폐, 가상 아이템또는 실제 통화를 위한 게임 액세스 키를 구입하고 인게임 친구에게 선물로 보낼 수 있습니다. 성공적으로 결제한 후, 제공자는 영수증을 받게 되고 수령인은 선물 세부 정보가 포함된 이메일을 받게 됩니다. 제공자는 자신의 데이터를 감추어 선물을 익명으로 보낼 수도 있습니다.

이 옵션에는 다양한 통합 옵션이 있으며 게임 프로젝트에서 다음을 제공할 수 있습니다.

  • 가상 통화 패키지
  • 가상 아이템
  • 게임 키

Note: 이 옵션은 엑솔라 측 사용자 데이터 저장소가 비활성화된 프로젝트에만 사용할 수 있습니다.

사용자

Buy Button을 통합하고 가상 아이템/게임머니/게임 키 모듈을 활성화한 파트너.

획득 방법

기능 활성화 방법:

  1. 가상 화폐 패키지, 가상 아이템 및/또는 게임 키 패키지를 구성합니다.
  2. 친구 가져오기 API 메소드를 구현하고 토큰 요청에 친구 오브젝트를 추가합니다.
  3. 선물 데이터를 비롯한 결제 웹훅을 성공적으로 처리합니다.
  4. 계정 관리자에게 문의하여 이 옵션을 활성화하도록 요청합니다.

토큰을 통해 친구 목록 전송

필요할 경우 사용자의 친구 배열을 요청에 추가 할 수 있습니다. 친구 배열에 요소가 하나만 포함되어 있으면 해당 친구가 자동으로 선물 수령자로 간주됩니다. 토큰 요청에 최대 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로 보냅니다.

서명 생성

전자 서명 생성 방법:

  1. 엑솔라에서 수신한 매개변수를 알파벳순으로 정렬합니다.
  2. 매개변수 값과 비밀 키(프로젝트 설정 페이지에서 생성)를 하나의 문자열로 연결합니다.
  3. SHA1 알고리즘을 사용하여 문자열을 해시합니다.
  4. 서명을 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
  }
]