> For the complete documentation index, see [llms.txt](https://docs.coda.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coda.co/codashop-and-distribution/codashop-appendix/codashop-integration-faqs.md). # Codashop Integration FAQs ## **Abbreviations** * SKUs: Stock-keeping unit, or also identified as the unique item/ product ID sent in the API request. * Product Name: Name of product that will be displayed to end-user on Codashop * FX: Foreign Exchange * TxnID: Transaction ID ## **General Questions** ### **1.1 How long is the integration process for Codashop or Distribution?** The integration process is highly dependent on the date Coda receives the Partner API urls (Validate and Top-up urls), Assets, SKUs and pricing details. After receiving the submissions from the [Publisher Portal,](https://bit.ly/4aNqHRf) it takes Coda around 1 week for the review and testing of product pages. For customized integrations, this could take longer, depending on the complexity of the API. You can refer to our Codashop Guide for the detailed steps. ### **1.2 What are some best practices to ensure good performance on Codashop?** Performance on Codashop can vary greatly, however, some of these best practices include: 1. Price parity when compared to traditional app stores 2. Additional bonuses on purchases 3. Marketing support from your end 4. Special SKUs such as :\ Battle Passes\ Weekly Passes\ Monthly Passes\ Special Bundles (limited purchases)\ For these SKUs, implementation on Codashop is straight-forward. The logic check will happen on your side (Coda does not have access to game data). You will need to send us an error message during validation if the userID is not eligible for such purchases, and we will display the respective error messages to end-users. ## **Codashop Functionalities** ### **2.1 How does Codashop Cashback work, does it require any additional work by us? Are there any changes in settlement due to this?** Players would receive cashback based on the payment channel used. For a discount, the player would pay a discounted price. These are funded by payment channels or Coda and will not affect settlement. Prices in the API will be the same.\ No additional development work is needed. ### **2.2 How do we run promotions on Codashop? Who do I reach out to and how will it work?** For promotions, please connect with Coda’s BD or marketing team for in-depth details.\ For pricing-related promotion: Please provide Coda with the updated set of pricing (SKUs if there are any changes), along with the promotion period. Coda will help to configure the promotion pricing for the specific period.\ \ For bonus item issuance promotion: Please provide Coda a description that we could include on the left side of the product page. Do provide us with the content a week or so before so we can get the necessary translations done. ## **Codashop Integration Template & Price Table** ### **3.1 What do we need to fill in the price table? What part should we pay attention to?** Here's how you can Bulk upload the SKUs and Prices - [Bulk Upload Products](/codashop-and-distribution/bulk-upload-inventory-skus.md) For the price table, here are the things that need to be filled up:\ Product Name, Product/SKU id, Prices (Default USD Price. You can also submit local country prices). Check out this section for more details > [Coda's Pricing Template](/coda-portal/coda-portal-appendix/codas-pricing-template.md) {% hint style="info" %} Take note that some countries will use USD instead of local currency. i.e. Cambodia {% endhint %} {% hint style="info" %} Take note that local currency prices are not dynamic, if there are any changes required due to FX fluctuations, please Update the FX or edit Prices on the [Publisher Portal](https://bit.ly/4aNqHRf) accordingly. {% endhint %} If your title/app is already live on Google Play, you can easily integrate Coda with your Google account in just 5 minutes. To assist you in this process, we have provided a detailed step-by-step guide [Google Play Integration](/codashop-and-distribution/bulk-import-inventory-skus-from-google-play/1.-google-play-integration.md). By following these instructions, you can effortlessly share SKU data directly from your Google Play account to Coda. ### **3.2 Can Coda help us convert USD prices to prices in local currency? What exchange rate will be applied if it’s possible?** Yes. If you provide just the Default USD price, Coda will convert the USD price to local currencies for each country. You will be able to see and edit all the local prices on the [Publisher Portal](https://bit.ly/4aNqHRf) before Publishing them on Codashop. ### **3.3 How would users know that Codashop prices are better compared to traditional app stores?** Coda can make use of Strikethrough pricing to let users know about the lower prices. We will show the original price with a strikethrough and show the value proposition to the end-user. ### **3.4 How does Google Play Integration work?** Google Play integration helps to fetch the Price and SKU data directly from the Google Play console.\ If you are a new Publisher signing up with Coda for the first time, this integration allows you to go live with all your listings across 60+ countries in less than < 5 minutes.\ \ Please refer to the complete guide here >> [Google Play Integration](/codashop-and-distribution/bulk-import-inventory-skus-from-google-play/1.-google-play-integration.md) ## **Codashop Third Party Fulfillment API** ### **4.1 Who should provide the secretkey?** You will need to provide the secretkey to Coda. It is recommended that the length of the secretkey not exceed 64 characters. ### **4.2 What is the value of a service provider, and what are some use cases?** Service providers can be used in cases where there are different apps using the same API. If not used, the default value used should be “Coda” ### **4.3 What is Coda’s transaction TPS cap?** There is no transaction cap, Coda will scale our system based on different needs. ### **4.4 When the Coda website is in a maintenance period or the server is down or has any code error while the website is running, do we have any website live monitoring dashboard?** No. Coda has a set of monitoring systems that are used internally, by our technical support team. ### **4.5 Are the values of TxnID (payment transaction ID) and OrderID (Codashop order ID different in the Validate and Top-up request?** Yes, we will send different values during the [Validation](/codashop-and-distribution/integration-guides/validation-api-request.md) and [Top Up](/codashop-and-distribution/integration-guides/top-up-api-request.md) request call. If you require to associate both calls, please use the optional merchantTransactionId. ### **4.6 What are the differences between Transaction ID and Order ID?** Transaction ID is the payment transaction ID, while Order ID is the Codashop order ID. Usually, we recommend using/ saving transaction ID as a point of reference in your system. ### **4.7 There are two top up calls to \[First Time Top Up] and \[Second Time Top Up] in the test log.** **Please help explain the process and callback mechanism of reprocessing the recharge request call (recallback).** This is part of a negative case testing done by Coda, to verify that the top up interface is idempotent. This is to ensure that when calling the top up request using the same TxnID, you should not issue items more than once. You should not issue items for the subsequent top up calls. ### **4.8 How does Coda do geo-fencing?** For geo-fencing, there is an additional parameter in the API field, “accountRegion”. You can return the user’s country information in this parameter and Coda will allow/prevent the user from recharging if the user’s country information does not match the country of the product page.\ The country/region code should be a two-character code that conforms to the ISO3166 standard () For example: ``` { "jsonrpc": "2.0", "id": "6496922564067972630", "result": { "username": "Barbara", "accountRegion": "ID" } } ``` If you wish to validate the country on your end, we will send the product page country as “purchaseOrigin” in the validation request. ### **4.9 What will be displayed to the end-user when an error code is sent in the API?** When an error code is sent in an API, the corresponding error message will be shown to end-users. You can refer to the error codes displayed in our API documentation.\ \*Displayed error messages will be updated overtime, however, the meaning of them will not change. ### **4.10 Does Coda support applying a purchase restriction on a certain SKU, such as only allowing users to purchase once a month?** Coda does not have a purchase restriction feature on Codashop. We require you to send an error code (Based on Coda’s API document) if the user is not eligible to purchase the item.\ \ The reason we do not have such a feature is that Coda does not have data regarding any purchases made on other platforms such as iOS/ Android. ### **4.11 Does Coda support sending USD prices in the API requests?** No, we will include the currency based on the currency on the product page. ### **4.12 Why are the values of TxnID and OrderID different in validate and top-up calls?** When Validate and Top Up are called, TxnID and OrderID will be different. If you wish to associate the validate and top-up call together, you can make use of the optional field “merchantTransactionId”. ## **Codashop QA & Launching** ### **5.1 Can we launch all the available Codashop countries globally at the same time?** For a global launch, we will launch them at the same time globally. However, do also inform us of the prioritization so we can launch in batches if necessary. ### **5.2 Is it possible for Coda to support testing all denominations listed on Codashop? Are there any payment credentials that can be shared with us for testing?** Coda will only test the lowest denomination on Codashop. For the other denominations, Coda QA will try to initiate a validate call to ensure that there is no issue. This is because we are trying to verify the integration with Codashop and not the integration with the Payment Channels. These payment channels are active on Codashop and will always work. *Payment credentials are not able to be shared with you as these are all production accounts owned by Coda.* ### **5.3 Will the money used for pre-launch testing by Coda be taken into account in our settlement?** Yes, these funds will be counted in your settlement because we use actual money for conducting tests on production. ## **Codashop Operations** ### **6.1 If we want to make some changes to the current SKUs(ex: SKU price change or adding new SKUs etc.), how many days should we notify you in advance?** If you have already uploaded the Prices and SKU data on the [Publisher Portal](https://portal.codapayments.com/signup), you can edit the prices on the Portal. Once you submit the Prices, the status will change to In-Review and our internal pricing team will review the new prices, and need to reconcile with you in case the new prices are not in line with our price regulation. Besides that, we will also have our QA team to review and sometimes conduct testing on it if needed before launching new prices/SKUs on Codashop. The lead time for this is around 1-2 days.\ \ If necessary, Coda will reach out to discuss these changes if it's not in line with our pricing practices. As we want to make sure our operation team has sufficient time to prepare for the required changes, please note that usually, we may need you to make the Price edits on Portal or inform us at least 3 days in advance. ### **6.2 What’s the refund policy for Codashop? What should we provide to Coda if we get a user’s refund request?** Generally, Coda does not provide refunds to users, subject to different countries' regulations. This is also mentioned in our Terms and Conditions to users.\ \ However, Coda might process a refund to the user on a case-by-case basis. Below are some examples: 1. The user made payment but did not receive the item purchase. Upon checking with you, they are unable to issue the item purchased to the user. Coda will process the refund for the user. 2. The user made the payment, but there is an issue with Coda’s system. Coda will process the refund for the user. ### **6.3 What should I do if there is maintenance for the app?** This depends on the logic of your system. During maintenance, if users are still allowed to recharge and will receive their items as normal, there is no need to deactivate the pages during maintenance. \ However, if users would not be able to receive their purchased items during maintenance. Please inform Coda 3 days ahead of any scheduled maintenance so we can arrange for the page to be disabled during the maintenance. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.coda.co/codashop-and-distribution/codashop-appendix/codashop-integration-faqs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.