iOS 영수증 검증

iOS 인앱 결제(IAP) 영수증을 검증합니다.

URL 확인

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

API 정보

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

요청 파라미터

파라미터	타입	필수	설명
receipt	string	필수	영수증 정보
product_id	string	필수	결제 상품 아이디
currency	string	필수	화폐 코드 (KRW, JPY, USD, CNY...)
price	string	필수	결제 금액
duplicate_allow	string	필수	영수증 중복 검증 허용 여부 (Y/N)

응답 데이터

필드	타입	설명
UserID	string	사용자 ID
PackageName	string	패키지 이름
OrderID	string	주문 ID
ProductID	string	상품 ID
Currency	string	통화 코드
Price	string	가격

코드 예제

void UMyGame::ValidateIOSIAP(const FString& Receipt, const FString& ProductId, const FString& Currency, const FString& Price, bool bDuplicateAllow)
{
    // 플레이어 정보가 포함된 요청 바디 생성
    TSharedPtr<FJsonObject> Body = FPlayNANOOHelper::CreateRequestBody();
    Body->SetStringField(TEXT("receipt"), Receipt);
    Body->SetStringField(TEXT("product_id"), ProductId);
    Body->SetStringField(TEXT("currency"), Currency);
    Body->SetStringField(TEXT("price"), Price);
    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/ios"));
    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 ValidatedPrice = JsonObject->GetStringField(TEXT("Price"));
                FString ValidatedCurrency = JsonObject->GetStringField(TEXT("Currency"));

                UE_LOG(LogTemp, Log, TEXT("IAP 검증 성공 - 주문ID: %s, 상품ID: %s, 가격: %s %s"),
                    *OrderID, *ProductID, *ValidatedPrice, *ValidatedCurrency);
            }
        }
    });

    Request->ProcessRequest();
}

영수증 중복 검증

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

App Store 영수증

receipt는 StoreKit에서 제공하는 Base64로 인코딩된 영수증 데이터입니다. 영수증 데이터는 appStoreReceiptURL을 통해 얻을 수 있습니다.

가격 정보

price는 실제 결제된 금액을 문자열로 전달해야 합니다. currency는 ISO 4217 통화 코드를 사용합니다.