為進一步提升商家營運效率與系統化管理能力，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 管理員與社群成員將竭誠為您解答疑問。
