안드로이드 영수증 검증

안드로이드 인앱 결제(IAP) 영수증을 검증합니다.

URL 확인

이 API는 service-api.playnanoo.com 도메인을 사용합니다.

API 정보

• URL: https://service-api.playnanoo.com/iap/v20221001/unity/android
• Method: PUT
• 인증 필요: 예

요청 파라미터

파라미터	타입	필수	설명
receipt	string	필수	영수증 정보
skuDetails	string	필수	안드로이드 상품 정보
signature	string	필수	안드로이드 Signature
duplicate_allow	string	필수	영수증 중복 검증 허용 여부 (Y/N)

응답 데이터

필드	타입	설명
UserID	string	사용자 ID
PackageName	string	패키지 이름
OrderID	string	주문 ID
ProductID	string	상품 ID
Currency	string	통화 코드
Quantity	string	수량
Price	string	가격
PurchaseState	string	검증 결과 purchase : 정상결제 wait : 처리 진행중 cancel : 검증실패

wait 상태 처리

wait 상태일 경우 재검증 요청을 보내주시면 됩니다.

코드 예제

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_allow를 "N"으로 설정하면 동일한 영수증으로 중복 검증이 불가능합니다. 테스트 환경에서는 "Y"로 설정하여 중복 검증을 허용할 수 있습니다.

Google Play 영수증

receipt는 Google Play Billing Library에서 제공하는 purchaseToken을 포함한 JSON 형식의 영수증 정보입니다.