Coinbase Onramp 报价、订单状态、费用与网络风险清单
已验证事实边界
1. Coinbase's Onramp Quote API documentation describes quote inputs such as purchase currency, payment amount, payment currency, payment method and country. 2. The Coinbase quote documentation says the returned quote is an estimate and does not guarantee completion or final fees. 3. The quote response fields include payment total, payment subtotal, purchase amount, Coinbase fee, network fee, quote ID and, when applicable, an onramp URL. 4. Coinbase's order-by-ID endpoint documents order status, payment totals, purchase amount, fees, destination address, destination network and transaction hash fields. 5. Coinbase payment-method sandbox documentation says the sandbox uses pre-provisioned mock payment methods and does not connect to real bank or payment networks. 6. An onramp workflow should not release product value solely from an initial quote; it should reconcile order status and destination evidence.
收起完整分析
决策矩阵
文章表格：可横向滑动，或聚焦表格区域后使用方向键。
| Check | What it means | Practical action | Unknown to keep explicit |
|---|---|---|---|
| Quote status | a quote is a displayed estimate, not settlement evidence | label quote output as estimate and record the quote ID | fee movement after quote creation |
| Order lookup | the order endpoint is the later state evidence layer | poll or retrieve order status before releasing fulfillment | provider-side delayed state transitions |
| Fee disclosure | network and exchange fees can change between quote and completion | show fee components separately and avoid final-fee guarantees | network congestion after quote |
| Destination network | wrong network or destination can make recovery account-specific | confirm destination network before user confirmation | wallet support for recovery |
| Sandbox boundary | test flows are not proof that production identity or payment rails are approved | keep sandbox evidence separate from live readiness | regional payment method availability |
| Fulfillment hold | merchant fulfillment should wait for coherent status evidence | hold delivery until order state and destination evidence match | chargeback or reversal handling |
| Privacy stop rule | debug evidence can expose payment and wallet information | store only non-secret status labels, URL, time and order reference | support-only private account information |
来源地图
- Coinbase Developer Platform：Generating Quotes（coinbase-onramp-quotes）
- Coinbase Developer Platform：Get an onramp order by ID（coinbase-onramp-order）
- Coinbase Developer Platform：Payment Methods Quickstart（coinbase-payments-sandbox）
控制说明
1. Quote status
这一项要求读者先把公开来源翻译成操作规则。这里的含义是：a quote is a displayed estimate, not settlement evidence。可执行动作是：label quote output as estimate and record the quote ID。仍然未知的是：fee movement after quote creation。因此本文不会把未知部分包装成收益承诺、牌照承诺、审批保证、恢复保证、结算保证、可用性保证、价格暗示或平台排名。
2. Order lookup
这里的含义是：the order endpoint is the later state evidence layer。可执行动作是：poll or retrieve order status before releasing fulfillment。仍然未知的是：provider-side delayed state transitions。
操作测试也必须很窄。这就是本节保留边界的原因。
3. Fee disclosure
这里的含义是：network and exchange fees can change between quote and completion。可执行动作是：show fee components separately and avoid final-fee guarantees。仍然未知的是：network congestion after quote。
操作测试也必须很窄。这就是本节保留边界的原因。
4. Destination network
这里的含义是：wrong network or destination can make recovery account-specific。可执行动作是：confirm destination network before user confirmation。仍然未知的是：wallet support for recovery。
操作测试也必须很窄。这就是本节保留边界的原因。
5. Sandbox boundary
这里的含义是：test flows are not proof that production identity or payment rails are approved。可执行动作是：keep sandbox evidence separate from live readiness。仍然未知的是：regional payment method availability。
操作测试也必须很窄。这就是本节保留边界的原因。
6. Fulfillment hold
这里的含义是：merchant fulfillment should wait for coherent status evidence。可执行动作是：hold delivery until order state and destination evidence match。仍然未知的是：chargeback or reversal handling。
操作测试也必须很窄。这就是本节保留边界的原因。
7. Privacy stop rule
这里的含义是：debug evidence can expose payment and wallet information。可执行动作是：store only non-secret status labels, URL, time and order reference。仍然未知的是：support-only private account information。
操作测试也必须很窄。这就是本节保留边界的原因。
仍需明确的未知项
- fee movement after quote creation
- provider-side delayed state transitions
- network congestion after quote
- wallet support for recovery
- regional payment method availability
- chargeback or reversal handling
- support-only private account information
实用结论
Coinbase Onramp 集成应把 quote 视为 estimate，把 order lookup 视为后续证据层。Coinbase 文档说明 Onramp Quote API 返回 payment total、payment subtotal、purchase amount、Coinbase fee、network fee、quote ID 和可选 onramp URL，同时提示 quote 是 estimate，实际费用可能不同；Coinbase 还提供 order-by-ID endpoint，包含 order status、fees、destination network 和 transaction hash 字段。实用结论是：quote display、fee disclosure、state polling、sandbox testing 与 fulfillment release 必须分开控制。 本文停在证据边界内，帮助读者决定下一步核验什么，而不是把公开文档改写成私人账户、钱包、回调、政策框架、结算路径或流动性头寸在任何未来条件下都能成功的承诺。
相关专题与工具:交易所手续费计算器