Crear una factura

Solicitud

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 de la solicitud

Parámetro	Tipo de dato	Descripción	Ejemplo	¿Obligatorio?
projectId	UUID	ID del proyecto en formato UUID	1c48b092-9878-48f5-b441-07a8a48e7b54	sí
amountFiat	Float	Importe en moneda fiat	10.55	sí
currencyFiat	String	Moneda fiat. Valores permitidos: USD, EUR, RUB	EUR	sí
description	String	Descripción del producto o servicio. Se muestra al cliente en la página de pago	12 months license for BITSBY	no
serviceData	String	Identificador del pedido en el lado de la tienda. No se muestra al cliente. Estos datos asocian la factura y el pago con el cliente en la tienda del comercio. JSON es un formato cómodo para ellos	{"userId":100,"orderId":500}	no
timeToPay	Float	Tiempo para pagar la factura, en horas. Valores permitidos: 0.5, 1, 3, 6, 12	1	sí

Ejemplo de respuesta

{
   "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 de la respuesta

Parámetro	Descripción
id	ID de la factura en formato UUID
uid	ID de la factura (para el cliente)
createDatetime	Fecha y hora de creación de la factura (UTC)
timeToPayDatetime	Fecha y hora hasta la que la factura es válida (UTC). El cliente debe pagar la factura antes de esa hora
commissionFiatUSD	Importe de la comisión del servicio. Se calcula a partir del importe amountFiatUSD
amountFiatUSD	Importe en USD, calculado al crear la factura a partir de invoice.amountFiat al tipo de cambio actual
url	Enlace a la página de pago para el cliente. Envía este enlace al cliente para pagar la factura