> 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/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codashop-yu-distrubution/codashop-fu-lu/codashop-ji-cheng-chang-jian-wen-ti.md).

# Codashop 集成常见问题

## **缩写**

* **SKUs**: 库存量单位，亦即在 API 请求中发送的唯一商品/产品标识符。
* **Product Name**：将在 Codashop 上向最终用户展示的产品名称
* **FX**：外汇
* **TxnID**：交易 ID

## 常见问题

### **1.1 Codashop 或分销的集成流程需要多长时间？**

集成流程高度依赖于 Coda 收到合作伙伴 API 网址（验证和充值网址）、资产、SKU 及定价详情的日期。在从发布者门户接收提交后，Coda 大约需要 1 周时间进行产品页面的审核与测试。对于定制化集成，根据 API 的复杂程度，可能需要更长时间。您可以参考我们的 Codashop 指南了解详细步骤。

### **1.2 如何确保在 Codashop 上获得良好性能的一些最佳实践是什么？**

Codashop 上的性能可能差异很大，但以下是一些最佳实践：

* 与传统应用商店相比保持价格一致
* 购物额外奖励
* 来自贵方的营销支持
* 特殊库存单位如：\
  战斗通行证\
  周卡\
  月卡\
  特惠礼包（限购）\
  对于这些 SKU，在 Codashop 上的实现是直接的。逻辑检查将在您这边进行（Coda 无法访问游戏数据）。在验证过程中，如果用户 ID 不符合购买资格，您需要向我们发送错误信息，我们将向最终用户显示相应的错误消息。

## **Codashop 功能**

### **2.1 Codashop 的“赠送”功能如何运作？是否需要我们进行任何开发工作？** <a href="#id-2.1-how-does-codashop-gifting-work-does-it-require-any-development-effort-from-us" id="id-2.1-how-does-codashop-gifting-work-does-it-require-any-development-effort-from-us"></a>

不需要。这是 Codashop 上的一项功能。当用户输入好友的用户 ID 并进行常规充值时，系统会要求提供额外信息，如赠送者姓名和礼物留言，随后一封包含礼物留言的电子邮件将发送至接收者的邮箱。\
无需额外的集成工作。

### **2.2 Codashop 返现如何运作，是否需要我们额外的工作？这会影响到结算吗？**

玩家将根据所使用的支付渠道获得返现。对于折扣，玩家将支付折扣后的价格。这些费用由支付渠道或 Coda 承担，不会影响结算。API 中的价格保持不变。\
无需额外的开发工作。

### **2.3 如何在 Codashop 上开展促销活动？我应该联系谁，具体如何操作？**

如需促销活动，请联系 Coda 的业务发展或营销团队获取详细信息。\
关于价格相关促销：请向 Coda 提供更新的价格清单（如有 SKU 变更），以及促销周期。Coda 将协助配置特定时间段内的促销价格。

关于赠品发放促销：请向 Coda 提供一段描述，我们将展示在产品页面的左侧。请提前一周左右提供内容，以便我们完成必要的翻译工作。

## **Codashop 集成模板与价格表**

### **3.1 我们需要在价格表中填写哪些内容？需要注意哪些部分？** <a href="#id-3.1-what-do-we-need-to-fill-in-the-price-table-what-part-should-we-pay-attention-to" id="id-3.1-what-do-we-need-to-fill-in-the-price-table-what-part-should-we-pay-attention-to"></a>

以下是批量上传 SKU 和价格的方法 - [批量上传库存（SKU）](/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codashop-yu-distrubution/pi-liang-shang-chuan-ku-cun-sku.md)

关于价格表，需要填写的内容包括：\
产品名称、产品/SKU ID、价格（默认美元价格，也可提交当地国家价格）。更多详情请查看此部分 > [Coda 定价模板](/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/coda-hou-tai/coda-hou-tai-fu-lu/coda-ding-jia-mu-ban.md)

