주요 콘텐츠로 건너뛰기

Aghanim을 통해 게임 클라이언트에서 아이템을 구매하는 방법

해당 가이드는 게임 클라이언트를 사용하여 Aghanim API를 통해 Game Hub에서 아이템을 구매하는 단계별 프로세스를 제공합니다.

전제 조건

  • API 키: API 요청을 인증하는 데 필요합니다.
  • item.add 웹훅 통합: 구매한 아이템을 처리하기 위해 item.add 웹훅이 통합되어 있는지 확인합니다.

1단계: 게임 서버에서 주문 생성

사용자가 게임 클라이언트에서 "구매하기" 버튼을 클릭하면 클라이언트는 게임 서버의 백엔드로 주문을 생성하기 위한 메시지를 보내야 합니다. 이 작업은 서버 간(S2S) API를 사용하여 주문 생성 엔드포인트에 POST 요청을 보내서 수행됩니다.

요청 스키마

POST 요청 페이로드에는 다음 필드가 포함되어야 합니다:

필드유형설명필수 여부
player_idstring구매를 하는 플레이어의 고유 ID.예
itemsItem[]플레이어가 구매하려는 아이템 목록.예
ip_addressstring구매를 하는 플레이어의 IP 주소.아니요
user_agentstring구매를 하는 플레이어의 사용자 에이전트.아니요
localestring구매를 하는 플레이어의 로케일.아니요
countrystring구매를 하는 플레이어의 국가.아니요

Item 객체 스키마

items 배열의 각 항목은 다음 구조를 따라야 합니다:

필드유형설명필수 여부
idstring아이템의 고유 ID.예
skustring아이템의 SKU(재고 관리 코드).예
namestring아이템의 이름.예
pricenumber소수 통화 단위로 표시되는 아이템 가격.예
currencystring아이템 가격 통화.예
image_urlstring아이템 이미지의 URL.아니요
descriptionstring아이템 설명.아니요
quantitynumber구매할 아이템의 수량.아니요
discount_percentnumber아이템에 적용된 할인 비율.아니요
bonus_percentnumber아이템에 적용된 보너스 비율.아니요

예시 요청

다음은 curl을 사용하여 POST 요청을 통해 주문을 생성하는 예시입니다:

curl -X POST https://api.aghanim.com/s2s/v1/orders \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <YOUR_API_KEY>' \
  -d '{
        "player_id": "2D2R-OP3C",
        "items": [
          {
            "id": "093431513412",
            "sku": "crystals",
            "name": "크리스탈",
            "price": 9499,
            "currency": "USD",
            "image_url": "https://example.com/crystals.png",
            "description": "이 엄청난 크리스탈 보물로 경쟁자를 압도하세요.",
            "quantity": 480000
          }
        ]
    }'

예시 응답

주문 생성 성공 시, 서버는 order_id로 응답합니다:

{"order_id": "ord_eCacpFwavzi"}

2단계: 게임 클라이언트에서 결제 창 열기

주문이 생성되면 JavaScript 함수 aghanim.purchase(orderId)를 호출하여 게임 클라이언트에서 구매 창을 열 수 있습니다.

예시 함수 호출

aghanim.purchase('ord_eCacpFwavzi');

이 함수는 게임 내 구매 과정을 작동시켜 플레이어가 거래를 완료할 수 있도록 합니다.

도움이 필요하세요?
통합팀에 문의하십시오 [email protected]

On this page