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 | 必填 | 支付商品ID |
| 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货币代码。