為進一步提升商家營運效率與系統化管理能力，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/account/set_merchant_work_hours | 設定商家工作狀態 | |
| 廣告管理 | 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 管理員與社群成員將竭誠為您解答疑問。
免責聲明
本文內容僅供參考與學習目的，不構成任何金融、投資、交易或法律建議，也不構成購買或出售任何虛擬資產的要約或邀請。Gate 對文中資訊的準確性、完整性或時效性不作任何明示或暗示的保證。產品功能、介面、規則及費率等資訊可能隨時更新或調整，請以 Gate 平台的最新公告及實際頁面展示為準。
虛擬資產投資涉及高風險，價格可能出現大幅波動，您可能損失全部投入資金。請在充分了解相關風險的基礎上，根據自身財務狀況和風險承受能力謹慎決策。如有需要，建議您諮詢獨立的專業財務或法律顧問。
有關更多風險資訊，請參閱 Gate《風險警示》及《用戶協議》。
