# FAQ ## SDK Issuance & Environment Setup
Q. When will the SDK be issued? A. The SDK will be issued within **3 business days** from the date of submitting the SDK T\&C. \ The `clientId` and `clientSecret` will be sent to your registered email.\ [Join Us >](https://docs.unifi.me/join-us-1)
Q. Do we need to develop all three versions (MINI App, LINE Login LIFF, Web)? A. No, you do not need to develop all three versions.\ Depending on your **Unifi Apps service strategy**, you may choose **one of the onboarding combinations** listed below. **Note:** The LINE MINI App can only be onboarded by a Japanese corporation or a sole proprietor residing in Japan, and it may only provide service to users in Japan. Available Version Combinations * LINE MINI App & LINE Login LIFF & Web * LINE MINI App & Web * LINE Login LIFF & Web * LINE MINI App or Web (Single Type)
Q. Do we need to configure chainId for the SDK? A. Yes. The `chainId` is used to distinguish between the testnet and mainnet environments.\ By default, it is set to testnet(`chainId: 1001`).\ During development, please use the testnet to test wallet integration and payment flows.\ For real payment testing or official launch, you must switch to the mainnet(`chainId: 8217`).
Q. Where can I get updates about SDK version changes? A. SDK version updates are announced through the official Telegram channel.\ 📢 [Join the official Telegram channel](https://t.me/+Fq6bbac7NLhmNGJl)\ Once you join, you’ll receive the latest updates and announcements related to the SDK.
Q. Can I integrate the Unifi Apps SDK with Unity or Cocos engine? A. Yes, you can.\ By porting your Unity or Cocos project to WebGL, you can integrate it as a web application using the Unifi Apps SDK.\ For detailed instructions, please refer to the integration guide.\ [Unifi Apps Demo >](https://docs.dappportal.io/unifi-apps-demo)
Q. Do you provide sample code? A. Sample code is provided in the following document. * Sample code by method: * Full integration sample code:
## Wallet Provider
Q. Why does an “Invalid Origin” error occur and wallet connection fail? A. The SDK only works properly on domains registered in the whitelist.\ Please share your test domain via the Tech Support Channel or email, and we will assist you in registering it to the domain whitelist.
Q. Why is the wallet connection window not opening? A. If `DappPortalSDK.init()` is repeatedly called on every request in the Web/LINE version, it may cause malfunction. Therefore, we strongly recommend calling `DappPortalSDK.init()` only once during app startup and managing it as a singleton instance.\ In addition, for the LINE version, make sure to call `DappPortalSDK.init()` **after** `liff.init()` has been successfully completed.
Q. Why does OKX Wallet fail to connect or require re-entry to the Unifi Apps on certain devices when using kaia_requestAccounts and personalSign? A. This issue is typically caused by timing conflicts during the signature step after wallet connection. To ensure a more stable experience, we recommend using `kaia_connectAndSign` instead.
Q. How can I persist the Wallet Connect session when re-entering or refreshing the Unifi Apps after wallet connection? A. First, call `kaia_accounts` to check if there is an existing connected wallet. * If a connected wallet is found, you can use that wallet information directly. * If no connected wallet is found, proceed with wallet reconnection using `kaia_requestAccounts` or `kaia_connectAndSign`.
Q. Why is it necessary to implement disconnectWallet()? A. You need to implement `disconnectWallet()` in the following cases: * When the user has lost the password for the previously connected wallet, * When the wallet connected via [wallet.dappportal.io](https://wallet.dappportal.io) differs from the one connected in the Unifi Apps, * Or when the user wants to switch to a different wallet. In such cases, access to the Unifi Apps may be restricted. Implementing `disconnectWallet()` allows users to disconnect the current wallet and connect a new one.
Q. Can I provide external wallets such as MetaMask instead of using the Unifi Apps SDK wallet integration? A. No, it is not allowed. \ To launch a Unifi Apps, you must use the wallet integration method provided by the Unifi Apps SDK. External wallet integrations such as MetaMask are not supported.
Q. How are user accounts identified? A. In all three versions — **LINE MINI App, LINE Login LIFF, and Web** — user accounts should be distinguished by their wallet address.\ However, in the **LINE MINI App** and **LINE Login LIFF** versions, users can enter the Unifi Apps without connecting a wallet.\ In such cases, you should temporarily create an account based on the user's LINE ID upon first entry, and map the Wallet Address to that account once the wallet connection is completed.
Q. Should accounts be compatible across LINE MINI App, LINE Login LIFF, and Web versions A. Yes.\ All three versions — **LINE MINI App, LINE Login LIFF, and Web** — support wallet types such as LINE Wallet, OKX Wallet, and Bitget Wallet.\ If a user logs in with the same wallet address in multiple versions, we recommend maintaining account compatibility to ensure a seamless user experience and consistent login and asset data across all environments.
Q. Can I retrieve LINE ID or profile info via LINE Login in the Web version? A. No, the Web version does not support LINE Login. If implemented, it must be removed.\ The Web version is intended for non-LINE users, including PC users, and should not include features that require LINE authentication.\ LINE-related features should be provided only in the LINE MINI App and LINE Login LIFF versions.
Q. Is there a way to distinguish between LINE MINI App, LINE Login LIFF, and Web environments? A. Yes You can use `liff.isInClient()` to detect whether the user is inside a LINE environment. * **If `liff.isInClient()` returns true:**\ The user is in a **LINE environment** — either **LINE MINI App** or **LINE Login LIFF**.\ In this case, you must call: 1. `liff.init()` 2. Then `DappPortalSDK.init()` * **If `liff.isInClient()` returns false:**\ The user is in a **Web browser environment**.\ In this case, only call: * `DappPortalSDK.init()`
Q. Why is Bitget Wallet not shown in the wallet selection list? A. To display Bitget Wallet in the wallet list, you must register a `projectId`.\ Please follow the [guide documentation](https://docs.unifi.me/unifi-apps-sdk/wallet-provider/domain-verification-via-reown) to create a `projectId`, then submit it through the Tech Support channel for registration.
Q. What causes unknown errors when signing a transaction with a connected wallet? A. This may occur if the Wallet Address requesting the signature differs from the actual signing Wallet Address.\ Please check that the Wallet Address connected via: * Web: * LIFF: is the same Wallet Address being used for signing.
## Payment Provider
Q. Do we need to support LINE IAP, Crypto, and Stripe payments? A. The supported payment methods vary depending on the onboarding version. * **LINE MINI App:** Only **LINE IAP** is supported, as it must comply with App Store policies. * **LINE Login LIFF / Web:** Both **Crypto** and **Stripe** payments are supported. However, if adjustments are required due to your service structure or policy, you may modify the supported payment methods after consulting with the BD team or the Tech Support channel.
Q. Why does an error occur during payment testing? A. Please first check whether the parameters you provided match the [example request code](https://docs.unifi.me/unifi-apps-sdk/payment-provider#id-1.-triggering-createpayment-api-from-mini-dapp) in the documentation.\ Even if the code seems correct, errors may still occur during testing.\ If the issue persists, please contact the Tech Support channel for assistance.
Q. What are lockUrl and unlockUrl? A. These are useful features when selling products with limited stock.\ They temporarily “lock” the quantity while a user is attempting to purchase the product, preventing other users from buying the same item simultaneously.\ This mechanism helps avoid duplicate purchases during the payment process and enables more accurate inventory management. ⚠️ Note: If the product has **no quantity limit**, set both `lockUrl` and `unlockUrl` to `null`.
Q. Crypto payment works, but why does Stripe payment fail? (An error code 500 is returned when startPayment() is called) A. This usually happens when the `imageUrl` parameter is invalid or not accessible from outside.\ Please make sure the product image URL is valid and publicly accessible.
Q. Why isn’t the webhook being received? A. The `paymentStatusChangeCallbackUrl` must be accessible over the public network.\ You should either: * Make the URL publicly accessible, or * Whitelist the Unifi server IPs. Additionally, the callback **must return an HTTP 200 OK response** to ensure successful webhook delivery.
Q. Why does createPayment succeed but startPayment return an error? (An error code 400 is returned when startPayment() is called) A. This indicates that something went wrong during the `startPayment` phase.\ Please check the `paymentId` and the returned error code used in the test.\ For root cause analysis and further assistance, share the details via the Tech Support channel.
Q. What causes an "Internal JSON-RPC error" or a blank payment screen to appear? A. This issue typically occurs when the configured `chainId` and `testMode` values do not match. * **Testnet:** `chainId: 1001`, `testMode: true` * **Mainnet:** `chainId: 8217`, `testMode: false` Please ensure that these values are correctly configured according to the environment and try testing again.
Q. How can I perform real payment testing? A. Real payment testing is only available **after your settlement information has been updated**.\ This update is completed **after your team submits the Due Diligence (DD) form**. Once your launch schedule is confirmed, the Kaia Wave team will request your DD submission.\ In general, real payment testing becomes available **three business days before the official launch**. If you need to test earlier, please contact the Tech Support channel to request an exception. ⚠️ Note: Real payment tests **are non-refundable**, so please proceed with caution.
Q. Is there a minimum payment amount for products? A. Yes, there is a minimum payment threshold: * **USD**: Minimum of **$0.5** * **KAIA**: Minimum of **0.01 KAIA** For more details, please refer to the [guide documentation](https://docs.unifi.me/unifi-apps-sdk/payment-provider/policy/payment#id-2-supported-currencies-and-minimum-charge-limits).
Q. Is it mandatory to apply exchange rates for Crypto payment products? A. Yes, you **must provide a converted price based on the current market rate**.\ This ensures transparency for users and accuracy in payment processing. While the SDK **does not provide exchange rate conversion**, you can use external services such as: * CoinMarketCap(CMC) * Kaiascan Open API to fetch real-time price data and apply it accordingly.
Q. Why is it necessary to provide a payment history feature? A. Users must be able to view their own payment history, which: * Increases user trust * Helps customer support(CS) by referencing `paymentId` and other data The SDK provides an `openPaymentHistory()` function, so please implement this in: * The **In-App Store page**, or * Any other screen that users frequently visit.
## LINE Integration
Q. How do I create a LINE Developers account? A. Developers must create a LINE Business ID (Provider) using their **personal LINE account or email address**. * Shared or team accounts are **not supported** in Unifi. If you're unable to create the account, please contact the **Tech Support channel** for assistance.
Q. What is the difference between LINE MINI App and LINE Login LIFF? A. * **LINE MINI App** * Only Japanese corporations or sole proprietors can onboard. * The service can be provided **only to LINE users in Japan**. * Must comply with **App Store policies**. * **LINE Login LIFF** * No onboarding restrictions. * Can serve **global LINE users**. * Not subject to App Store constraints (Web-based). Key Differences | Item | LINE MINI App | LINE Login LIFF | | --------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | Onboarding Requirements | Only for companies with a Japanese Corporate Number or individual business owners residing in Japan | - | | App Store Policy Compliance | Required | Not applicable | | Target Users | Japan LINE users | Global LINE users | | LIFF SDK Usage | Yes | Yes | | Unifi Apps SDK Usage | | |
Q. Why am I getting a 403 error when accessing the LINE Login LIFF version? A. LIFF URLs are **inaccessible** if the LINE Login channel is not in **Published** status.\ Please switch to **Published** mode when submitting your Demo or performing tests.
Q. Is it okay to publish the LINE Login LIFF version before launch? A. Yes. As long as you **do not share the LINE Login LIFF URL or test domain externally**, general users won’t have access. Publishing early can help streamline Demo submission and testing.\ If you **must test without publishing**, you can **add the reviewer’s email as an admin** to the LINE Login channel.
## Web3 Provider
Q. What causes the error: “Sending transaction was failed after ~ try, network is busy”? A. This is a **temporary error** caused by **high network traffic**.\ If this occurs, simply retry the transaction — it should eventually succeed.
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.unifi.me/join-us-1/faq.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.