身份验证 - Puffin Pay

API 密钥

服务器到服务器的端点使用 X-API-Key 请求头进行身份验证：

curl https://api.puffinmoney.com/v1/gateway/api/payment-intents/9b1f... \
  -H "X-API-Key: mk_live_..."

每个 IP 每分钟 120 次请求。429 响应包含标准的 X-RateLimit-* 请求头。

{ "error": { "code": "invalid_api_key", "message": "Invalid or revoked API key" } }

错误码	含义
`missing_api_key` / `invalid_api_key`	请求头缺失、已撤销，或商户账户未激活
`unsupported_asset`	代币/链组合不受支持
`validation_error`	请求体格式错误——错误信息会指出具体字段
`not_found`	资源不存在或不属于您
`plan_limit`	已达到钱包/团队配额上限——请升级套餐