# 创建收款单

## 请求

```bash
curl -X POST https://api.bitsby.app/invoices/create \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "projectId=9deea1e2-0c08-41a3-bdc2-a34eada3892d" \
	-F "amountFiat=10.55" \
	-F "currencyFiat=EUR" \
	-F "description=12 months license for BITSBY" \
	-F "serviceData={\"userId\":100,\"orderId\":500}" \
	-F "timeToPay=12"
```

## 请求参数

| 参数           | 数据类型 | 说明                                                                                             | 示例                                 | 是否必填 |
| -------------- | -------- | ------------------------------------------------------------------------------------------------ | ------------------------------------ | -------- |
| `projectId`    | UUID     | 项目 ID，UUID 格式                                                                               | 1c48b092-9878-48f5-b441-07a8a48e7b54 | 是       |
| `amountFiat`   | Float    | 法币金额                                                                                         | 10.55                                | 是       |
| `currencyFiat` | String   | 法币币种。可选值：USD、EUR、RUB                                                                  | EUR                                  | 是       |
| `description`  | String   | 商品或服务的描述，在支付页面向买家展示                                                           | 12 个月的 BITSBY 许可证              | 否       |
| `serviceData`  | String   | 店铺侧的订单标识，不向买家展示。这些数据将收款单和付款与商户店铺中的买家关联起来。JSON 是适合它的格式 | {"userId":100,"orderId":500}         | 否       |
| `timeToPay`    | Float    | 收款单的支付期限，单位为小时。可选值：0.5、1、3、6、12                                           | 1                                    | 是       |

## 响应示例

```json
{
   "result":"success",
   "data":{
      "id":"ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c",
      "uid":"MXNj4m8HhcM4",
      "createDatetime":"2024-02-29 15:20:24",
      "timeToPayDatetime":"2024-03-01 03:20:24",
      "commissionFiatUSD":0.1,
      "amountFiatUSD":10,
      "url":"https:\/\/dash.bitsby.app\/invoices\/pay\/MXNj4m8HhcM4"
   }
}
```

## 响应参数

| 参数                | 说明                                                                                           |
| ------------------- | ---------------------------------------------------------------------------------------------- |
| `id`                | 收款单 ID，UUID 格式                                                                           |
| `uid`               | 收款单 ID（面向买家）                                                                          |
| `createDatetime`    | 收款单创建日期和时间 (UTC)                                                                     |
| `timeToPayDatetime` | 收款单有效期截止的日期和时间 (UTC)。买家须在此时间之前支付收款单                               |
| `commissionFiatUSD` | 服务费金额，按 `amountFiatUSD` 金额计算                                                        |
| `amountFiatUSD`     | 以 USD 计的金额，在创建收款单时按当前汇率由 `invoice.amountFiat` 换算得出                      |
| `url`               | 面向买家的支付页面链接。将此链接发送给买家以支付收款单                                         |