결제

Classic/VPC 환경에서 이용 가능합니다.

결제

GAMEPOT SDK에서 제공하는 인앱 결제 기능을 사용하여 게임 내 아이템을 판매할 수 있습니다. 결제 전에 스토어별 환경 설정에 해당 스토어에 맞도록 설정해야 합니다. 또한, 대시보드 > 결제 > 인앱에 아이템이 추가되지 않았을 경우 'ProductID not found' 라는 오류가 발생됩니다.

Android

Android에서 상품 정보를 조회하고 결제를 요청하며 미처리 결제를 복구하는 방법을 안내합니다.

(AOS) 인앱 정보 가져오기

결제하실 때에 화면에 결제 정보와 현지 통화 정보를 표시해야 합니다. 아래 함수를 통해서 현재 결제 통화나 이름 등을 가져올 수 있습니다. 만일 정상적으로 가져오지 못하는 경우 콘솔 세팅을 확인해 주십시오.

Kotlin:

import com.nbase.sdk.Store

NBase.getProductItems() {products, e -> 
    if (e != null) {
        Log.e("NBase", e.message)
    } else {
        // 인앱 아이템 정보
        Log.e("NBase", products)
    }
}

Java:

NBase nBase = NBase.INSTANCE;

nBase.getProductItems((products, e) -> {
    if (e != null) {
        Log.e("NBase", "getProductItems fail: " + e.getMessage());
    } else {
        if (products != null) {
            Log.e("NBase", "getProductItems success: " + products.toString());
        }
    }
    return null;
});

다음 표는 상품 정보 조회 콜백으로 전달되는 값을 설명합니다.

• Callback

(AOS) 결제 요청

가져온 인앱 정보에 productId로 결제를 요청할 수 있습니다.

Kotlin:

import com.nbase.sdk.Store

NBase.purchase(activity, Store.GOOGLE, productId, 메타데이터, options) { purchase, e -> 
    if (e != null) {
        Log.e("NBase", e.message)
    } else {
        Log.e("NBase", purchase)
    }
}

Java:

import com.nbase.sdk.Store;

NBase nBase = NBase.INSTANCE;
nBase.purchase(activity, storeId, productId, 메타데이터, options, (purchase, e) -> {
    if (e != null) {
        Log.e("NBase", "purchase fail: " + e.getMessage());
    } else {
        if (purchase != null) {
            Log.e("NBase", "purchase success: " + purchase.toString());
        }
    }
    return null;
});

다음 표는 결제 요청 시 전달하는 매개변수를 설명합니다.

• Parameter

다음 표는 storeId에 전달할 수 있는 스토어 값을 설명합니다.

다음 표는 결제 요청 콜백으로 전달되는 값을 설명합니다.

• Callback

(AOS) 미처리 결제 복구

결제는 완료됐지만 게임에 결과가 전달되지 않은 결제 건을 복구합니다. restorePurchase로 복구를 요청하면 복구된 결제 정보가 setPurchaseRestoreListener로 등록한 리스너에 1건씩 전달됩니다.

• 복구 리스너 등록

로그인이 완료되면 SDK가 바로 복구를 시작하므로 로그인을 호출하기 전에 한 번 등록해 주십시오. 로그인 시와 앱 복귀 시 SDK가 자동으로 수행하는 복구 결과도 같은 리스너로 전달되며, 같은 결제 건의 성공은 한 번만 전달됩니다.

Kotlin:

NBase.setPurchaseRestoreListener { purchase, e ->
    if (e != null) {
        // 복구 실패
        Log.e("NBase", "restore Failed: ${e.message}")
    } else {
        // 복구 성공: orderId, productId 로 아이템을 지급합니다.
        Log.d("NBase", "restore Success: ${purchase?.get("orderId")} / ${purchase?.get("productId")}")
    }
}

Java:

