thewallet.ai

Hantar dokumen terus ke dompet pengguna anda.

Gunakan Protokol Wallet — API dan webhook yang ringkas — untuk menghantar kontrak, bil, invois, polisi, notis dan permintaan tandatangan ke dompet yang sudah dipercayai pengguna anda.

Hantar kontrak ke dompet pengguna
await wallet.assets.deliver({
  walletId,
  type: "contract",
  title: "Service Agreement",
  requireSignature: true,
  agentAssist: true
})

Cara Protokol Wallet berfungsi

1

Daftar satu penghantaran

Satu panggilan API mendaftarkan kontrak, bil atau notis sebagai aset dompet yang boleh dihantar — bertaip, berversi dan boleh dijejak.

2

Hantar ke dompet pengguna

Pengguna anda menerimanya dalam dompet yang mereka percayai — untuk dibaca, ditandatangani dan disimpan.

3

Terima acara melalui webhook

Acara seperti buka, tandatangan dan pengesahan dihantar semula ke sistem anda secara masa nyata.

Rujukan API (pratonton)

Protokol Wallet ialah API HTTPS biasa. Satu endpoint menghantar dokumen bertaip ke dalam dompet; webhook melaporkan apa yang berlaku selepas itu.

Pengesahan

Hantar kunci API anda dalam header x-api-key. Kunci dikeluarkan sendiri di halaman Integrasi dompet anda dan diskop mengikut integrasi.

x-api-key: wlt_live_xxxxxxxxxxxxxxxx

Hantar dokumen

POST satu envelope untuk menghantar kontrak, bil, invois, polisi atau notis. Target menerima alamat dompet, ID dompet atau alamat digital; idempotencyKey menjadikan cubaan semula selamat.

POST https://service.icloudportal.com/api/theWallet.protocol.deliverAsset
x-api-key: wlt_live_xxxxxxxxxxxxxxxx
Content-Type: application/json

{
  "protocolVersion": "2026-01",
  "idempotencyKey": "order-2026-0611-001",
  "source": { "system": "acme-billing", "organizationName": "Acme Ltd" },
  "target": { "walletAddress": "alex@wallet.thewallet.ai" },
  "asset": {
    "type": "contract",
    "title": "Service Agreement",
    "requiresSignature": true
  },
  "options": { "requireUserConfirmation": true }
}

Respons

{
  "status": 0,
  "data": {
    "deliveryId": "dlv_9f2…",
    "assetId": "ast_71c…",
    "inboxItemId": "inb_2ab…",
    "signatureRequestId": "sig_e04…",
    "status": "delivered",
    "requireUserConfirmation": true,
    "reused": false
  }
}

Webhook

Daftarkan endpoint webhook di halaman Integrasi untuk menerima acara penghantaran — contohnya asset.created apabila dokumen tiba dalam dompet — ditandatangani dan dicuba semula secara automatik.

{
  "eventType": "asset.created",
  "data": {
    "assetId": "ast_71c…",
    "assetType": "contract",
    "walletId": "wlt_3d8…",
    "status": "received"
  }
}

Sambungkan ejen AI (MCP)

The Wallet menyediakan pelayan MCP supaya rangka kerja ejen seperti Claude boleh menghantar dokumen, meminta tandatangan dan meminta kebenaran pemilik dompet — ejen menyediakan, pemilik mengesahkan.

{
  "mcpServers": {
    "thewallet": {
      "command": "npx",
      "args": ["@thewallet/mcp"],
      "env": { "THEWALLET_API_KEY": "wlt_live_xxxxxxxxxxxxxxxx" }
    }
  }
}

Dapatkan kunci pembangun anda

Cipta dompet percuma, kemudian keluarkan kunci API anda sendiri dari halaman Integrasi — tiada panggilan jualan diperlukan. Penghantaran peringkat dompet dan API penuh termasuk dalam pelan Platform.

Cipta dompet percuma andaSudah ada dompet? Buka Integrasi

Ini ialah pratonton permukaan API. Hubungi kami untuk akses awal dan sokongan integrasi.