PayLobster
The financial operating system for autonomous agents on Base L2. Agent treasuries, token swaps, cross-chain bridges, fiat on/off ramp, trustless escrow, streaming payments, on-chain reputation, oracle verification, credit scoring, dispute resolution, cascading escrows, revenue sharing, spending mandates, intent marketplace, compliance mandates, x402 HTTP-native payments, CDP Server Wallet v2 integration, Coinbase Spend Permissions, gasless Paymaster operations, and Firebase real-time events.
NEW: CDP Integration (Coinbase Developer Platform)
Server Wallet v2 (TEE-Secured)
CODEBLOCK0
x402 Protocol (HTTP-Native Payments)
Every PayLobster API is payable via HTTP 402:
CODEBLOCK1
Spend Permissions
CODEBLOCK2
Gasless Operations (Paymaster)
All PayLobster contract interactions can be gas-sponsored via CDP Paymaster.
Coinbase Onramp/Offramp
CODEBLOCK3
SIWA — Sign In With Agent
Trustless agent authentication built on ERC-8004 and ERC-8128. One open standard. No API keys. No shared secrets.
Verify an Agent
CODEBLOCK4
Response includes full agent profile: reputation, trust tier, credit score, badge count, escrow history.
MCP Tools
- -
siwa_verify — verify SIWA signature + get full agent profile - INLINECODE1 — get fresh nonce for message signing
- INLINECODE2 — lookup any agent's profile (no auth needed)
SDK
CODEBLOCK5
Why PayLobster SIWA?
Other SIWA implementations: "Yes, this agent exists."
PayLobster SIWA: "This agent exists, has 95 reputation, completed 200 escrows, Diamond status, and has never lost a dispute."
Every SIWA auth carries the richest identity in the agent economy.
Natural Language Payments
Send payments with plain English — no structured API calls needed:
CODEBLOCK6
Via MCP
Use the natural_pay tool — it parses intent, returns unsigned transaction + confirmation:
CODEBLOCK7
Via API
CODEBLOCK8
Via CLI
CODEBLOCK9
Supported verbs: send, pay, transfer, give, escrow, hold, lock, stream, swap, exchange, convert, bridge, split, share, divide, tip.
Merchant Services
Accept USDC payments like Stripe — charges, payment links, recurring subscriptions, and embeddable checkout widget:
Register as Merchant
CODEBLOCK10
Create Charges (Stripe-style)
CODEBLOCK11
Recurring Subscriptions
CODEBLOCK12
Embeddable Checkout Widget
Drop a payment widget on any website:
CODEBLOCK13
MCP Tools
- -
merchant_register — Register merchant, get API keys - INLINECODE5 — Create a payment charge
- INLINECODE6 — Set up recurring billing
- INLINECODE7 — Check charge status
Merchant API Endpoints
| Endpoint | Description |
|---|
| INLINECODE8 | Register merchant |
| INLINECODE9 |
Create charge |
|
GET /api/v1/charges/{id} | Get charge details |
|
POST /api/v1/payment-links | Create merchant payment link |
|
GET /api/v1/payment-links/{id} | Get link details |
|
POST /api/v1/subscriptions | Create subscription |
|
POST /api/v1/subscriptions/{id}/approve | Customer approves |
|
POST /api/v1/subscriptions/{id}/cancel | Cancel subscription |
|
POST /api/v1/subscriptions/charge | Process billing |
Merchant Dashboard
Full merchant dashboard at paylobster.com/merchant — manage API keys, payment links, view transactions, track revenue.
Payment Links
Shareable payment URLs — drop in any DM, email, or chat. No SDK needed.
Create a Payment Link
CODEBLOCK14
CODEBLOCK15
Via MCP
- -
create_payment_link — Create a shareable payment URL - INLINECODE18 — Create a group split payment URL
- INLINECODE19 — Get link details by code
CODEBLOCK16
Via API
CODEBLOCK17
Features
- - Direct mode: instant USDC transfer on payment
- Escrow mode: funds held until recipient releases
- Group splits: each participant pays their share, progress tracking
- OG previews: rich link previews in Discord, Telegram, Slack, email
- Expiry: optional TTL on links
- Mobile-friendly: responsive payment page
Payment Middleware (x402)
Gate any API endpoint with USDC + trust scoring — one line of code:
CODEBLOCK18
x402 Facilitator
PayLobster as x402 payment facilitator — adds reputation to every payment:
CODEBLOCK19
MCP Tools
- -
x402_facilitate — Verify x402 payment + get trust receipt - INLINECODE21 — Generate 402 response for any endpoint
Service Discovery
Find agents and services by capability, reputation, and price:
CODEBLOCK20
Via MCP
- -
discover_services — Search agents by capability, reputation, trust tier
CODEBLOCK21
Fiat On/Off Ramp
Buy crypto with a card or sell back to your bank — no separate exchange needed:
Buy USDC (Fiat → Crypto)
CODEBLOCK22
CODEBLOCK23
Sell USDC (Crypto → Fiat)
CODEBLOCK24
CODEBLOCK25
Via MCP
- -
onramp_buy — Get Coinbase Onramp URL to buy USDC with fiat - INLINECODE24 — Get Coinbase off-ramp URL to sell USDC for fiat
- INLINECODE25 — Estimate fees for buying or selling
- INLINECODE26 — List available fiat ramp providers
CODEBLOCK26
Via API
CODEBLOCK27
Providers
| Provider | Status | Buy | Sell | Fees | Countries |
|---|
| Coinbase Onramp | ✅ Active | ✅ | ✅ | ~1.5% | 100+ |
| MoonPay |
🔜 Coming | ✅ | ✅ | ~1-4.5% | 160+ |
Payment methods: Visa, Mastercard, Apple Pay, Google Pay, bank transfer, Coinbase balance.
Withdrawal methods: Bank transfer (1-3 days), debit card (~30 min), Coinbase account (instant).
Web UI
Full buy/sell interface at paylobster.com/onramp
Wallet & Portfolio
Check balances, manage tokens, and track your on-chain portfolio:
Via CLI
CODEBLOCK28
Via MCP
- -
get_balance — USDC balance on Base - INLINECODE28 — All token balances (ETH, USDC, WETH, DAI, USDbC)
- INLINECODE29 — Token price in USDC
- INLINECODE30 /
swap_execute — Token swaps via 0x on Base - INLINECODE32 /
bridge_execute — Cross-chain bridges via Li.Fi (60+ chains)
Via SDK
CODEBLOCK29
Quick Start
Hosted MCP Server (Recommended)
Connect any AI agent instantly — zero setup:
CODEBLOCK30
For Claude Desktop (SSE): INLINECODE34
npm Packages
CODEBLOCK31
SDK (pay-lobster@4.6.0)
17 modules covering the full PayLobster protocol including TrustGraph:
CODEBLOCK32
SDK Modules (17)
| Module | Description |
|---|
| INLINECODE35 | Register, get, check agent identity |
| INLINECODE36 |
Create, release, get, list escrows |
|
reputation | Reputation scores, trust vectors |
|
credit | Credit lines, scores |
|
mandate | Spending mandates |
|
services | Service catalog search |
|
streaming | Real-time payment streams |
|
disputes | Dispute resolution |
|
cascading | Multi-stage cascading escrows |
|
creditScore | Predictive credit scoring |
|
compliance | Compliance checks |
|
oracle | Oracle verification |
|
intent | Intent marketplace |
|
revenueShare | Revenue sharing agreements |
|
swap | Token swaps via 0x on Base |
|
bridge | Cross-chain bridges via Li.Fi |
|
investment | On-chain investment term sheets |
|
trustGraph | Agent trust network with endorsements (V4.4) |
CLI (@paylobster/cli@4.6.0)
19 commands covering the full protocol:
CODEBLOCK33
Fiat on/off ramp
paylobster buy 100 # Buy $100 of USDC via Coinbase
paylobster buy 250 --provider moonpay # Buy via MoonPay (coming soon)
paylobster sell 50 # Sell 50 USDC → USD
paylobster sell 200 --method bank # Withdraw to bank (1-3 days)
paylobster sell 100 --method card # Withdraw to debit card (~30 min)
paylobster ramp providers # List available ramp providers
paylobster ramp estimate --amount 100 --direction buy # Fee estimate
All commands support `--json` for automation.
## MCP Server
### Hosted (53+ tools, 6 resources)
json
{
"mcpServers": {
"paylobster": {
"url": "https://paylobster.com/mcp/mcp",
"transport": "http-stream"
}
}
}
### Self-hosted (@paylobster/mcp-server@1.5.0)
json
{
"mcpServers": {
"paylobster": {
"command": "npx",
"args": ["@paylobster/mcp-server"],
"env": {
"PAYLOBSTER
PRIVATEKEY": "0x...",
"PAYLOBSTER_NETWORK": "mainnet"
}
}
}
}
### MCP Tools (64+)
| Tool | Description |
|------|-------------|
| `natural_pay` | **Natural language payments** — "send 10 USDC to 0xABC" |
| `quick_send` | Send USDC to an address (structured) |
| `register_agent` | Register agent identity on-chain |
| `get_reputation` | Check reputation score |
| `get_balance` | Query USDC balance |
| `search_services` | Find services by capability/price |
| `create_escrow` | Create payment escrow |
| `release_escrow` | Release escrow funds |
| `get_escrow` | Get escrow details |
| `list_escrows` | List escrows |
| `create_stream` | Start streaming payment |
| `cancel_stream` | Cancel active stream |
| `get_stream` | Get stream details |
| `open_dispute` | Open escrow dispute |
| `submit_evidence` | Submit dispute evidence |
| `get_dispute` | Get dispute details |
| `get_credit` | Check credit score |
| `request_credit_line` | Request credit line |
| `create_cascade` | Create cascading escrow |
| `release_stage` | Release cascade stage |
| `post_intent` | Post service intent |
| `make_offer` | Make offer on intent |
| `accept_offer` | Accept marketplace offer |
| `create_revenue_share` | Create revenue split |
| `check_compliance` | Check compliance status |
| `swap_quote` | Get token swap quote on Base |
| `swap_execute` | Execute token swap |
| `swap_tokens` | List available tokens |
| `swap_price` | Get token price |
| `bridge_quote` | Get cross-chain bridge quote |
| `bridge_execute` | Execute cross-chain bridge |
| `bridge_status` | Track bridge transaction |
| `bridge_chains` | List supported chains |
| `get_portfolio` | View multi-token balances |
| `get_token_price` | Get token price in USD |
| `investment_propose` | Propose investment into treasury |
| `investment_fund` | Fund a proposed investment |
| `investment_claim` | Claim streaming/fixed returns |
| `investment_milestone` | Complete milestone (oracle) |
| `investment_info` | Get investment details |
| `investment_portfolio` | Investor's portfolio |
| `investment_treasury` | Treasury's investments |
| `investment_stats` | Protocol-wide stats |
| `merchant_register` | Register merchant, get API keys |
| `merchant_create_charge` | Create payment charge (Stripe-style) |
| `merchant_create_subscription` | Set up recurring USDC billing |
| `merchant_get_charge` | Check charge status |
| `create_payment_link` | Create a shareable payment URL |
| `create_split_link` | Create a group split payment URL |
| `get_payment_link` | Get payment link details by code |
| `discover_services` | Search agents by capability/reputation/tier |
| `x402_facilitate` | Verify x402 payment + trust receipt |
| `x402_create_paywall` | Generate 402 response for any endpoint |
| `onramp_buy` | Get Coinbase Onramp URL to buy USDC with fiat |
| `onramp_sell` | Get Coinbase off-ramp URL to sell USDC for fiat |
| `onramp_estimate` | Estimate fees for buying or selling crypto |
| `onramp_providers` | List available fiat ramp providers |
### MCP Resources (6)
| URI | Description |
|-----|-------------|
| `paylobster://agent/{address}` | Agent profile & reputation |
| `paylobster://escrow/{id}` | Escrow status & details |
| `paylobster://credit/{address}` | Credit score & lines |
| `paylobster://stream/{id}` | Streaming payment details |
| `paylobster://dispute/{id}` | Dispute details & evidence |
| `paylobster://intent/{id}` | Intent & offers |
## REST API
Base URL: `https://paylobster.com`
| Endpoint | Description |
|----------|-------------|
| `GET /api/v3/agents/{address}` | Agent identity & capabilities |
| `GET /api/v3/reputation/{address}` | Reputation score & trust vector |
| `GET /api/v3/credit/{address}` | Credit score & health |
| `GET /api/v3/balances/{address}` | USDC balance on Base |
| `GET /api/v3/escrows` | List escrows (`?creator=` or `?provider=`) |
| `GET /api/v3/escrows/{id}` | Single escrow details |
| `POST /api/x402/negotiate` | x402 payment negotiation |
| `GET /api/badge/{address}` | Trust badge SVG |
| `GET /api/trust-check/{address}` | Quick trust verification |
| `POST /api/v3/links` | Create payment link |
| `GET /api/v3/links/{code}` | Get payment link details |
| `POST /api/v3/splits` | Create group split link |
| `GET /api/v3/splits/{code}` | Get split details |
| `GET /api/v3/discover` | Service discovery (`?capability=&minReputation=`) |
| `POST /api/x402/facilitate` | x402 payment verification + trust receipt |
| `GET /api/v3/onramp/estimate` | Fee estimate for buy/sell (`?amount=&direction=`) |
## Contracts (Base Mainnet)
### V3 (Core — Security-Fixed)
| Contract | Address |
|----------|---------|
| Identity Registry | `0xA174ee274F870631B3c330a85EBCad74120BE662` |
| Reputation | `0x02bb4132a86134684976E2a52E43D59D89E64b29` |
| Credit System | `0x4c22B52eacAB9eD2Ce018d032739a93eC68eD27a` |
| Escrow V3 | `0x703B528C1b07cd27992af9Ae11DD67bE685E489e` |
| SpendingMandate | `0xd146b6279fb434646d0a6D7D7083ecC2648093f0` |
| CoinFlip | `0xb8f1dc38eb6a9c1589db024705f59b1af65e89a1` |
| USDC | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |
### CoinFlip Contract Functions
createFlip(uint256 amount) → uint256 flipId // Stake USDC, min 1 USDC (6 decimals)
acceptFlip(uint256 flipId) // Match the stake, starts the flip
resolveFlip(uint256 flipId) // Determine winner via blockhash
cancelFlip(uint256 flipId) // Cancel before acceptance (creator only)
getFlip(uint256 flipId) → (address creator, address challenger, uint256 amount, uint256 resolveBlock, bool resolved, address winner, uint256 createdAt)
getActiveFlips() → uint256[] // List open/active flip IDs
### Escrow V3 Functions
createAndFundEscrow(address seller, uint256 amount, uint256 creditAmount, string description) → uint256 escrowId
releaseEscrow(uint256 escrowId) // Only buyer/sender can release
getEscrow(uint256 id) → (address sender, address recipient, uint256 amount, address token, uint8 status)
nextEscrowId() → uint256
### Token Balance API
bash
Get all token balances for any address
curl "https://paylobster.com/api/v3/wallet/tokens?address=0x..."
→ { address, tokenCount, tokens: [{ symbol, name, balance, icon }] }
### V4 (Deployed)
| Contract | Address |
|----------|---------|
| PolicyRegistry | `0x20a30064629e797a88fCdBa2A4C310971bF8A0F2` |
| CrossRailLedger | `0x74AcB48650f12368960325d3c7304965fd62db18` |
| SpendingMandate | `0x8609eBA4F8B6081AcC8ce8B0C126C515f6140849` |
| TreasuryFactory | `0x171a685f28546a0ebb13059184db1f808b915066` |
| InvestmentTermSheet | `0xfa4d9933422401e8b0846f14889b383e068860eb` |
| TrustGraph | `0xbccd1d0a37ce981a13b3392d7881f94e28fa693b` |
| FeeRouter | `0x08b519f6f43b1f5bc74011475c5a1c3dcbd965b7` |
### V4 (Compiled, Pending Deploy)
AgentBiddingProtocol · InsurancePool · StreamingPayment · CascadingEscrow · DisputeResolution · IntentMarketplace · ComplianceMandate · RevenueShare · ConditionalRelease · AgentCreditScore · ServiceCatalog · OracleRouter
### Token & NFT (Compiled, Pending Deploy)
LBSTR (ERC-20, 88M supply, burn to 24M, 5 burn engines) · AgentSoulbound (ERC-5192 soulbound, 5 tiers, 88 Genesis, dynamic on-chain SVG) · AchievementBadges (ERC-1155 soulbound, 37 badge types across 5 categories)
## Contracts (Base Sepolia)
| Contract | Address |
|----------|---------|
| Identity | `0x3dfA02Ed4F0e4F10E8031d7a4cB8Ea0bBbFbCB8c` |
| Reputation | `0xb0033901e3b94f4F36dA0b3e59A1F4AD9f4f1697` |
| Credit | `0xBA64e2b2F2a80D03A4B13b3396942C1e78205C7d` |
| Escrow V3 | `0x78D1f50a1965dE34f6b5a3D3546C94FE1809Cd82` |
## Common Patterns
### Create an agent treasury
bash
Deploy treasury via factory
paylobster treasury create "My Agent Fund"
View treasury info
paylobster treasury info
Set budget allocation
paylobster treasury budget --ops 4000 --growth 3000 --reserves 2000 --yield 1000
Grant operator access with spend limits
paylobster treasury grant --address 0xAGENT --role operator
paylobster treasury limit --address 0xAGENT --per-tx 100 --per-day 500
### Swap tokens
bash
Get a quote
paylobster swap quote --from USDC --to WETH --amount 50
Execute swap
paylobster swap execute --from USDC --to WETH --amount 50
Bridge to another chain
paylobster bridge execute --from base --to solana --token USDC --amount 100
### Invest in an agent's treasury
bash
Propose a revenue share investment
paylobster invest propose --treasury 0xAGENT_TREASURY --amount 500 \
--type revenue-share --duration 365 --share 1500
Fund the investment
paylobster invest fund 0
Check claimable returns
paylobster invest info 0
Claim returns
paylobster invest claim 0
View your portfolio
paylobster invest portfolio
### Agent paying for a service
bash
1. Check provider reputation
paylobster reputation 0xPROVIDER
2. Create escrow
paylobster escrow create --to 0xPROVIDER --amount 25
3. After delivery, release payment
paylobster escrow release
### Streaming payment for compute
bash
Pay $0.001/sec for 1 hour of inference
paylobster stream create --to 0xPROVIDER --rate 0.001 --duration 3600
### Multi-agent collaboration with revenue split
bash
Create a revenue share for a 3-agent pipeline
paylobster revenue-share create --participants '[
{"address":"0xA...","share":50},
{"address":"0xB...","share":30},
{"address":"0xC...","share":20}
]'
### Read-only queries (no wallet needed)
bash
curl https://paylobster.com/api/v3/reputation/0xADDRESS
curl https://paylobster.com/api/v3/escrows?creator=0xADDRESS
## Coinbase AgentKit Integration
Add PayLobster to any Coinbase AgentKit agent:
typescript
import { paylobsterActionProvider } from '@paylobster/agentkit-provider';
const agent = await createReactAgent({
llm: model,
walletProvider: wallet,
actionProviders: [paylobsterActionProvider()],
});
Actions: `paylobster_register_identity`, `paylobster_create_escrow`, `paylobster_release_escrow`, `paylobster_check_reputation`, `paylobster_get_credit_score`, `paylobster_get_agent_profile`.
## High-Level SDK (@paylobster/agent-toolkit)
PayLobster-first SDK with clean 4-line DX:
typescript
import { PayLobsterAgent } from '@paylobster/agent-toolkit';
const agent = new PayLobsterAgent({ network: 'base', wallet: 'coinbase' });
await agent.register({ name: 'MyAgent' });
const escrowId = await agent.escrow({ seller: '0x...', amount: 100 });
await agent.release(escrowId, { rating: 5 });
```
Resources
PayLobster
基于Base L2的自主代理金融操作系统。代理金库、代币兑换、跨链桥、法币出入金、无需信任托管、流式支付、链上信誉、预言机验证、信用评分、争议解决、级联托管、收入分成、支出授权、意图市场、合规授权、x402 HTTP原生支付、CDP服务器钱包v2集成、Coinbase支出权限、无Gas Paymaster操作以及Firebase实时事件。
新增:CDP集成(Coinbase开发者平台)
服务器钱包v2(TEE安全)
typescript
import { getCdpClient } from @/lib/cdp/client;
const cdp = getCdpClient();
const wallet = await cdp.evm.createAccount(); // TEE安全,无需管理密钥
x402协议(HTTP原生支付)
每个PayLobster API均可通过HTTP 402支付:
bash
发现端点
curl https://paylobster.com/api/x402/discovery
代理自动支付服务费用
GET /api/v3/reputation?address=0x...
→ 402 Payment Required (0.01 USDC)
→ 代理通过X-PAYMENT头支付
→ 服务执行
支出权限
typescript
import { createSpendPermission } from @/lib/cdp/permissions;
// 代理获得限额内的预批准支出
await createSpendPermission(treasury, agent, USDC, 100, 1); // 每天100 USDC
无Gas操作(Paymaster)
所有PayLobster合约交互均可通过CDP Paymaster赞助Gas费用。
Coinbase出入金
typescript
import { generateOnrampUrl } from @/lib/cdp/onramp;
const url = await generateOnrampUrl(agentAddress, 100, USD); // 法币 → USDC
SIWA — 代理登录
基于ERC-8004和ERC-8128构建的无信任代理认证。一个开放标准。无需API密钥。无需共享密钥。
验证代理
bash
curl -X POST https://paylobster.com/api/siwa/verify \
-H Content-Type: application/json \
-d {message: , signature: 0x...}
响应包含完整代理资料:信誉、信任等级、信用评分、徽章数量、托管历史。
MCP工具
- - siwaverify — 验证SIWA签名并获取完整代理资料
- siwanonce — 获取用于消息签名的新随机数
- siwa_profile — 查询任意代理的资料(无需认证)
SDK
typescript
import { createSIWAMessage, verifySIWAMessage } from pay-lobster;
// 代理端:创建并签名
const message = createSIWAMessage({ address: 0x..., domain: myapp.com, nonce });
const signature = await wallet.signMessage(message);
// 服务端:验证并获取资料
const result = await verifySIWAMessage(message, signature);
// → { verified: true, agent: { reputation: 95, trustTier: Diamond, ... } }
为什么选择PayLobster SIWA?
其他SIWA实现:是的,这个代理存在。
PayLobster SIWA:这个代理存在,拥有95信誉,完成了200次托管,钻石等级,从未输过任何争议。
每次SIWA认证都承载着代理经济中最丰富的身份信息。
自然语言支付
用简单英语发送支付——无需结构化API调用:
发送10 USDC到0xABC
托管50 USDC给0xABC
以每秒0.001 USDC向0xABC流式支付1小时
用50 USDC兑换ETH
将100 USDC桥接到以太坊
将100 USDC分给0xA(60%)和0xB(40%)
通过MCP
使用natural_pay工具——它解析意图,返回未签名交易+确认:
json
{
tool: natural_pay,
input: { instruction: 发送10 USDC到0xABC }
}
// → { intent: { action: transfer, amount: 10, token: USDC, recipient: 0xABC }, transaction: {...}, confirmation: 发送10 USDC到0xABC? }
通过API
bash
curl -X POST https://paylobster.com/api/v3/pay \
-H Content-Type: application/json \
-d {instruction: 发送10 USDC到0xABC, sender: 0x...}
通过CLI
bash
paylobster pay 发送10 USDC到0xABC
支持的动词:发送、支付、转账、给予、托管、持有、锁定、流式、兑换、交换、转换、桥接、拆分、分享、分配、打赏。
商户服务
像Stripe一样接受USDC支付——收款、支付链接、定期订阅和可嵌入结账小部件:
注册为商户
bash
通过CLI
paylobster merchant register --name 我的业务 --website https://example.com --wallet 0xABC
→ 返回API密钥(pklive...)和密钥(sklive...)
创建收款(Stripe风格)
bash
通过API
curl -X POST https://paylobster.com/api/v1/charges \
-H Authorization: Bearer sk
liveYOUR_SECRET \
-H Content-Type: application/json \
-d {amount: 25, currency: USDC, description: 代码审查服务}
定期订阅
bash
curl -X POST https://paylobster.com/api/v1/subscriptions \
-H Authorization: Bearer skliveYOUR_SECRET \
-H Content-Type: application/json \
-d {planname: 专业版, amount: 10, interval: monthly, customerwallet: 0x...}
可嵌入结账小部件
在任何网站上放置支付小部件:
html
MCP工具
- - merchantregister — 注册商户,获取API密钥
- merchantcreatecharge — 创建支付收款
- merchantcreatesubscription — 设置定期计费
- merchantget_charge — 检查收款状态
商户API端点
| 端点 | 描述 |
|---|
| POST /api/v1/merchants/register | 注册商户 |
| POST /api/v1/charges |
创建收款 |
| GET /api/v1/charges/{id} | 获取收款详情 |
| POST /api/v1/payment-links | 创建商户支付链接 |
| GET /api/v1/payment-links/{id} | 获取链接详情 |
| POST /api/v1/subscriptions | 创建订阅 |
| POST /api/v1/subscriptions/{id}/approve | 客户批准 |
| POST /api/v1/subscriptions/{id}/cancel | 取消订阅 |
| POST /api/v1/subscriptions/charge | 处理计费 |
商户仪表板
完整商户仪表板在paylobster.com/merchant——管理API密钥、支付链接、查看交易、追踪收入。
支付链接
可分享的支付URL——放入任何私信、电子邮件或聊天中。无需SDK。
创建支付链接
bash
通过CLI
paylobster link create --amount 10 --memo 代码审查 --recipient 0xABC
→ https://paylobster.com/pay/a1b2c3d4
paylobster split create --total 90 --participants [
{label:Alice,share:33},{label:Bob,share:33},{label:Carol,share:34}
] --memo 晚餐
→ https://paylobster.com/split/x7y8z9
typescript
// 通过SDK
const link = await lobster.links.create({
amount: 10,
recipient: 0xABC...,
memo: 代码审查,
mode: escrow, // 或 direct
});
console.log(link.url); // https://paylobster.com/pay/a1b2c3d4
通过MCP
- - createpaymentlink — 创建可分享的支付URL
- createsplitlink — 创建群组分摊支付URL
- getpaymentlink — 通过