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 برای بازپرداخت و رویدادهای اشتراک ثبت شد.
  • با آزمایشگر مجوز در سندباکس آزمایش شد.