구매

Use the SDK to make virtual purchases and redeem real money purchases.

읽는 시간 1분

최근 업데이트: 5달 전

Purchases

네임스페이스에서 메서드를 사용하면 현재 로그인한 사용자의 구매를 생성할 수 있습니다.

참고

이 네임스페이스에 있는 모든 메서드로 인해 EconomyException이 발생할 수 있습니다.

MakeVirtualPurchaseAsync

ID별로 지정된 가상 구매를 생성합니다. 이 메서드는 필요에 따라

MakeVirtualPurchaseOptions

오브젝트를 사용합니다. 이를 사용해 플레이어 인벤토리에 있는 아이템의

PlayersInventoryItems

ID를 지정하여 구매 비용에 사용되도록 할 수 있습니다. 이렇게 지정하지 않으면 비용에 사용되는 아이템이 자동으로 정해집니다.

MakeVirtualPurchaseResult

가 반환됩니다. 예시:


string purchaseID = "BUY_A_SWORD";MakeVirtualPurchaseResult purchaseResult = await EconomyService.Instance.Purchases.MakeVirtualPurchaseAsync(purchaseID);

PlayersInventoryItem

ID를 사용하는 다른 예시:


string purchaseID = "BUY_A_SWORD";MakeVirtualPurchaseOptions options = new MakeVirtualPurchaseOptions{    PlayersInventoryItemIds = new List<string> { "playersInventoryItemId1", "playersInventoryItemId2" }};MakeVirtualPurchaseResult purchaseResult = await EconomyService.Instance.Purchases.MakeVirtualPurchaseAsync(purchaseID, options);

MakeVirtualPurchaseOptions

MakeVirtualPurchaseAsync

호출의 옵션 오브젝트입니다. 포함되는 필드는 다음과 같습니다.

```
PlayersInventoryItemIds
```
: 문자열 목록입니다. 기본값은
```
null
```
입니다. 구매 비용에 사용하려는 플레이어 인벤토리에 있는 아이템의
```
PlayersInventoryItem
```
ID입니다.

MakeVirtualPurchaseResult

이 오브젝트는

MakeVirtualPurchaseAsync

호출로 반환됩니다. 포함되는 필드는 다음과 같습니다.

```
Costs
```
: 구매에서 지출된 비용을 나타내는
```
Costs
```
오브젝트입니다. 다음 필드 2개로 구성됩니다.
- ```
Currency
```
  :
```
CurrencyExchangeItem
```
  목록이며, 구매를 생성하는 데 사용되는 재화를 설명해 줍니다.
- ```
Inventory
```
  :
```
InventoryExchangeItem
```
  목록이며, 구매를 생성하기 위해 비용으로 사용되는 아이템을 설명해 줍니다.
```
Rewards
```
:
```
Rewards
```
오브젝트이며, 구매의 대가로 제공되는 보상을 나타냅니다. 위의 오브젝트처럼 다음 필드 2개로 구성됩니다.
- ```
Currency
```
  :
```
CurrencyExchangeItem
```
  목록이며, 구매의 일환으로 보상되는 재화를 설명해 줍니다.
- ```
Inventory
```
  :
```
InventoryExchangeItem
```
  목록이며, 구매의 일환으로 보상되는 아이템을 설명해 줍니다.

RedeemAppleAppStorePurchaseAsync

Apple 앱 스토어에서 영수증을 제출하여 현금 구매를 보상받습니다. 확인하는 절차를 거치고 검증되면 구성에 정의된 대로 플레이어 인벤토리와 재화 잔액에 보상이 적용됩니다. 필수

RedeemAppleAppStorePurchaseArgs

오브젝트를 사용합니다. 이를 사용하여 구매 세부 정보를 제공합니다.


RedeemAppleAppStorePurchaseArgs args = new RedeemAppleAppStorePurchaseArgs("PURCHASE_ID", "RECEIPT_FROM_APP_STORE", 0, "USD");RedeemAppleAppStorePurchaseResult purchaseResult = await EconomyService.Instance.RedeemAppleAppStorePurchaseAsync(args);

RedeemAppleAppStorePurchaseArgs

RedeemAppleAppStorePurchaseAsync

호출의 인수 오브젝트입니다. 포함되는 필드는 다음과 같습니다.

