> 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/codapay/codapay-ru-men-zhi-nan/codapay-jie-ru-liu-cheng-gai-lan.md).

# Codapay 接入流程概览

{% hint style="info" %}
**我们建议您在与Codapay API的对接时, 遵循此页列出的步骤。**
{% endhint %}

## 步骤1 : 接入文档查阅

这个过程将从商家查阅Coda提供对接文档开始进行, 商家可以选择接入**支付页面API**或**后端API**。

若您使用外部浏览器或 WebView接入**支付页面API**，请告知Coda的技术团队。我们建议使用外部浏览器以提高转化率。

对接期间的技术支持，请联系[codapay\_integration@codapayments.com](mailto:codpay_integration@codapayments.com)或技术聊天组。

## 步骤2: 沙盒测试

开始对接测试时，我们建议首先使用您的测试环境与Coda 的沙盒服务环境测试请求支付流程.

{% hint style="warning" %}
🚧 <mark style="color:orange;">**沙盒环境 注意事项**</mark>

* 不收取任何实际费用。
* 沙盒交易订单不会在Coda商户后台显示。
* 配置重定向和回调地址：\
  商家后台 -> Integration 集成 -> Security 安全性 -> Sandbox Configuration
* 部分渠道不支持沙盒测试。
* 部分支付方式需通过渠道供应商审核方可对接。
  {% endhint %}

在您对使用沙盒服务环境和 Coda 的沙盒服务环境的测试结果感到满意后，您可以请求在 Coda 的生产服务环境中激活。

请联系出版商BD，请求开通新支付渠道, 电子协议（E-Annex）会发送至商家邮箱和Coda商家后台，以进行电子审批。只有在商户审批电子附件后，才会激活相关的支付渠道。

## 步骤3: 商家沙盒与Coda正式环境对接测试

在于成功激活 E-Annex 后，您可以联系 Coda 技术团队，申请切换至正式环境。在这之前，请一并提供正式环境的重定向和回调地址。

当您的商户号成功激活了正式环境，我们建议您通过我们的生产环境进行贵司沙盒环境中完成最终的测试。

若需要Coda协助完成正式环境的支付测试，请向我们提供需测试的详情:\
1.APK/测试网站。\
2.测试账号ID。\
3.测试档位(CODA仅限于协助测试最低金额)

除此之外，Coda也可以为您提供可用于测试的手机号/信用卡。

{% hint style="success" %} <mark style="color:green;">👍</mark> <mark style="color:green;"></mark><mark style="color:green;">**手机号码的备注**</mark>

* 话费支付，用户支付的手机号必须已激活/活跃在运营商系统里。
* 银行转账和线下支付，任何的当地运营商号码都可以使用。
* 若支付页面提示输入手机号，用户必须输入注册电子钱包的手机号支付。
  {% endhint %}

{% hint style="danger" %} <mark style="color:red;">❗️</mark><mark style="color:red;">**正式测试的注意事项**</mark>

1.正式环境使用真钱测试，无法退款，建议商家先在沙盒完成测试。\
2.正式环境测试目的是确保回调发货成功，每个地区挑选1或2个渠道测试即可\
3.无法测试的渠道，商家确保配置显示渠道和成功拉取支付页面即可。\
4.若商家需要Coda同事配合测试，请在工作日提前一天通知Coda技术，以便部署资源以及人力。\
5.周六日不支持协助测试，建议商家提早联系申请排期。
{% endhint %}

{% hint style="warning" %}
🚧 <mark style="color:orange;">**正式环境测试的订单备注**</mark>

正式环境完成的交易将显示在商家后台的“交易”选项中，并且符合结算条件。银行转帐交易不排除会产生额外的服务费。
{% endhint %}

## 步骤4: 上线啦 🎉

在对使用 Coda 的生产服务环境完成的测试结果感到满意后，渠道可以开放给用户了

{% hint style="warning" %} <mark style="color:orange;">🚧</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**在上线前，请确保以下几点**</mark>

* 您需要联系Coda技术团队，确认所有对接的渠道可以准备开放给用户使用 （包含需要审核的渠道）
* 请确保您的前端配置符合Coda的品牌准则，显示正确的Logo
* 请联系Coda技术团队告知渠道开放时间，以便相关人员协助监控转化率
* 请提供邮箱地址，作为订阅渠道维护信息
  {% endhint %}


---

# 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/codapay/codapay-ru-men-zhi-nan/codapay-jie-ru-liu-cheng-gai-lan.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.