为进一步提升商家运营效率与系统化管理能力，Gate 正式推出 C2C API 服务。
C2C API 是面向已完成认证的 C2C 商家提供的官方接口服务，支持商家通过安全、标准化的接口方式对接自有系统，实现广告发布与管理、订单查询与处理、自动放币与取消、聊天消息交互及账户信息查询等功能。
通过接入 C2C API，商家可实现：
- 广告自动化管理与动态调价
- 订单实时查询与高效处理
- 降低人工操作成本与人为操作风险
- 构建 7 × 24 小时自动化运营体系
- 支持多策略做市与规模化运营
C2C API 的上线，将进一步增强平台商家生态的专业化与规模化发展能力，助力优质商家提升成交效率与市场竞争力。
一、适用对象
C2C API 面向以下主体开放：
- 已完成 C2C 商家认证并通过平台审核的 Gate 商家账户（包括认证商家、蓝 V 商家、皇冠商家等）
- 具备一定技术开发能力的商家团队或系统集成方
- 需要自动化交易、批量管理广告或多策略运营的专业做市团队
注：未完成商家认证的账户无法使用 C2C API 功能。
二、如何使用 C2C API
商家认证
- 登录 Gate 账户，进入 C2C 商家招募或管理页面，申请成为法币交易商家（普通、蓝V、皇冠等级等）。
- 商家入驻申请审核通过后，即可开通商家权限。
创建 API Key
- 进入 API 管理页面（API V4 Keys）创建 API Key（注意：需开启C2C API 权限）。
- API Key 包含
Access Key与Secret Key，妥善保存，不要泄露。
注：请妥善保管 Secret Key，避免泄露。
调用 API
- 按官方签名规则进行接口签名
- 使用 HTTPS POST 方式调用
- 可参考官方 API 文档中的 SDK调用示例代码
三、C2C API 的功能
Gate C2C 商家 API 提供账户、广告、订单、聊天等核心模块的全面管理能力。
| 模块 | 接口 | 功能 |
|---|---|---|
| 账户相关 | POST /p2p/merchant/account/get_user_info | 获取商家基本信息 |
| POST /p2p/merchant/account/get_myself_payment | 获取商户支持的支付方式列表 | |
| POST /p2p/merchant/account/get_counterparty_user_info | 获取对方交易用户信息 | |
| 广告管理 | POST /p2p/merchant/books/place_biz_push_order | 发布广告 |
| POST /p2p/merchant/books/ads_update_status | 修改广告状态（上线/下线） | |
| POST /p2p/merchant/books/ads_detail | 获取广告详情 | |
| POST /p2p/merchant/books/my_ads_list | 获取当前商家广告列表 | |
| POST /p2p/merchant/books/ads_list | 获取市场广告列表 | |
| 订单管理 | POST /p2p/merchant/transaction/get_pending_transaction_list | 查询进行中订单 |
| POST /p2p/merchant/transaction/get_completed_transaction_list | 查询历史订单 | |
| POST /p2p/merchant/transaction/get_transaction_details | 查询订单详情 | |
| POST /p2p/merchant/transaction/confirm-payment | 商家确认付款 | |
| POST /p2p/merchant/transaction/confirm-receipt | 商家确认放币 | |
| POST /p2p/merchant/transaction/cancel | 商家取消订单 | |
| 聊天管理 | POST /p2p/merchant/chat/get_chats_list | 获取聊天列表 / 历史聊天 |
| POST /p2p/merchant/chat/send_chat_message | 发送聊天消息 | |
| POST /p2p/merchant/chat/upload_chat_file | 上传聊天文件/附件 |
四、支持与反馈
如需任何其他C2C API 支持，您可以通过我们的官方 C2C API Telegram 群组联系我们的技术团队。我们的 API 管理员和社区成员将竭诚为您解答疑问。
