Fatura oluştur

İstek

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

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