Créer une facture

Requête

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"

Paramètres de la requête

Paramètre	Type de données	Description	Exemple	Obligatoire ?
projectId	UUID	ID du projet au format UUID	1c48b092-9878-48f5-b441-07a8a48e7b54	oui
amountFiat	Float	Montant en devise fiat	10.55	oui
currencyFiat	String	Devise fiat. Valeurs autorisées : USD, EUR, RUB	EUR	oui
description	String	Description du produit ou du service. Affichée au client sur la page de paiement	12 months license for BITSBY	non
serviceData	String	Identifiant de la commande côté boutique. Non affiché au client. Ces données relient la facture et le paiement au client dans la boutique du marchand. Le JSON est un format pratique pour cela	{"userId":100,"orderId":500}	non
timeToPay	Float	Délai de paiement de la facture, en heures. Valeurs autorisées : 0.5, 1, 3, 6, 12	1	oui

Exemple de réponse

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

Paramètres de la réponse

Paramètre	Description
id	ID de la facture au format UUID
uid	ID de la facture (pour le client)
createDatetime	Date et heure de création de la facture (UTC)
timeToPayDatetime	Date et heure de fin de validité de la facture (UTC). Le client doit payer la facture avant cette heure
commissionFiatUSD	Montant de la commission du service. Calculé à partir du montant amountFiatUSD
amountFiatUSD	Montant en USD, calculé à la création de la facture à partir de invoice.amountFiat au taux de change actuel
url	Lien vers la page de paiement pour le client. Envoyez ce lien au client pour payer la facture