# Membuat tagihan

## Permintaan

```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"
```

## Parameter permintaan

| Parameter      | Tipe data | Deskripsi                                                                                                                                                                  | Contoh                               | Wajib?    |
| -------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | --------- |
| `projectId`    | UUID      | ID proyek dalam format UUID                                                                                                                                                | 1c48b092-9878-48f5-b441-07a8a48e7b54 | ya        |
| `amountFiat`   | Float     | Jumlah dalam mata uang fiat                                                                                                                                                | 10.55                                | ya        |
| `currencyFiat` | String    | Mata uang fiat. Nilai yang diizinkan: USD, EUR, RUB                                                                                                                        | EUR                                  | ya        |
| `description`  | String    | Deskripsi produk atau jasa. Ditampilkan kepada pembeli di halaman pembayaran                                                                                               | 12 months license for BITSBY         | tidak     |
| `serviceData`  | String    | Identifikasi pesanan di sisi toko. Tidak ditampilkan kepada pembeli. Data ini mengaitkan tagihan dan pembayaran dengan pembeli di toko merchant. JSON adalah format yang praktis untuknya | {"userId":100,"orderId":500}         | tidak            |
| `timeToPay`    | Float     | Waktu untuk membayar tagihan, dalam jam. Nilai yang diizinkan: 0.5, 1, 3, 6, 12                                                                                            | 1                                    | ya        |

## Contoh respons

```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"
   }
}
```

## Parameter respons

| Parameter           | Deskripsi                                                                                                     |
| ------------------- | ------------------------------------------------------------------------------------------------------------- |
| `id`                | ID tagihan dalam format UUID                                                                                  |
| `uid`               | ID tagihan (untuk pembeli)                                                                                    |
| `createDatetime`    | Tanggal dan waktu pembuatan tagihan (UTC)                                                                     |
| `timeToPayDatetime` | Tanggal dan waktu hingga kapan tagihan berlaku (UTC). Pembeli harus membayar tagihan sebelum waktu ini        |
| `commissionFiatUSD` | Jumlah biaya layanan. Dihitung dari jumlah `amountFiatUSD`                                                    |
| `amountFiatUSD`     | Jumlah dalam USD, dihitung saat pembuatan tagihan dari `invoice.amountFiat` berdasarkan kurs terkini          |
| `url`               | Tautan halaman pembayaran untuk pembeli. Kirim tautan ini kepada pembeli untuk membayar tagihan               |