# 提交订单

> 法币下单，商户可以通过支付链接引导用户跳转至 UPay 的 Ramp 收银台付款。在用户支付成功后，系统将即时进行**回调通知**。

**请求地址：**/v1/api/open/ramp/apply

**请求方式：**POST

**请求类型：**application/json

**请求参数：**

<table><thead><tr><th width="180">字段名称</th><th width="140">字段类型</th><th width="97">是否必填</th><th width="98">是否签名</th><th>示例值</th><th>说明</th></tr></thead><tbody><tr><td>appId</td><td>string(8)</td><td><strong>是</strong></td><td><strong>是</strong></td><td>Zu78qwe1</td><td>APP ID</td></tr><tr><td>merchantOrderNo</td><td>string(14-32)</td><td><strong>是</strong></td><td><strong>是</strong></td><td>Order202409291231</td><td>商户端自主生成的订单号，在商户端要保证唯一性</td></tr><tr><td>chainType</td><td>string(1)</td><td><strong>是</strong></td><td><strong>是</strong></td><td>1</td><td><p>链路：</p><p>1: 波场(TRC20) </p><p>2: 以太坊(ERC20)</p></td></tr><tr><td>attach</td><td>string(64)</td><td>否</td><td>否</td><td>自定义</td><td>用户自定义数据，在回调到  notifyUrl 的时候会原样返回</td></tr><tr><td>toAddress</td><td>string(32-64)</td><td>是</td><td>是</td><td>TAsnassdajsadjasdjxxxxxxxxxxxxx</td><td>商户收款地址</td></tr><tr><td>notifyUrl</td><td>string(256)</td><td><strong>是</strong></td><td><strong>是</strong></td><td>https://callbacknotify.com/callback</td><td>接收异步通知的回调地址。必须为可直接访问的 URL，不能带参数、session 验证、csrf 验证</td></tr><tr><td>redirectUrl</td><td>string(256)</td><td>否</td><td>否</td><td>https://productdetail.com</td><td>支付成功后，前端重定向地址。务必包含 http:// 或 https:// 开头</td></tr><tr><td>products</td><td>[]array</td><td>是</td><td>是</td><td>products示例</td><td>商品列表</td></tr><tr><td>signature</td><td>string(32)</td><td><strong>是</strong></td><td><strong>是</strong></td><td>6F3B90783FABE56DBB771D03E0EAADD0</td><td>数据签名，详见：<a href="../introduction/signature">签名算法</a></td></tr></tbody></table>

**products：**

<table><thead><tr><th width="145">字段名称</th><th width="127.66666666666666">字段类型</th><th>是否必填</th><th>是否签名</th><th>示例值</th><th width="189">说明</th></tr></thead><tbody><tr><td>name</td><td>string(64)</td><td>是</td><td>是</td><td>T-shirt</td><td>商品名称</td></tr><tr><td>description</td><td>string(128)</td><td>是</td><td>是</td><td>goods desc</td><td>商品描述</td></tr><tr><td>quantity</td><td>string(3)</td><td>是</td><td>是</td><td>1</td><td>数量</td></tr><tr><td>fiatAmount</td><td>string(10)</td><td>是</td><td>是</td><td>699</td><td>单价，法币金额，精确到小数点后 2 位</td></tr><tr><td>fiatCurrency</td><td>string(3)</td><td>是</td><td>是</td><td>JPY</td><td>法币ISO代码，<a href="https://popodao.notion.site/727f322faa104f0d9b1c7cac8e9bc28f?v=f2e607d4d3aa431f8187bb28bca2c69b">支持的币种</a></td></tr></tbody></table>

**返回值 data 参数：**

<table><thead><tr><th>字段名称</th><th width="172.66666666666666">字段类型</th><th>说明</th></tr></thead><tbody><tr><td>orderNo</td><td>string</td><td>UPay 订单号</td></tr><tr><td>merchantOrderNo</td><td>string</td><td>商户订单号</td></tr><tr><td>payUrl</td><td>string</td><td>收银台地址，商户可直接跳转到该地址供用户支付</td></tr></tbody></table>