> 请注意：
>
> * 部分国家将使用美元而非当地货币，例如柬埔寨。
> * 当地货币价格并非动态调整，如需因汇率波动进行任何变更，请相应更新汇率或在[后台](https://portal.coda.co/)中编辑价格。

若您的应用/标题已在 Google Play 上线，仅需 5 分钟即可轻松将 Coda 与您的 Google 账户集成。为此，我们提供了详细的逐步指南 [1. Google Play 集成](/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codashop-yu-distrubution/cong-google-play-pi-liang-dao-ru-ku-cun-sku/1.-google-play-ji-cheng.md)。遵循这些指引，您可直接从 Google Play 账户向 Coda 共享 SKU 数据，操作简便。

### **3.2 Coda 能否协助我们将美元价格转换为当地货币价格？如可行，将适用何种汇率？**

是的。如果您仅提供默认美元价格，Coda 会将美元价格转换为每个国家/地区的本地货币。在 Codashop 上发布之前，您可以在[后台](https://portal.coda.co/)查看和编辑所有本地价格。

### **3.3 用户如何知道 Codashop 的价格比传统应用商店更优惠？** <a href="#id-3.3-how-would-users-know-that-codashop-prices-are-better-compared-to-traditional-app-stores" id="id-3.3-how-would-users-know-that-codashop-prices-are-better-compared-to-traditional-app-stores"></a>

Coda 可以利用划线价格功能让用户了解更低的价格。我们将以划线方式显示原价，并向最终用户展示价值主张。

### **3.4 Google Play 集成如何运作？**

Google Play 集成有助于直接从 Google Play 控制台获取价格和 SKU 数据。 \
如果您是首次与 Coda 签约的新发布商，此集成能让您在不到 5 分钟内将您的商品上架至 60 多个国家。

&#x20;请参考指南: [1. Google Play 集成](/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codashop-yu-distrubution/cong-google-play-pi-liang-dao-ru-ku-cun-sku/1.-google-play-ji-cheng.md)

## **Codashop 第三方履约 API**

### **4.1 应由谁提供 secretkey？** <a href="#id-4.1-who-should-provide-the-secretkey" id="id-4.1-who-should-provide-the-secretkey"></a>

您需要向 Coda 提供 secretkey。建议 secretkey 的长度不要超过 64 个字符。&#x20;

### **4.2 服务提供商的价值是什么，有哪些使用场景？** <a href="#id-4.2-what-is-the-value-of-a-service-provider-and-what-are-some-use-cases" id="id-4.2-what-is-the-value-of-a-service-provider-and-what-are-some-use-cases"></a>

服务提供商可用于多个应用共享同一 API 的情况。如未使用，默认值应为“Coda”

### **4.3 Coda 的交易 TPS 上限是多少？** <a href="#id-4.3-what-is-codas-transaction-tps-cap" id="id-4.3-what-is-codas-transaction-tps-cap"></a>

没有交易上限，Coda 将根据不同需求扩展我们的系统。

### **4.4 当 Coda 网站处于维护期或服务器宕机，或网站运行中出现任何代码错误时，我们是否有实时监控仪表板？** <a href="#id-4.4-when-the-coda-website-is-in-a-maintenance-period-or-the-server-is-down-or-has-any-code-error" id="id-4.4-when-the-coda-website-is-in-a-maintenance-period-or-the-server-is-down-or-has-any-code-error"></a>

不是的，Coda 拥有一套内部监控系统，供我们的技术支持团队使用。

### **4.5 在验证和充值请求中，TxnID（支付交易 ID）和 OrderID（Codashop 订单 ID）的值是否不同？**

是的，我们会在[验证](/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codashop-yu-distrubution/ji-cheng-zhi-nan/validation-api-qing-qiu.md)和[充值](/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codashop-yu-distrubution/ji-cheng-zhi-nan/topup-api-qing-qiu.md)请求调用时发送不同的值。如果您需要关联这两个调用，请使用可选的 merchantTransactionId。

### **4.6 交易 ID 与订单 ID 之间有何区别？** <a href="#id-4.6-what-are-the-differences-between-transaction-id-and-order-id" id="id-4.6-what-are-the-differences-between-transaction-id-and-order-id"></a>

交易 ID 是支付交易 ID，而订单 ID 是 Codashop 订单 ID。通常，我们建议在您的系统中使用/保存交易 ID 作为参考点。

### 4.7 测试日志中有两次充值调用，分别为\[首次充值]和\[第二次充值]。 请帮忙解释重新处理充值请求调用（回调）的流程和机制。 <a href="#id-4.7-there-are-two-top-up-calls-to-first-time-top-up-and-second-time-top-up-in-the-test-log.-pleas" id="id-4.7-there-are-two-top-up-calls-to-first-time-top-up-and-second-time-top-up-in-the-test-log.-pleas"></a>

这是 Coda 进行的负面案例测试的一部分，用于验证充值接口的幂等性。目的是确保在使用相同 TxnID 调用充值请求时，不应多次发放物品。对于后续的充值调用，不应再次发放物品。

### **4.8 Coda 如何实现地理围栏？** <a href="#id-4.8-how-does-coda-do-geo-fencing" id="id-4.8-how-does-coda-do-geo-fencing"></a>

对于地理围栏功能，API 字段中有一个额外参数“accountRegion”。您可以通过此参数返回用户的国家信息，若用户国家信息与产品页面的国家不符，Coda 将允许/阻止用户进行充值。\
国家/地区代码应为符合 ISO3166 标准的双字符代码\
(<https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes>)

例如：

```java
{
"jsonrpc": "2.0",
"id": "6496922564067972630",
"result": {
"username": "Barbara",
"accountRegion": "ID"
}
}
```

如果您希望在您那边验证国家信息，我们将在验证请求中将产品页面的国家作为“purchaseOrigin”发送。

### **4.9 当 API 中发送错误代码时，最终用户将看到什么显示？** <a href="#id-4.9-what-will-be-displayed-to-the-end-user-when-an-error-code-is-sent-in-the-api" id="id-4.9-what-will-be-displayed-to-the-end-user-when-an-error-code-is-sent-in-the-api"></a>

当 API 中发送错误代码时，相应的错误信息将显示给终端用户。您可以参考我们 API 文档中列出的错误代码。\
\*显示的错误信息会随时间更新，但其含义不会改变。

### **4.10 Coda 是否支持对特定 SKU 应用购买限制，例如仅允许用户每月购买一次？**

Coda 在 Codashop 上没有购买限制功能。如果用户不符合购买该物品的资格，我们要求您根据 Coda 的 API 文档发送一个错误代码。

我们没有此功能的原因是 Coda 没有关于在其他平台（如 iOS/Android）上进行的任何购买的数据。

### **4.11 Coda 是否支持在 API 请求中发送美元价格？** <a href="#id-4.11-does-coda-support-sending-usd-prices-in-the-api-requests" id="id-4.11-does-coda-support-sending-usd-prices-in-the-api-requests"></a>

不，我们将根据产品页面上的货币来包含货币。

### **4.12 为什么在验证和充值调用中 TxnID 和 OrderID 的值不同？** <a href="#id-4.12-why-are-the-values-of-txnid-and-orderid-different-in-validate-and-top-up-calls" id="id-4.12-why-are-the-values-of-txnid-and-orderid-different-in-validate-and-top-up-calls"></a>

当调用验证和充值操作时，TxnID 和 OrderID 将会不同。如果您希望将验证和充值调用关联在一起，可以利用可选字段“merchantTransactionId”。

## **Codashop QA 与上线**

### **5.1 我们能否同时在全球范围内上线所有可用的 Codashop 国家？** <a href="#id-5.1-can-we-launch-all-the-available-codashop-countries-globally-at-the-same-time" id="id-5.1-can-we-launch-all-the-available-codashop-countries-globally-at-the-same-time"></a>

对于全球发布，我们将同步在全球范围内推出。但请同时告知优先级，以便在必要时分批发布。

### **5.2 Coda 是否有可能支持测试 Codashop 上列出的所有面额？是否有任何支付凭证可以与我们共享用于测试？** <a href="#id-5.2-is-it-possible-for-coda-to-support-testing-all-denominations-listed-on-codashop-are-there-any" id="id-5.2-is-it-possible-for-coda-to-support-testing-all-denominations-listed-on-codashop-are-there-any"></a>

Coda 将仅在 Codashop 上测试最低面额。对于其他面额，Coda QA 会尝试发起验证调用以确保没有问题。这是因为我们正在验证与 Codashop 的集成，而非与支付渠道的集成。这些支付渠道已在 Codashop 上激活，将始终有效。

*支付凭证无法与您共享，因为这些均为 Coda 所有的生产账户。*

### **5.3 Coda 用于预发布测试的资金是否会在我们的结算中被考虑进去？** <a href="#id-5.3-will-the-money-used-for-pre-launch-testing-by-coda-be-taken-into-account-in-our-settlement" id="id-5.3-will-the-money-used-for-pre-launch-testing-by-coda-be-taken-into-account-in-our-settlement"></a>

是的，这些资金将计入您的结算中，因为我们使用实际资金在生产环境中进行测试。

## **Codashop 运营**

### **6.1 如果我们希望对当前的 SKU 进行一些更改（例如：SKU 价格变更或添加新的 SKU 等），应提前多少天通知您？**

如果您已在发布者门户上传了价格和 SKU 数据，您可以直接在[后台](https://portal.coda.co/)上编辑价格。提交价格后，状态将变为‘审核中’，我们的内部定价团队将审核新价格，并在新价格不符合我们的价格规定时与您协调。此外，我们还会让 QA 团队进行审核，必要时进行测试，之后才能在 Codashop 上推出新价格/SKU。此过程大约需要 1-2 天。

如有必要，若变更不符合我们的定价惯例，Coda 会联系您讨论这些更改。为确保我们的运营团队有足够时间准备所需的变更，请注意，通常我们可能需要您提前至少 3 天在门户上完成价格编辑或通知我们。

### **6.2 Codashop 的退款政策是什么？如果我们收到用户的退款请求，应向 Coda 提供什么？**

通常情况下，Coda 不会向用户提供退款，具体需遵守不同国家的法规。这一点也在我们与用户的服务条款中有所提及。 不过，Coda 可能会根据具体情况酌情处理用户的退款请求。以下是一些例子：

1. 用户已完成支付但未收到所购商品。经与您核实后，无法向用户发放所购商品。Coda 将为用户处理退款。
2. 用户已完成支付，但 Coda 系统存在问题。Coda 将为用户处理退款。

### **6.3 如果应用进行维护，我该怎么办？** <a href="#id-6.3-what-should-i-do-if-there-is-maintenance-for-the-app" id="id-6.3-what-should-i-do-if-there-is-maintenance-for-the-app"></a>

这取决于您系统的逻辑。在维护期间，如果用户仍被允许充值并能正常收到物品，则无需在维护期间停用相关页面。

然而，如果用户在维护期间无法收到购买的物品。请提前 3 天通知 Coda 任何计划中的维护，以便我们安排页面在维护期间禁用。


---

# 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/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codashop-yu-distrubution/codashop-fu-lu/codashop-ji-cheng-chang-jian-wen-ti.md?ask=<question>&goal=<endgoal>
```

`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.