> 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/ji-cheng-zhi-nan/ji-cheng-ru-men-zhi-nan.md).

# 集成入门指南

### 步骤一：在侧边菜单中点击“集成（Integration）”标签，然后选择“Distribution”。

<figure><img src="/files/vaZZHIrcnAiQEu1IR9Xi" alt="" width="240"><figcaption></figcaption></figure>

### 步骤二：点击“提交新的 API 请求

<figure><img src="/files/ga9YLartarg6OPFWGQJk" alt=""><figcaption></figcaption></figure>

## 步骤三：提交标题相关信息

从下拉菜单中选择标题 (Title)

<figure><img src="/files/tp6hxHf4WjF5LPnbEoK0" alt=""><figcaption><p>API 凭证提交表单</p></figcaption></figure>

### 步骤四：提交 API 凭证

填写 API 凭证表单中的所有必填字段并提交。

1. [Validation API 请求](/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codashop-yu-distrubution/ji-cheng-zhi-nan/validation-api-qing-qiu.md)
2. [Top-Up API 请求](/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codashop-yu-distrubution/ji-cheng-zhi-nan/topup-api-qing-qiu.md)
3. **Secret Key（密钥）**：由合作伙伴自行设定并与 Coda 共享。建议密钥长度不超过 64 个字符。
4. **Service Provider（服务提供商）**：当不同应用使用同一 API 时，可使用服务提供商进行区分。如未使用，默认值应为“Coda”。
5. **Merchant Transaction ID（商户订单 ID）**：验证响应中合作伙伴的订单 ID。（可选）
6. **角色 ID （Role ID）**：此用户账户的角色 ID/角色标识符。若 Validate API 响应中包含 roleList，则此项为必填。
7. [Serverlist API](/https-coda-payments.gitbook.io-zhong-wen-coda-private-technical-documentation/codashop-yu-distrubution/ji-cheng-zhi-nan/huo-qu-fu-wu-qi-lie-biao-qing-qiu-ke-xuan.md) (可选)

<figure><img src="/files/ztx7hIHY2Z3drIw8MTM5" alt=""><figcaption></figcaption></figure>

### 步骤 5：提交状态为“审核中”（Under Review） <a href="#step-5-submission-under-review" id="step-5-submission-under-review"></a>

一旦您成功填写所有相关字段并提交 API 凭证数据，提交内容将进入“<mark style="color:orange;">**Under Review**</mark>”状态。<br>

<figure><img src="/files/jHXnqGhqzMRuCtiuGLjI" alt=""><figcaption><p>API 提交状态：“审核中”</p></figcaption></figure>

### 步骤六：提交被拒绝

如果提交被拒绝，状态将变为“<mark style="color:red;">**Rejected**</mark>”，您需要进行适当的更改后重新提交。

<figure><img src="/files/IKcvO4u4Jgob3k9V63Sc" alt=""><figcaption><p>API 提交状态：“已拒绝”</p></figcaption></figure>

进行所有必要的修正/编辑，并重新提交 API 以供验证。

<figure><img src="/files/zuwQ8hQC99YASfvret4B" alt=""><figcaption></figcaption></figure>

### 步骤七：API 提交已验证

一旦 Coda 团队核实所有细节，提交的状态将更改为 “<mark style="color:green;">**Verified**</mark>”。

<figure><img src="/files/iO6c6YE8FLSk6z4rhBDc" alt=""><figcaption></figcaption></figure>


---

# 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/ji-cheng-zhi-nan/ji-cheng-ru-men-zhi-nan.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.