title: "مهاجرت از Poolakey (بازار)" order: 8 description: "مقایسهٔ کد Poolakey و SDK بلهاستور برای پیکربندی، اتصال، خرید، مصرف، اشتراک و پشتیبانی همزمان از دو فروشگاه"
مهاجرت از Poolakey (کافهبازار)
SDK بلهاستور عمداً همشکل Poolakey طراحی شده است: همان DSL کالبکها (connectionSucceed، purchaseSucceed، …)، همان ActivityResultRegistry و همان شکل PurchaseInfo. در بیشتر پروژهها مهاجرت چند ساعت طول میکشد. اگر میخواهید هم در بازار و هم در بلهاستور منتشر کنید، بخش پشتیبانی همزمان را ببینید.
خلاصهٔ تفاوتها
| موضوع | Poolakey | بلهاستور |
|---|---|---|
| وابستگی | com.github.cafebazaar.Poolakey:poolakey (JitPack) |
ir.bale.balestore:billing-sdk:1.0.0 |
| کلاس اصلی | Payment |
BaleStorePayment |
| کلید بررسی محلی | RSA (rsaPublicKey، base64) |
ECDSA P-256 / ES256 (publicKeyPem) |
| چیزی که امضا میشود | originalJson (با dataSignature) |
توکن خرید purchaseToken که خودش یک JWS است |
| تأیید (acknowledge) | ندارد | الزامی برای غیرمصرفی و اشتراک (acknowledge) |
| مهلت نهاییسازی | — | پیشفرض ۳ روز؛ در غیر این صورت AUTO_REFUNDED |
| قیمت در جزئیات محصول | رشتهٔ قیمت | priceRials (عدد ریال) + priceText (متن تومان) |
dynamicPriceToken |
پشتیبانی میشود | پشتیبانی نمیشود |
| نبود فروشگاه | BazaarNotFoundException |
BaleStoreNotFoundException |
| بررسی در سرور | API توسعهدهندگان بازار | API سرور به سرور + Webhook |
۱. وابستگی و manifest
Poolakey:
// settings.gradle / build.gradle (project)
repositories { maven { url 'https://jitpack.io' } }
// app/build.gradle
dependencies {
implementation "com.github.cafebazaar.Poolakey:poolakey:<version>"
}
بلهاستور:
// settings.gradle.kts
repositories { maven("https://maven.<domain>/releases") } // URL being finalized
// app/build.gradle.kts
dependencies {
implementation("ir.bale.balestore:billing-sdk:1.0.0")
}
<!-- AndroidManifest.xml (Android 11+ package visibility) -->
<queries>
<package android:name="ir.nasim" />
<package android:name="ir.bale.balestore.installer" />
<intent><action android:name="ir.bale.balestore.billing.BIND" /></intent>
</queries>
اگر فقط به بلهاستور مهاجرت میکنید، وابستگی Poolakey و ورودیهای مربوط به بازار (مثلاً <package android:name="com.farsitel.bazaar" /> در <queries>) را حذف کنید. اگر هر دو را نگه میدارید، هر دو بمانند.
۲. پیکربندی
Poolakey:
val securityCheck = SecurityCheck.Enable(rsaPublicKey = "MIHNMA0GCSqGSIb3DQEBAQUAA4G7ADCBtwKBrwC…")
val paymentConfiguration = PaymentConfiguration(localSecurityCheck = securityCheck)
val payment = Payment(context = context, config = paymentConfiguration)
بلهاستور:
val securityCheck = SecurityCheck.Enable(publicKeyPem = """
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE…
-----END PUBLIC KEY-----
""".trimIndent())
val paymentConfiguration = PaymentConfiguration(localSecurityCheck = securityCheck)
val payment = BaleStorePayment(context = context, config = paymentConfiguration)
۳. اتصال
Poolakey:
val paymentConnection = payment.connect {
connectionSucceed { }
connectionFailed { throwable -> }
disconnected { }
}
// …
paymentConnection.disconnect()
بلهاستور:
val connection = payment.connect {
connectionSucceed { }
connectionFailed { throwable -> } // BaleStoreNotFoundException when Bale is missing / too old
disconnected { }
}
// connection.getState(): ConnectionState.Connected | Disconnected | FailedToConnect
connection.disconnect()
۴. خرید
Poolakey:
payment.purchaseProduct(
registry = activityResultRegistry,
request = PurchaseRequest(productId = "coins_100", payload = "order-42")
) {
purchaseFlowBegan { }
failedToBeginFlow { throwable -> }
purchaseSucceed { purchaseEntity -> deliver(purchaseEntity) }
purchaseCanceled { }
purchaseFailed { throwable -> }
}
بلهاستور:
payment.purchaseProduct(
registry = activityResultRegistry,
request = PurchaseRequest(productId = "coins_100", payload = "order-42")
) {
purchaseFlowBegan { }
failedToBeginFlow { throwable -> }
purchaseSucceed { purchase -> deliver(purchase) } // purchase.purchaseToken is an ES256 JWS
purchaseCanceled { }
purchaseFailed { throwable -> } // PurchaseHijackedException if the local check fails
}
شکل PurchaseInfo یکسان است: orderId، purchaseToken، payload، packageName، purchaseState، purchaseTime، productId، originalJson، dataSignature. تفاوت: purchaseState در بلهاستور مقادیر بیشتری دارد (PENDING، PURCHASED، ACKNOWLEDGED، CONSUMED، REFUNDED، AUTO_REFUNDED).
۵. مصرف و تأیید
Poolakey:
payment.consumeProduct(purchaseInfo.purchaseToken) {
consumeSucceed { }
consumeFailed { throwable -> }
}
// non-consumables: nothing to do
بلهاستور:
payment.consumeProduct(purchase.purchaseToken) { // consumables
consumeSucceed { }
consumeFailed { throwable -> }
}
payment.acknowledge(purchase.purchaseToken) { // NEW: non-consumables and subscriptions
acknowledgeSucceed { }
acknowledgeFailed { throwable -> }
}
⚠️ مهمترین تفاوت رفتاری: در بلهاستور، خرید غیرمصرفی و اشتراک باید acknowledge شود. خریدی که تا مهلت (پیشفرض ۳ روز، قابل تنظیم) نه مصرف شود و نه تأیید، خودکار بازپرداخت میشود. تأیید را میتوانید از سرور هم بدهید (
POST /s2s/v1/apps/{packageName}/purchases/{purchaseToken}:acknowledge).
۶. فهرست خریدها
Poolakey:
payment.getPurchasedProducts {
querySucceed { purchasedProducts -> }
queryFailed { throwable -> }
}
بلهاستور:
payment.getPurchasedProducts {
querySucceed { purchases -> purchases.filter { it.purchaseState == PurchaseState.PURCHASED }.forEach(::finish) }
queryFailed { throwable -> }
}
۷. جزئیات محصول
Poolakey:
payment.getInAppSkuDetails(skuIds = listOf("coins_100")) {
getSkuDetailsSucceed { skuDetailsList -> show(skuDetailsList.first().price) }
getSkuDetailsFailed { throwable -> }
}
بلهاستور:
payment.getInAppSkuDetails(skuIds = listOf("coins_100")) {
getSkuDetailsSucceed { list -> show(list.first().priceText) } // priceRials: Long (Rials) for logic
getSkuDetailsFailed { throwable -> }
}
۸. اشتراک
Poolakey:
payment.subscribeProduct(activityResultRegistry, PurchaseRequest(productId = "vip_monthly")) {
purchaseSucceed { purchaseEntity -> }
purchaseCanceled { }
purchaseFailed { throwable -> }
}
payment.getSubscribedProducts {
querySucceed { subs -> }
queryFailed { throwable -> }
}
payment.getSubscriptionSkuDetails(listOf("vip_monthly")) { getSkuDetailsSucceed { }; getSkuDetailsFailed { } }
بلهاستور:
payment.subscribeProduct(activityResultRegistry, PurchaseRequest(productId = "vip_monthly")) {
purchaseFlowBegan { }
failedToBeginFlow { throwable -> }
purchaseSucceed { purchase -> activate(purchase); /* then */ payment.acknowledge(purchase.purchaseToken) { } }
purchaseCanceled { }
purchaseFailed { throwable -> }
}
payment.getSubscribedProducts {
querySucceed { subs -> }
queryFailed { throwable -> }
}
payment.getSubscriptionSkuDetails(listOf("vip_monthly")) { getSkuDetailsSucceed { list -> /* list[0].period = "P1M" */ }; getSkuDetailsFailed { } }
وضعیت جاری اشتراک (انقضا، تمدید، مهلت) را از سرور بگیرید: GET /s2s/v1/apps/{packageName}/subscriptions/{purchaseToken} و رویدادهای subscription.* در Webhookها.
۹. کلید: از RSA به ES256
| بازار (Poolakey) | بلهاستور | |
|---|---|---|
| نوع کلید | RSA | EC P-256 |
| قالب در کد | base64 بدون سرآیند | PEM (-----BEGIN PUBLIC KEY-----)؛ نسخهٔ base64 هم در کنسول هست (publicKeyBase64) |
| چه چیزی بررسی میشود | امضای dataSignature روی originalJson |
امضای JWS خود purchaseToken |
| منبع کلید | پنل توسعهدهندگان بازار | کنسول بلهاستور، GET /console/v1/billing/apps/{appId}/keys |
اگر در سرور خودتان امضای RSA روی originalJson را بررسی میکردید، آن کد را با بررسی JWS ES256 جایگزین کنید (نمونه کد در تأیید توکن خرید)، یا بهتر، از API سرور به سرور استفاده کنید.
<a id="both-stores"></a>
۱۰. پشتیبانی همزمان از بازار و بلهاستور
با لایهٔ متنباز ir.bale.balestore.sdk.store یک رابط BillingBackend دارید و StoreRouter بر اساس منبع نصب پیادهسازی درست را انتخاب میکند. آداپتر Poolakey را خودتان (در ماژول برنامه) مینویسید تا SDK بلهاستور وابستگی به Poolakey نداشته باشد. نمونه:
import androidx.activity.result.ActivityResultRegistry
import ir.bale.balestore.sdk.PurchaseInfo
import ir.bale.balestore.sdk.PurchaseRequest
import ir.bale.balestore.sdk.PurchaseState
import ir.bale.balestore.sdk.SkuDetails
import ir.bale.balestore.sdk.store.BillingBackend
import ir.bale.balestore.sdk.store.ProductType
import ir.bale.balestore.sdk.store.StoreId
import kotlinx.coroutines.suspendCancellableCoroutine
import kotlin.coroutines.resume
import kotlin.coroutines.resumeWithException
// Poolakey types, aliased to avoid clashes (check the package names of your Poolakey version)
import ir.cafebazaar.poolakey.Connection as BazaarConnection
import ir.cafebazaar.poolakey.Payment as BazaarPayment
import ir.cafebazaar.poolakey.config.PaymentConfiguration as BazaarConfig
import ir.cafebazaar.poolakey.config.SecurityCheck as BazaarSecurityCheck
import ir.cafebazaar.poolakey.entity.PurchaseInfo as BazaarPurchaseInfo
import ir.cafebazaar.poolakey.entity.PurchaseState as BazaarPurchaseState
import ir.cafebazaar.poolakey.request.PurchaseRequest as BazaarPurchaseRequest
class PoolakeyBackend(context: android.content.Context, rsaPublicKey: String) : BillingBackend {
override val store = StoreId.BAZAAR
private val payment = BazaarPayment(context, BazaarConfig(localSecurityCheck = BazaarSecurityCheck.Enable(rsaPublicKey)))
private var connection: BazaarConnection? = null
override suspend fun connect(): Boolean = suspendCancellableCoroutine { cont ->
connection = payment.connect {
connectionSucceed { if (cont.isActive) cont.resume(true) }
connectionFailed { if (cont.isActive) cont.resume(false) }
disconnected { if (cont.isActive) cont.resume(false) }
}
}
override suspend fun skuDetails(type: ProductType, skus: List<String>): List<SkuDetails> =
suspendCancellableCoroutine { cont ->
val callback: ir.cafebazaar.poolakey.callback.GetSkuDetailsCallback.() -> Unit = {
getSkuDetailsSucceed { list ->
cont.resume(list.map {
// Bazaar returns a formatted price string; Rials are unknown here
SkuDetails(it.sku, if (type == ProductType.SUBS) "subs" else "inapp",
it.title, it.description, priceRials = 0L, priceText = it.price, period = null)
})
}
getSkuDetailsFailed { cont.resumeWithException(it) }
}
if (type == ProductType.SUBS) payment.getSubscriptionSkuDetails(skus, callback)
else payment.getInAppSkuDetails(skus, callback)
}
override suspend fun purchase(registry: ActivityResultRegistry, type: ProductType, request: PurchaseRequest): PurchaseInfo =
suspendCancellableCoroutine { cont ->
val r = BazaarPurchaseRequest(productId = request.productId, payload = request.payload)
val callback: ir.cafebazaar.poolakey.callback.PurchaseCallback.() -> Unit = {
purchaseSucceed { cont.resume(it.toBale()) }
purchaseCanceled { cont.resumeWithException(java.util.concurrent.CancellationException("canceled")) }
purchaseFailed { cont.resumeWithException(it) }
failedToBeginFlow { cont.resumeWithException(it) }
}
if (type == ProductType.SUBS) payment.subscribeProduct(registry, r, callback)
else payment.purchaseProduct(registry, r, callback)
}
override suspend fun purchases(type: ProductType): List<PurchaseInfo> = suspendCancellableCoroutine { cont ->
val callback: ir.cafebazaar.poolakey.callback.PurchaseQueryCallback.() -> Unit = {
querySucceed { list -> cont.resume(list.map { it.toBale() }) }
queryFailed { cont.resumeWithException(it) }
}
if (type == ProductType.SUBS) payment.getSubscribedProducts(callback) else payment.getPurchasedProducts(callback)
}
override suspend fun consume(purchaseToken: String) = suspendCancellableCoroutine<Unit> { cont ->
payment.consumeProduct(purchaseToken) {
consumeSucceed { cont.resume(Unit) }
consumeFailed { cont.resumeWithException(it) }
}
}
override suspend fun acknowledge(purchaseToken: String) = Unit // Bazaar has no acknowledge step
override fun disconnect() { connection?.disconnect() }
private fun BazaarPurchaseInfo.toBale() = PurchaseInfo(
orderId = orderId, purchaseToken = purchaseToken, payload = payload, packageName = packageName,
purchaseState = if (purchaseState == BazaarPurchaseState.REFUNDED) PurchaseState.REFUNDED else PurchaseState.PURCHASED,
purchaseTime = purchaseTime, productId = productId, originalJson = originalJson, dataSignature = dataSignature,
)
}
و در برنامه:
val backend = StoreRouter(
context,
baleStore = BaleStoreBackend(BaleStorePayment(context, PaymentConfiguration(SecurityCheck.Enable(BALE_PEM)))),
bazaar = PoolakeyBackend(context, BAZAAR_RSA_KEY),
).select() // installed from Bazaar → Bazaar; from Bale Store, unknown or anything else → Bale Store
lifecycleScope.launch {
if (!backend.connect()) return@launch
val p = backend.purchase(activityResultRegistry, ProductType.INAPP, PurchaseRequest("coins_100", "order-42"))
api.verify(store = backend.store, token = p.purchaseToken, sku = p.productId) // your server picks the right store API
backend.consume(p.purchaseToken)
}
نکتهها:
- نام کلاسهای کالبک Poolakey (
GetSkuDetailsCallback،PurchaseCallback،PurchaseQueryCallback) و پکیجها را با نسخهٔ Poolakey خود تطبیق دهید. - یک بیلد برای هر دو فروشگاه: چون بلهاستور APK را دوباره امضا نمیکند، همان APK امضاشده با کلید شما در هر دو فروشگاه منتشر میشود و کاربری که از بازار نصب کرده، میتواند از بلهاستور بهروزرسانی بگیرد (با یک بار تأیید). پس از آن، منبع نصب «بلهاستور» میشود و
StoreRouterهم پرداخت بلهاستور را انتخاب میکند؛ خریدهای غیرمصرفی قبلی کاربر در بازار را باید سرور خودتان (با شناسهٔ حساب کاربر در برنامه) نگه دارد. - سرور شما باید بداند هر خرید از کدام فروشگاه آمده تا با API همان فروشگاه بررسی کند.
چکلیست مهاجرت
- وابستگی و
<queries>جایگزین یا اضافه شد. -
Payment←BaleStorePayment؛ کلید RSA ← کلید PEM از کنسول بلهاستور. - محصولات با همان شناسهها در کنسول بلهاستور تعریف شدند (ورود گروهی CSV).
- برای غیرمصرفیها و اشتراکها
acknowledgeاضافه شد. - قیمت از
priceTextنمایش داده میشود. - بررسی سمت سرور به S2S بلهاستور (یا JWS ES256) منتقل شد.
- Webhook برای بازپرداخت و رویدادهای اشتراک ثبت شد.
- با آزمایشگر مجوز در سندباکس آزمایش شد.