平台服務簡介

本文件旨在幫助您快速了解平台的代收代付服務，包含核心概念說明與完整的資金流程圖。

什麼是代收代付服務？

代收代付是一種資金管理服務，讓商戶可以：

• 代收：接收客戶的付款（例如：客戶購買商品、儲值等）
• 代付：向客戶或供應商付款（例如：提現、退款、結算等）

平台為您解決什麼問題？

核心概念

用戶錢包

定義：平台為每位終端客戶自動生成的專屬收款地址。

用途：接收該客戶的所有付款。

簡單理解：就像為每位客戶開設一個「專屬收款帳戶」，客戶付款時轉入這個地址，平台就知道是哪位客戶付的款。

特點：

• 每位客戶一個獨立地址
• 自動對帳，不會混淆
• 資金安全隔離

商戶金庫

定義：商戶的資金集中管理帳戶。

用途：

• 統一管理所有資金
• 執行對外付款（代付）
• 支付區塊鏈交易手續費

簡單理解：就像公司的「主帳戶」或「金庫」，所有資金最終都會集中到這裡，方便統一調度。

特點：

• 每個商戶一個金庫
• 可查看完整資產明細
• 支援多種幣種

代收流程

當客戶要付款給商戶時，資金的流動方式如下：

流程說明

歸集流程

歸集是將分散在各用戶錢包的資金，統一收回到商戶金庫的過程。

流程說明

代付流程

當商戶需要付款給客戶或外部地址時：

流程說明

整體資金流向

以下是代收代付服務的完整資金流向圖：

常見問題

Q1: 為什麼資金不直接進入商戶金庫？

Q: 歸集與燃料費相關

詳細請參考核心概念中的燃料費說明。

簡介 & 串接須知

歡迎使用 Coin API v2。本 API 提供區塊鏈錢包管理、USDT 及多種代幣的充值與提現功能。

參數簽名 (Authentication)

為確保資料安全，所有 API 請求 (Header) 必須包含 X-Api-Sign。

加密步驟

1. 將該次 Request 所有參數 (除了 sign) 依照鍵值 (Key) 由小到大排序 (ksort)。
2. 將排序好的參數轉化成 JSON 字串 (去除斜線、不編碼 Unicode)。
3. 使用 OpenSSL 將 JSON 字串做 AES-256-ECB 加密 (使用私鑰)。
4. 將加密後的結果轉型成 Base64。
5. 最後將 Base64 字串使用 SHA256 算法做散列運算，取得最終 Sign。

PHP 範例代碼

/**
 * Signature.php
 * @param array $parameter 該次 request 帶入的參數
 * @return string
 */
public function encrypt(array $parameter): string
{
    // 1. 將參數依照 Key 由小到大排序
    ksort($parameter);

    // 2. 轉化成 JSON (去除斜線, 不編碼 Unicode)
    $json = json_encode($parameter, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);

    // 3. AES-256-ECB 加密
    $crypt = openssl_encrypt($json, $this->cipher, $this->privateKey, OPENSSL_RAW_DATA);

    // 4. 轉型成 Base64
    $crypt = base64_encode($crypt);

    // 5. SHA256 散列
    $crypt = hash('sha256', $crypt);

    return $crypt;
}
        

取得代幣資訊

Request Header

Response

{
    "code": 200,
    "data": [
        {
            "name": "USDT_TRC20",
            "title": "Tether",
            "symbol": "USDT",
            "chain": "TRON",
            "fee": 0
        }
    ]
}
        

取得錢包地址

查詢特定用戶已存在的錢包地址。

Request Body

Response

{
    "code": 200,
    "data": [
        {
            "identity": "huge",
            "chain": "TRON",
            "address": "TYdsAewBvkgpUkSJ5wMTsoHEuh4KWVh5js"
        }
    ]
}
        

創建錢包地址

為用戶生成新的區塊鏈錢包地址。

Request Body

Response

{
    "code": 200,
    "data": [
        {
            "identity": "huge",
            "chain": "TRON",
            "address": "TYdsAewBvkgpUkSJ5wMTsoHEuh4KWVh5js"
        }
    ]
}
        

查詢錢包餘額

Request Body

Response

{
    "code": 200,
    "data": {
        "identity": "user0001",
        "assets": [
            {
                "symbol": "USDT",
                "name": "USDT_TRC20",
                "qty": "1.22"
            }
        ]
    }
}
        

查詢用戶交易訂單

Request Body

Response Fields

• status: 0:佇列中, 1:交易中, 2:已完成, 3:已失敗
• type: 0:轉出, 1:轉入

創建用戶提現交易

Request Body

商戶提現 (Merchant Withdraw)

將用戶錢包餘額轉至商戶錢包或是指定地址。

Request Body

交易確認回調 (Callback)

當區塊鏈交易確認時，系統會發送 POST 請求至您設定的回調 URL。

Callback 參數

JSON 範例

{
    "sid": "0162771607146764096",
    "status": "0",
    "type": "0",
    "coin": "USDT_TRC20",
    "txid": "0x1be0a0...",
    "qty": "842.86",
    "sign": "1bfcedf92d..."
}