# Criar uma cobrança

## Requisição

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

## Parâmetros da requisição

| Parâmetro      | Tipo de dado | Descrição                                                                                                                                                                | Exemplo                              | Obrigatório? |
| -------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------------ |
| `projectId`    | UUID         | ID do projeto no formato UUID                                                                                                                                            | 1c48b092-9878-48f5-b441-07a8a48e7b54 | sim          |
| `amountFiat`   | Float        | Valor em moeda fiat                                                                                                                                                      | 10.55                                | sim          |
| `currencyFiat` | String       | Moeda fiat. Valores permitidos: USD, EUR, RUB                                                                                                                            | EUR                                  | sim          |
| `description`  | String       | Descrição do produto ou serviço. Exibida ao cliente na página de pagamento                                                                                               | 12 months license for BITSBY         | não          |
| `serviceData`  | String       | Identificador do pedido no lado da loja. Não é exibido ao cliente. Esses dados associam a cobrança e o pagamento ao cliente na loja do lojista. JSON é um formato conveniente para isso | {"userId":100,"orderId":500}         | não            |
| `timeToPay`    | Float        | Tempo para pagar a cobrança, em horas. Valores permitidos: 0.5, 1, 3, 6, 12                                                                                              | 1                                    | sim          |

## Exemplo de resposta

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

## Parâmetros da resposta

| Parâmetro           | Descrição                                                                                                     |
| ------------------- | ------------------------------------------------------------------------------------------------------------- |
| `id`                | ID da cobrança no formato UUID                                                                                |
| `uid`               | ID da cobrança (para o cliente)                                                                               |
| `createDatetime`    | Data e hora de criação da cobrança (UTC)                                                                      |
| `timeToPayDatetime` | Data e hora até as quais a cobrança é válida (UTC). O cliente deve pagar a cobrança antes desse horário       |
| `commissionFiatUSD` | Valor da taxa do serviço. Calculado a partir do valor `amountFiatUSD`                                         |
| `amountFiatUSD`     | Valor em USD, calculado na criação da cobrança a partir de `invoice.amountFiat` pela cotação atual            |
| `url`               | Link da página de pagamento para o cliente. Envie este link ao cliente para pagar a cobrança                  |