跳转到主要内容

iOS 收据 验证

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

URL确认

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

API信息

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

请求参数

参数类型必填说明
receiptstring必填收据 信息
product_idstring必填支付商品ID
currencystring必填货币代码 (KRW, JPY, USD, CNY...)
pricestring必填支付金额
duplicate_allowstring必填收据重复验证允许与否 (Y/N)

响应数据

字段类型说明
UserIDstring用户 ID
PackageNamestring包名称
OrderIDstring订单ID
ProductIDstring商品ID
Currencystring货币代码
Pricestring价格

代码示例

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货币代码。