Android 收据 验证

Android 应用内购买(IAP) 收据 验证。

URL确认

此API使用 service-api.playnanoo.com 域名。

API信息

• URL: https://service-api.playnanoo.com/iap/v20221001/unity/android
• Method: PUT
• 需要认证: 是

请求参数

参数	类型	必填	说明
receipt	string	必填	收据 信息
skuDetails	string	必填	Android 商品 信息
signature	string	必填	Android 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格式收据信息。