支付

用发票接受一笔加密支付

用加密收款归结为三步:为某金额创建发票、把付款人引导至收银台,并对结算 webhook 作出反应。处理、地址管理与确认跟踪都为你代办。

开始之前
  • 一把有效 API 密钥
  • 一个已配置的 webhook 端点与签名密钥

1创建发票

为一个法币计价金额与你接受的链请求发票。你将获得一个收款地址与一个收银台 URL。

curl https://api.1st-node.com/v1/payments/invoices \
  -H "Authorization: Bearer sk_live_..." \
  -d '{"amount_usd":49,"accept":["eth","tron"]}'

2展示收银台

把付款人重定向至返回的收银台 URL,或自行渲染地址与金额。发票会跟踪少付、多付与确认数。

3通过 webhook 确认

结算时,一个签名 webhook(HMAC-SHA256)携带发票 id 与状态触发。校验签名后标记订单已付。webhook 投递是幂等的——重复事件不会重复入账。

> POST /your/webhook  X-Signature: <hmac>
> { "invoice":"in_..","status":"settled","amount_usd":49 }

常见问题

我如何信任该 webhook?

每个事件都用对原始正文做 HMAC-SHA256 签名。用你的密钥重新计算并拒绝不匹配。

我能既收款又付款吗?

可以——批量付款与结算是同一余额上的同类支付原语。

继续阅读

充值、拿密钥、上线。

自助开通。支持加密货币或银行卡。按额度计费——重型原语更贵,简单调用很便宜。

获取 API 密钥