跳转到主要内容
Webhook 允许您的应用程序在 Bullring 账户中发生事件时接收实时通知。我们会向您配置的 URL 发送 HTTP POST 请求，而无需轮询 API。

​
入金待处理

{
  "event": "onramp.status.pending",
  "data": {
    "id": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "status": "pending",
    "client_onramp_reference": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "account_id": "e704d0ec-5d19-49a1-b66c-86cd683f2d92",
    "created_at": "2026-01-23T16:45:43.276Z",
    "from": {
        "amount": "94.43",
        "currency": "BRL"
    },
    "to": {
        "asset": "USDC",
        "gross_amount": "95.47",
        "net_amount": "94.43",
        "address": "2fFUHpCEXhdQtSxompq8qbyU7EjjrtkMnr7ZT4ovF9A9",
        "network": "SOLANA"
    },
    "pricing": {
        "fx_rate": "0.19094342",
        "fees": {
            "onramp_fee": "1.5",
            "onramp_fee_currency": "brl",
            "network_fee": "0.75",
            "network_fee_asset": "USDC",
            "total_fees": "5.43",
            "total_fees_currency": "brl"
        }
    },
    "settlement": {
        "collection_id": "2ccc3c92-a256-4a21-836c-770da3522f42"
    }
  }
}

​
入金已支付

{
  "event": "onramp.status.paid",
  "data": {
    "id": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "status": "paid",
    "client_onramp_reference": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "account_id": "e704d0ec-5d19-49a1-b66c-86cd683f2d92",
    "created_at": "2026-01-23T16:45:43.276Z",
    "updated_at": "2026-01-23T16:50:43.276Z",
    "from": {
        "amount": "94.43",
        "currency": "BRL"
    },
    "to": {
        "asset": "USDC",
        "gross_amount": "95.47",
        "net_amount": "94.43",
        "address": "2fFUHpCEXhdQtSxompq8qbyU7EjjrtkMnr7ZT4ovF9A9",
        "network": "SOLANA"
    },
    "pricing": {
        "fx_rate": "0.19094342",
        "fees": {
            "onramp_fee": "1.5",
            "onramp_fee_currency": "brl",
            "network_fee": "0.75",
            "network_fee_asset": "USDC",
            "total_fees": "5.43",
            "total_fees_currency": "brl"
        }
    },
    "settlement": {
        "collection_id": "2ccc3c92-a256-4a21-836c-770da3522f42"
    }
  }
}

​
入金已完成

{
  "event": "onramp.status.completed",
  "data": {
    "id": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "status": "completed",
    "client_onramp_reference": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "account_id": "e704d0ec-5d19-49a1-b66c-86cd683f2d92",
    "created_at": "2026-01-23T16:45:43.276Z",
    "updated_at": "2026-01-23T16:50:43.276Z",
    "from": {
        "amount": "94.43",
        "currency": "BRL"
    },
    "to": {
        "asset": "USDC",
        "gross_amount": "95.47",
        "net_amount": "94.43",
        "address": "2fFUHpCEXhdQtSxompq8qbyU7EjjrtkMnr7ZT4ovF9A9",
        "network": "SOLANA"
    },
    "pricing": {
        "fx_rate": "0.19094342",
        "fees": {
            "onramp_fee": "1.5",
            "onramp_fee_currency": "brl",
            "network_fee": "0.75",
            "network_fee_asset": "USDC",
            "total_fees": "5.43",
            "total_fees_currency": "brl"
        }
    },
    "settlement": {
        "collection_id": "2ccc3c92-a256-4a21-836c-770da3522f42",
        "transaction_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
    }
  }
}

​
入金失败

{
  "event": "onramp.status.failed",
  "data": {
    "id": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "status": "failed",
    "client_onramp_reference": "e1359951-fa48-40f8-9e85-c38bc5ea857d",
    "account_id": "e704d0ec-5d19-49a1-b66c-86cd683f2d92",
    "created_at": "2026-01-23T16:45:43.276Z",
    "updated_at": "2026-01-23T16:50:43.276Z",
    "from": {
        "amount": "94.43",
        "currency": "BRL"
    },
    "to": {
        "asset": "USDC",
        "gross_amount": "95.47",
        "net_amount": "94.43",
        "address": "2fFUHpCEXhdQtSxompq8qbyU7EjjrtkMnr7ZT4ovF9A9",
        "network": "SOLANA"
    },
    "pricing": {
        "fx_rate": "0.19094342",
        "fees": {
            "onramp_fee": "1.5",
            "onramp_fee_currency": "brl",
            "network_fee": "0.75",
            "network_fee_asset": "USDC",
            "total_fees": "5.43",
            "total_fees_currency": "brl"
        }
    },
    "settlement": {
        "collection_id": "2ccc3c92-a256-4a21-836c-770da3522f42"
    }
  }
}