결제 > 참조 >

verifyPurchase

이 섹션은 Verify Purchase API에 대한 참조 및 샘플 요청 코드 조각을 포함하고 있습니다.

설명

verifyPurchase API는 사용자에게 IAP 제품을 할당하기 전에 인앱 구매를 확인하는 데 사용됩니다.

중요 정보

  • 이 API는 앱 백엔드 서버에서 호출되어야 합니다.

기본 URL

 https://cloud-api.bluestacks.cn/

요청 경로

 v2/seller/order/verifyPurchase

요청 메서드

 POST

요청 헤더

 'Authorization': '<payment_api_key_here>',
  'Content-Type': 'application/x-www-form-urlencoded'

요청 본문

verifyPurchase API와 함께 요청 본문에 다음 매개변수를 포함해야 합니다:

 
   purchaseToken=<nowgg_purchase_token>

샘플 요청

다음 샘플 코드는 verifyPurchase API를 사용한 요청 예시를 보여줍니다.

import requests

  url = "https://cloud-api.bluestacks.cn/v2/seller/order/verifyPurchase"

  payload = 'purchaseToken=<nowgg_purchase_token>'
  headers = {
  'Authorization': '<payment_api_key_here>',
  'Content-Type': 'application/x-www-form-urlencoded'
  }

  response = requests.request("POST", url, headers=headers, data=payload)

  print(response.text)

curl --location 'https://cloud-api.bluestacks.cn/v2/seller/order/verifyPurchase' \
 --header 'Authorization: <payment_api_key_here>' \
 --header 'Content-Type: application/x-www-form-urlencoded' \
 --data-urlencode 'purchaseToken=<nowgg_purchase_token>'

중요 정보

예상 응답

다음은 verifyPurchase API의 샘플 응답입니다.

{
    "success": true,
    "code": 0,
    "codeMsg": "success",
    "data": {
      "purchaseTimeMillis": "1630529397125", // 이 필드는 더 이상 사용되지 않으므로, purchaseTime을 사용하세요.
      "purchaseTime": "1630529397125",
      "purchaseState": 0,
      "consumptionState": 0,
      "developerPayload": "<developer_payload>",
      "orderId": "<orderId_here>",
      "kind": "nowgg#productPurchase",
      "regionCode": "US"
    }
  }

응답 매개변수

매개변수 유형 설명
success boolean 성공 여부를 true 또는 false로 반환합니다.
code int 성공 시 0을 반환하고, 실패 시 0이 아닌 값을 반환합니다.
codeMsg string 에러 코드와 관련된 메시지를 반환합니다. (여기에서 제공)
purchaseTimeMillis (사용 중단 ) string 제품이 구매된 시간(밀리초 단위의 epoch 시간)을 반환합니다. 이 필드는 더 이상 사용되지 않으므로, purchaseTime을 사용하세요.
purchaseTime string 제품이 구매된 시간, 에포크 이후의 초 단위 시간입니다.
purchaseState int 주문의 구매 상태를 반환합니다. 가능한 값은 다음과 같습니다:
0: 미지급, 1: 지급됨, 2: 실패
consumptionState int 인앱 제품의 소비 상태를 반환합니다. 가능한 값은 다음과 같습니다:
0: 아직 소비되지 않음, 1: 소비됨
developerPayload string 주문에 대한 보충 정보를 포함하는 개발자가 지정한 문자열입니다.
orderId string 각 인앱 구매 제품에 연결된 주문 ID(고유 거래 식별자)입니다.
kind string 하드코딩된 유형인 nowgg#productPurchase로 구매된 인앱 제품 유형을 나타냅니다.
regionCode string 제품이 할당된 시점의 사용자의 ISO 3166-1 alpha-2 청구 지역 코드입니다.

에러 코드 매핑

에러 코드 메시지 설명
3900 INVALID_AUTHORIZATION_KEY 인증에 제공된 API 키가 유효하지 않습니다.
3901 INVALID_PURCHASE_TOKEN 제공된 구매 토큰이 유효하지 않습니다.
×

Table of Contents

verifyPurchase

Table of Contents

문서 Rev. 1.0

클립보드에 복사된 텍스트
copyLinkText
질문이 있으신가요? 다음 주소로 문의하세요. dev-support@now.gg