NBase nBase = NBase.INSTANCE;
nBase.setPurchaseRestoreListener((purchase, e) -> {
    if (e != null) {
        // 복구 실패
        Log.e("NBase", "restore Failed: " + e.getMessage());
    } else if (purchase != null) {
        // 복구 성공: orderId, productId 로 아이템을 지급합니다.
        Log.d("NBase", "restore Success: " + purchase.get("orderId") + " / " + purchase.get("productId"));
    }
    return null;
});

다음 표는 복구 리스너 콜백으로 전달되는 값을 설명합니다.

• Callback

• 복구 요청

초기화와 로그인 이후에 호출해 주십시오.

Kotlin:

NBase.restorePurchase(activity) { success, e ->
    if (e != null) {
        Log.e("NBase", "restorePurchase Failed: ${e.message}")
    } else {
        Log.d("NBase", "restorePurchase Success")
    }
}

Java:

NBase nBase = NBase.INSTANCE;
nBase.restorePurchase(activity, (success, e) -> {
    if (e != null) {
        Log.e("NBase", "restorePurchase Failed: " + e.getMessage());
    } else {
        Log.d("NBase", "restorePurchase Success");
    }
    return null;
});

다음 표는 복구 요청 시 전달하는 매개변수를 설명합니다.

• Parameter

다음 표는 복구 요청 콜백으로 전달되는 값을 설명합니다.

• Callback

• 복구 리스너 해제

등록한 리스너를 해제합니다.

Kotlin:

NBase.setPurchaseRestoreListener(null)

Java:

NBase.INSTANCE.setPurchaseRestoreListener(null);

iOS

iOS에서 상품 정보를 조회하고 결제를 요청하는 방법을 안내합니다.

(iOS) 인앱 정보 가져오기

결제하실 때에 화면에 결제 정보와 현지 통화 정보를 표시해야 합니다. 아래 함수를 통해서 현재 결제 통화나 이름 등을 가져올 수 있습니다. 만일 정상적으로 가져오지 못하는 경우 콘솔 세팅을 확인해 주십시오.

Swift:

let products = NBase.getProductItems()

Objective-C:

[NBaseBridge.shared getProductItems:^(NSString * _Nullable result) {
    NSLog(@"getProductItems result: %@", result);
}];

다음 표는 상품 정보 조회 콜백으로 전달되는 값을 설명합니다.

• Callback

(iOS) 결제 요청

가져온 인앱 정보에 productId로 결제를 요청할 수 있습니다.

Swift:

NBase.purchase(productId: productId, 메타데이터: 메타데이터, options: options) { result in
    switch result {
    case .success(let data):
        NBase.showToast(message: data?.encodeToJson() ?? "")
    case .failure(let error):
        NBase.showToast(message: error.errorDescription ?? "")
    }
}

Objective-C:

[NBaseBridge.shared purchase:productId 메타데이터:메타데이터 options:options :^(NSDictionary * _Nullable result, NSError * _Nullable error) {
    if (error) {
        NSLog(@"purchase Error: %@", error.localizedDescription);
    } else {
        NSLog(@"purchase succeeded with result: %@", result);
    }
}];

다음 표는 결제 요청 시 전달하는 매개변수를 설명합니다.

• Parameter

다음 표는 결제 요청 콜백으로 전달되는 값을 설명합니다.

• Callback

Unity

Unity에서 상품 정보를 조회하고 결제를 요청하며 Android 미처리 결제를 복구하는 방법을 안내합니다.

(Unity) 인앱 정보 가져오기

결제하실 때에 화면에 결제 정보와 현지 통화 정보를 표시해야 합니다.
아래 함수를 통해서 현재 결제 통화나 이름 등을 가져올 수 있습니다. 만일 정상적으로 가져오지 못하는 경우 콘솔 세팅을 확인해 주십시오.

