# Fatura oluştur

## İstek

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

## İstek parametreleri

| Parametre | Veri türü | Açıklama | Örnek | Zorunlu mu? |
| --- | --- | --- | --- | --- |
| `projectId` | UUID | UUID biçiminde proje ID'si | 1c48b092-9878-48f5-b441-07a8a48e7b54 | evet |
| `amountFiat` | Float | İtibari para cinsinden tutar | 10.55 | evet |
| `currencyFiat` | String | İtibari para birimi. İzin verilen değerler: USD, EUR, RUB | EUR | evet |
| `description` | String | Ürün veya hizmetin açıklaması. Ödeme sayfasında alıcıya gösterilir | 12 months license for BITSBY | hayır |
| `serviceData` | String | Mağaza tarafındaki sipariş tanımlayıcısı. Alıcıya gösterilmez. Bu veri, faturayı ve ödemeyi satıcının mağazasındaki alıcıyla ilişkilendirir. JSON bunun için kullanışlı bir biçimdir | {"userId":100,"orderId":500} | hayır |
| `timeToPay` | Float | Faturanın ödenme süresi, saat cinsinden. İzin verilen değerler: 0.5, 1, 3, 6, 12 | 1 | evet |

## Yanıt örneği

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

## Yanıt parametreleri

| Parametre | Açıklama |
| --- | --- |
| `id` | UUID biçiminde fatura ID'si |
| `uid` | Fatura ID'si (alıcı için) |
| `createDatetime` | Faturanın oluşturulma tarihi ve saati (UTC) |
| `timeToPayDatetime` | Faturanın geçerli olduğu son tarih ve saat (UTC). Alıcı, faturayı bu zamandan önce ödemelidir |
| `commissionFiatUSD` | Hizmet ücreti tutarı. `amountFiatUSD` tutarından hesaplanır |
| `amountFiatUSD` | USD cinsinden tutar, fatura oluşturulurken `invoice.amountFiat` değerinden güncel kura göre hesaplanır |
| `url` | Alıcı için ödeme sayfasının bağlantısı. Faturanın ödenmesi için bu bağlantıyı alıcıya gönderin |