```
RealMoneyPurchaseId
```
: 문자열이며, 생성할 구매의 구성 ID입니다.
```
Receipt
```
: 문자열이며, Apple 앱 스토어에서 반환된 영수증 데이터입니다.
```
LocalCost
```
: 정수입니다. 뒷자리 재화 형식의 구매 비용이 정수로 표시됩니다. 예: USD1.99인 경우 199로 표시
```
LocalCurrency
```
: 문자열이며, 구매에 사용된 재화의 ISO-4217 코드입니다.

RedeemAppleAppStorePurchaseResult

이 오브젝트는

RedeemAppleAppStorePurchaseAsync

호출로 반환됩니다. 포함되는 필드는 다음과 같습니다.

```
Verification
```
: 확인 서비스에서 제출된 영수증 확인 세부 정보입니다.
- ```
Status
```
  : 영수증 확인의 상태입니다. 다음 중 하나로 구분됩니다.
  - ```
  VALID
```
  : 유효한 구매입니다.
- ```
VALID_NOT_REDEEMED
```
    : 유효한 구매이고 이미 확인했지만 아직 보상되지 않았습니다.
  - ```
  INVALID_ALREADY_REDEEMED
```
  : 이미 보상된 구매입니다.
- ```
INVALID_VERIFICATION_FAILED
```
    : 영수증 데이터가 유효하지 않아 영수증 확인 서비스에서 반환되었습니다.
  - ```
  INVALID_ANOTHER_PLAYER
```
  : 이미 다른 플레이어가 사용한 영수증이며 확인된 건입니다.
- ```
INVALID_CONFIGURATION
```
    : 서비스 구성이 유효하지 않으니, 응답의 세부 정보 세션에서 자세한 내용을 확인해야 합니다.
  - ```
  INVALID_PRODUCT_ID_MISMATCH
```
  : 구매 구성 스토어 제품 ID가 영수증상의 내용과 일치하지 않습니다.
- ```
Store
```
  : 영수증 확인 서비스의 세부 정보입니다. 다음 필드 3개로 구성됩니다.
  - ```
  Code
```
  : Apple 앱 스토어 확인 서비스에서 다시 전송된 상태 코드입니다.
- ```
Message
```
    : 반환된 상태 코드의 텍스트 설명입니다.
  - ```
  Receipt
```
  : 구매 영수증 데이터입니다.
```
Rewards
```
:
```
Rewards
```
오브젝트이며, 구매의 대가로 제공되는 보상을 나타냅니다. 다음 필드로 구성됩니다.
- ```
Currency
```
  :
```
CurrencyExchangeItem
```
  목록이며, 구매의 일환으로 보상되는 재화를 설명해 줍니다.
- ```
Inventory
```
  :
```
InventoryExchangeItem
```
  목록이며, 구매의 일환으로 보상되는 아이템을 설명해 줍니다.

EconomyAppleAppStorePurchaseFailedException

RedeemAppleAppStorePurchaseAsync

에서

EconomyAppleAppStorePurchaseFailedException

예외 유형이 발생할 수 있습니다. 이는

EconomyException

에서 상속되며

Data

라는 추가 필드 하나가 포함됩니다.

Data

데이터 필드는

RedeemAppleAppStorePurchaseResult

유형입니다(위 참고).

참고

이

Data

필드는 기본

Exception

클래스에 있는

Data

필드와는 다릅니다.

RedeemGooglePlayPurchaseAsync

Google Play 스토어에서 영수증을 제출하여 현금 구매를 보상받습니다. 확인하는 절차를 거치고 검증되면 구성에 정의된 대로 플레이어 인벤토리와 재화 잔액에 보상이 적용됩니다. 필수

RedeemGooglePlayStorePurchaseArgs

오브젝트를 사용합니다. 이를 사용하여 구매 세부 정보를 제공합니다.


RedeemGooglePlayStorePurchaseArgs args = new RedeemGooglePlayStorePurchaseArgs("PURCHASE_ID", "PURCHASE_DATA", "PURCHASE_DATA_SIGNATURE", 0, "USD");RedeemGooglePlayPurchaseResult purchaseResult = await EconomyService.Instance.RedeemGooglePlayPurchaseAsync(args);

RedeemGooglePlayStorePurchaseArgs

RedeemGooglePlayPurchaseAsync

호출의 인수 오브젝트입니다. 포함되는 필드는 다음과 같습니다.