NBaseSDK.NBase.getProductItems((products, error) => 
{
    if (products != null && products.Count > 0)
    {
        // 제품 목록을 순회합니다.
        foreach (var product in products)
        {
            // 각 제품의 정보를 토스트 메시지로 보여줍니다.
            // 예시에서는 product.ToString()을 호출하고 있지만,
            // 실제로는 product의 구체적인 속성(예: 이름, 가격 등)을 표시할 수 있습니다.
            NBaseSDK.NBase.showToast(product.ToString());
        }
    }
    else
    {
        // 제품 목록이 비어있는 경우, 사용자에게 알립니다.
        NBaseSDK.NBase.showToast("제품 목록이 비어있습니다.");
    }
});

다음 표는 상품 정보 조회 콜백으로 전달되는 값을 설명합니다.

• Callback

(Unity) 결제 요청

가져온 인앱 정보에 productId 로 결제를 요청할 수 있습니다.

NBaseSDK.NBase.purchase(Store.google.ToString(), productId, 메타데이터, options, (purchase, error) => 
{
    if (error != null)
    {
        Debug.Log(error.Message.ToString());
        return;
    }
    // 결제 성공
});

다음 표는 결제 요청 시 전달하는 매개변수를 설명합니다.

• Parameter

다음 표는 storeId에 전달할 수 있는 스토어 값을 설명합니다.

다음 표는 결제 요청 콜백으로 전달되는 값을 설명합니다.

• Callback

(Unity) 미처리 결제 복구

결제는 완료됐지만 게임에 결과가 전달되지 않은 결제 건을 복구합니다. restorePurchase로 복구를 요청하면 복구된 결제 정보가 setPurchaseRestoreListener로 등록한 리스너에 1건씩 전달됩니다.

• 복구 리스너 등록

로그인이 완료되면 SDK가 바로 복구를 시작하므로 로그인을 호출하기 전에 한 번 등록해 주십시오. 로그인 시와 앱 복귀 시 SDK가 자동으로 수행하는 복구 결과도 같은 리스너로 전달되며, 같은 결제 건의 성공은 한 번만 전달됩니다.

NBaseSDK.NBase.setPurchaseRestoreListener((purchase, error) =>
{
    if (error != null)
    {
        // 복구 실패
        Debug.Log("restore Failed: " + error.Message);
        return;
    }
    // 복구 성공: orderId, productId 로 아이템을 지급합니다.
    Debug.Log("restore Success: " + purchase.orderId + " / " + purchase.productId);
});

다음 표는 복구 리스너 콜백으로 전달되는 값을 설명합니다.

• Callback

• 복구 요청

초기화와 로그인 이후에 호출해 주십시오.

NBaseSDK.NBase.restorePurchase((success, error) =>
{
    if (error != null)
    {
        Debug.Log("restorePurchase Failed: " + error.Message);
        return;
    }
    Debug.Log("restorePurchase Success");
});

다음 표는 복구 요청 콜백으로 전달되는 값을 설명합니다.

• Callback

• 복구 리스너 해제

등록한 리스너를 해제합니다.

NBaseSDK.NBase.removePurchaseRestoreListener();

문제 해결

결제 연동 중 자주 발생하는 오류와 확인 사항을 안내합니다.

Q. ProductID not found 오류가 발생합니다.
A. 대시보드 > 결제 > 인앱에 해당 상품 ID가 등록되어 있는지 확인해 주십시오.

Q. 결제가 진행되지 않습니다.
A. 스토어별 환경 설정을 참고하여 해당 스토어에 맞는 설정이 완료되었는지 확인해 주십시오.

Q. (Android) java.lang.NoClassDefFoundError: Failed resolution of: Lcom/android/billingclient/api/BillingClient;
A. 아래 코드를 추가해 주십시오.

<androidPackage spec="com.android.billingclient:billing:8.0.0" />

Q. (iOS) 인앱 정보를 가져올 수 없습니다.
A. Apple Connect에 등록된 인앱 상품 정보와 앱 환경(Production/Sandbox)이 일치하는지 확인해 주십시오.