친구를 위한 선물

작동 방식

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

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

  • 가상 통화 패키지
  • 가상 아이템
  • 게임 키
  • Note: 이 옵션은 엑솔라 측 사용자 데이터 저장소가 비활성화된 프로젝트에만 사용할 수 있습니다.

    사용자

    스토어를 통합하고 가상 아이템/가상 화폐/게임 키 모듈을 활성화한 파트너.

    획득 방법

    기능 활성화 방법:

    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
      }
    ]