```
RealMoneyPurchaseId
```
: 문자열이며, 생성할 구매의 구성 ID입니다.
```
PurchaseData
```
: 문자열이며, 성공적인 앱 결제 구매에서 반환된 JSON 인코딩 문자열입니다.
```
PurchaseDataSignature
```
: 문자열이며, 성공적인 앱 결제 구매에서 반환된
```
PurchaseData
```
의 서명입니다.
```
LocalCost
```
: 정수입니다. 뒷자리 재화 형식의 구매 비용이 정수로 표시됩니다. 예: USD1.99인 경우 199로 표시
```
LocalCurrency
```
: 문자열이며, 구매에 사용된 재화의 ISO-4217 코드입니다.

RedeemGooglePlayPurchaseResult

이 오브젝트는

RedeemGooglePlayPurchaseAsync

호출로 반환됩니다. 포함되는 필드는 다음과 같습니다.

```
Verification
```
: 확인 서비스에서 제출된 영수증 확인 세부 정보입니다.
- ```
Status
```
  : 영수증 확인의 상태입니다. 다음 중 하나로 구분됩니다.
  - ```
  VALID
```
  : 유효한 구매입니다.
- ```
VALID_NOT_REDEEMED
```
    : 유효한 구매이고 이미 확인했지만 아직 보상되지 않았습니다.
  - ```
  INVALID_ALREADY_REDEEMED
```
  : 이미 보상된 구매입니다.
- ```
INVALID_VERIFICATION_FAILED
```
    : 영수증 데이터가 유효하지 않아 영수증 확인 서비스에서 반환되었습니다.
  - ```
  INVALID_ANOTHER_PLAYER
```
  : 이미 다른 플레이어가 사용한 영수증이며 확인된 건입니다.
- ```
INVALID_CONFIGURATION
```
    : 서비스 구성이 유효하지 않으니, 응답의 세부 정보 세션에서 자세한 내용을 확인해야 합니다.
  - ```
  INVALID_PRODUCT_ID_MISMATCH
```
  : 구매 구성 스토어 제품 ID가 영수증상의 내용과 일치하지 않습니다.
- ```
Store
```
  : 영수증 확인 서비스의 세부 정보입니다. 다음 필드 1개로 구성됩니다.
  - ```
  Receipt
```
  : 구매 영수증 데이터입니다.
```
Rewards
```
:
```
Rewards
```
오브젝트이며, 구매의 대가로 제공되는 보상을 나타냅니다. 다음 필드로 구성됩니다.
- ```
Currency
```
  :
```
CurrencyExchangeItem
```
  목록이며, 구매의 일환으로 보상되는 재화를 설명해 줍니다.
- ```
Inventory
```
  :
```
InventoryExchangeItem
```
  목록이며, 구매의 일환으로 보상되는 아이템을 설명해 줍니다.

EconomyGooglePlayStorePurchaseFailedException

RedeemGooglePlayPurchaseAsync

에서

EconomyGooglePlayStorePurchaseFailedException

예외 유형이 발생할 수 있습니다. 이는

EconomyException

에서 상속되며

Data

라는 추가 필드 하나가 포함됩니다.

Data

데이터 필드는

RedeemGooglePlayPurchaseResult

유형입니다(위 참고).

참고

이

Data

필드는 기본

Exception

클래스에 있는

Data

필드와는 다릅니다.

CurrencyExchangeItem

이 오브젝트는 구매와 관련된 재화를 나타냅니다. 다음 필드로 구성됩니다.

```
Id
```
: 재화 ID입니다.
```
Amount
```
: 구매에 사용된 재화의 금액입니다.

InventoryExchangeItem

이 오브젝트는 구매와 관련된 인벤토리 아이템을 나타냅니다. 다음 필드로 구성됩니다.

```
Id
```
: 재화 ID입니다.
```
Amount
```
: 구매에서 사용하거나 보상된 이 인벤토리 아이템의 금액입니다.
```
InstanceIds
```
: 구매에서 사용되거나 보상된 인스턴스 ID 목록입니다.

기술 자료

Development

User Acquisition

Monetization

산업 분야

기술 자료

Development

User Acquisition

Monetization

산업 분야

Economy

Economy

구매

MakeVirtualPurchaseAsync

MakeVirtualPurchaseOptions

MakeVirtualPurchaseResult

RedeemAppleAppStorePurchaseAsync

RedeemAppleAppStorePurchaseArgs

RedeemAppleAppStorePurchaseResult

EconomyAppleAppStorePurchaseFailedException

RedeemGooglePlayPurchaseAsync

RedeemGooglePlayStorePurchaseArgs

RedeemGooglePlayPurchaseResult

EconomyGooglePlayStorePurchaseFailedException

CurrencyExchangeItem

InventoryExchangeItem