歡迎使用比特幣第三方支付

ApiCrypto 提供開發人員「極簡、方便」的比特幣開放式支付系統, 讓您透過此 REST API 快速進行第三方支付串接工作, 包含創建錢包地址、大量對象地址交易、區塊確認主動通知...等支付功能.

本系統採半開放式服務, 申請 API 服務只需輸入您的電子郵件地址, 您將在您的電子信箱中收到 API Key, 日後發送的 API 請求將透過此 API Key 進行請求驗證, 請妥善保管.

良好的比特幣支付規劃應為
一個使用者使用單個錢包地址, 或者是, 一筆交易訂單使用單個錢包地址, 請勿讓多個使用者共同使用同一錢包地址, 防止您日後無法判斷不同使用者的實際支付狀態.


通訊方式

開發者可使用一般的 HTTP Request 通訊方式對我們發出請求, 我們回應方式統一為 JSON 格式, HTTP Request 方法通常為 GETPOST.

  • 正式用 API 主機:https://apicrypto.info/api
  • 訊息回應

    錯誤回應代碼 code :

  • 1000 :伺服器維護中
  • 1001 :請求資料不齊全
  • 1002 :API Key 不正確
  • 1003 :超過請求頻率, 暫停接收請求
  • 1004 :發送資料內容錯誤
  • 1999 :伺服器錯誤
  • 請求成功回應格式:

    {
        success: 1,
        data: {
            xxx: "xxx",
            yyy: "yyy"
        }
    }
    


    請求錯誤回應格式:

    {
        success: 0,
        code: 1001
    }
    

    使用限制

    為防止濫用, 我們對請求的限制為:

  • API 請求的頻率不超過 30次/每分鐘, 若超過將暫停接收您的請求 30 分鐘
  • 一個 E-mail 地址 限用一個 API Key
  • 請求皆為 GETPOST 方法, 尚不接受其他請求方法
  • 使用本系統過程必須完全遵守法規政策 ( 點此完整閱讀政策 )
  • 發送的對象金額必須高於 550 Satoshis (0.0000055 BTC), 伺服器不接受低於此數值的塵埃交易
  • 手續費

    礦工費用計算教學

    比特幣區塊鍊交易紀錄需要礦工來進行驗證與紀錄工作, 您可自行決定欲支付給礦工的費用, 並參考下列建議的礦工費用計算方式, 礦工費用的高低將影響該筆交易被礦工驗證的時間, 請注意!過低的礦工費用可能導致該筆交易不會被驗證
    發送交易至區塊鍊必須支付一定的礦工費用, 促使礦工驗證您的交易, 有一參考計算公式, 可預先計算該次交易的體積(大約值), 交易體積計算參考公式為:
    交易體積 = 交易來源數量 x 148 + 交易對象數量 x 34 + 50 (Bytes)
    這邊要注意「交易來源數量」為該地址曾接收過且尚未使用過的來源交易
    接下來獲取平均每 Byte 目前比特幣區塊鍊上的礦工費用 (Satoshis)
    可對以下 URLHTTP GET 請求查詢:
    https://bitcoinfees.earn.com/api/v1/fees/recommended
    可獲得目前比特幣交易的平均礦工費用 Satoshis/Byte

  • fastestFee:快速交易的礦工費用 Satoshis/Byte
  • halfHourFee:普通速度交易的礦工費用 Satoshis/Byte
  • hourFee:較慢速度交易的礦工費用 Satoshis/Byte

  • 舉例情況:您發出了單筆支付請求, 目前 A 錢包地址曾經有接收過一筆交易紀錄, 將 A 錢包地址的比特幣發送至 C 、 D 、 E, 取得目前礦工建議 fastestFee 費用為 50 Satoshis/Byte, 則建議的礦工費用為
    (1 x 148 + 3 x 34 + 50) x 50
    = 15000 Satoshis
    = 0.00015 BTC

    系統費用

    比特幣區塊鍊資訊交易必須支付給協助驗證交易的礦工費用, 除了交易礦工費用, 不論該單筆交易紀錄的 Txout (交易對象)的數量, 我們將向您收取 0.00015 BTC 的單筆交易手續費用, 系統手續費用將「自動」發送至地址 3CRK8RkdfogP6cxJqLCa7PGoc6RABJd2Rc , 不須再額外發送系統手續費用給我們
    以下是範例說明:
    您發出了單筆支付請求, 將 A 錢包地址的比特幣發送至 C、D、E, 本系統會自動檢查總來源的餘額並扣除 0.00015 BTC 作為系統的手續費用.

    法規政策

    使用本平台上的所有服務必須遵守當地法律與本平台的政策, 若您不正當使用本平台任一功能, 我們將會直接封鎖您的 API 存取權限與錢包操控權限, ( 請務必點擊此處詳細閱讀本平台的法規政策 ).


    創建錢包地址

    POST /api/v1/wallet/create
    https://apicrypto.info/api/v1/wallet/create

    要求欄位:

    欄位名稱 類型 說明
    apikey String (64) 您的 API Key

    成功回應範例:

    {
        success: 1,
        data: {
            address: "3CRK8RkdfogP6cxJqLCa7PGoc6RABJd2Rc",
            secret: "walletPassword"
        }
    }
    

    回應欄位說明:
    address:比特幣錢包地址
    secret:此錢包地址的密碼 (錢包密碼為該錢包的唯一控制密鑰, 請妥善保管, 若遺失則無法找回)

    支付作業

    POST /api/v1/wallet/send
    https://apicrypto.info/api/v1/wallet/send

    要求欄位:

    欄位名稱 類型 說明
    apikey 字串 (64) 您的 API Key
    from 字串 交易來源錢包地址
    to 字串 發送對象錢包地址, 可複數, 傳送格式為 地址:數量 (請參考範例)
    secret 字串 交易來源錢包地址密碼
    fee 浮點數 礦工費用 (須高於 0.000006 BTC)

    [from] 欄位傳送字串範例:
    3CRK8RkdfogP6cxJqLCa7PGoc6RABJd2Rc
    [to] 欄位傳送字串範例(地址:數量[,地址:數量]):
    14pEQLg7vyLpJoCCb5RFUKGAxaanPNa1WC:0.0015,15Z3P1V2tTqnseyGYga8mGRuVB1a9bjgjR:0.03
    此範例說明:
    地址A : 3CRK8RkdfogP6cxJqLCa7PGoc6RABJd2Rc (錢包餘額:0.05)
    地址B : 14pEQLg7vyLpJoCCb5RFUKGAxaanPNa1WC
    地址C : 15Z3P1V2tTqnseyGYga8mGRuVB1a9bjgjR
    客戶情形 : 發送支付請求, 將地址A與地址B的比特幣總餘額發送至地址B:數量 0.0015、地址C:數量 0.03, [fee] 欄位參考了 礦工手續費用計算 後填入, 並且將發送後的餘額扣除系統費用 0.00015 BTC, 剩餘的比特幣自動發送回錢包地址A, 注意!對各別地址發送的數量與找回的餘額不可低於 0.00000546 BTC, 比特幣網路不接受塵埃交易

    成功回應範例:

    {
        success: 1,
        data: {
            txid: "4ce1e4a2d70b08763b0c317ea20956d64397e82825c9829d35f5a08505594227"
        }
    }
    

    txid: 交易紀錄唯一序號, 可至任何比特幣平台查詢交易
    推薦查詢交易平台:
    BTC.COM
    BLOCKCHAIN