Android Receipt Verification

Verify Android in-app purchase (IAP) receipts.

URL Check

This API uses the service-api.playnanoo.com domain.

API Information

• URL: https://service-api.playnanoo.com/iap/v20221001/unity/android
• Method: PUT
• Authentication Required: Yes

Request Parameters

Parameter	Type	Required	Description
receipt	string	Required	Receipt information
skuDetails	string	Yes	Android product information
signature	string	Yes	Android Signature
duplicate_allow	string	Required	Allow duplicate receipt verification (Y/N)

Response Data

Field	Type	Description
UserID	string	User ID
PackageName	string	Package name
OrderID	string	Order ID
ProductID	string	Product ID
Currency	string	Currency code
Quantity	string	Quantity
Price	string	Price
PurchaseState	string	Verification result purchase : Successfully paid wait : Processing in progress cancel : Verification failed

Handling wait Status

If the status is wait, please send a re-verification request.

Code Example

void UMyGame::ValidateAndroidIAP(const FString& Receipt, const FString& SkuDetails, const FString& Signature, bool bDuplicateAllow)
{
    // 플레이어 정보가 포함된 요청 바디 생성
    TSharedPtr<FJsonObject> Body = FPlayNANOOHelper::CreateRequestBody();
    Body->SetStringField(TEXT("receipt"), Receipt);
    if (!SkuDetails.IsEmpty())
    {
        Body->SetStringField(TEXT("skuDetails"), SkuDetails);
    }
    if (!Signature.IsEmpty())
    {
        Body->SetStringField(TEXT("signature"), Signature);
    }
    Body->SetStringField(TEXT("duplicate_allow"), bDuplicateAllow ? TEXT("Y") : TEXT("N"));

    // JSON 문자열 변환
    FString JsonBody = FPlayNANOOHelper::ToJsonString(Body);

    // HTTP 요청
    TSharedRef<IHttpRequest> Request = FHttpModule::Get().CreateRequest();
    Request->SetURL(TEXT("https://service-api.playnanoo.com/iap/v20221001/unity/android"));
    Request->SetVerb(TEXT("PUT"));
    FPlayNANOOHelper::SetCommonHeaders(Request, true);  // 인증 토큰 포함
    Request->SetContentAsString(JsonBody);

    Request->OnProcessRequestComplete().BindLambda(
        [](FHttpRequestPtr Req, FHttpResponsePtr Res, bool bSuccess)
    {
        if (bSuccess && Res.IsValid())
        {
            TSharedPtr<FJsonObject> JsonObject;
            TSharedRef<TJsonReader<>> Reader = TJsonReaderFactory<>::Create(Res->GetContentAsString());

            if (FJsonSerializer::Deserialize(Reader, JsonObject))
            {
                FString UserID = JsonObject->GetStringField(TEXT("UserID"));
                FString OrderID = JsonObject->GetStringField(TEXT("OrderID"));
                FString ProductID = JsonObject->GetStringField(TEXT("ProductID"));
                FString Price = JsonObject->GetStringField(TEXT("Price"));
                FString Currency = JsonObject->GetStringField(TEXT("Currency"));
                FString Quantity = JsonObject->GetStringField(TEXT("Quantity"));
                FString PurchaseState = JsonObject->GetStringField(TEXT("PurchaseState"));

                UE_LOG(LogTemp, Log, TEXT("IAP 검증 성공 - 주문ID: %s, 상품ID: %s, 가격: %s %s, 수량: %s, 상태: %s"),
                    *OrderID, *ProductID, *Price, *Currency, *Quantity, *PurchaseState);
            }
        }
    });

    Request->ProcessRequest();
}

Duplicate Receipt Verification

Setting duplicate_allow to "N" prevents duplicate verification with the same receipt. In a test environment, you can set it to "Y" to allow duplicate verification.

Google Play Receipt

The receipt is JSON-formatted receipt information including purchaseToken provided by the Google Play Billing Library.