创建收款单

请求

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"

请求参数

参数	数据类型	说明	示例	是否必填
projectId	UUID	项目 ID，UUID 格式	1c48b092-9878-48f5-b441-07a8a48e7b54	是
amountFiat	Float	法币金额	10.55	是
currencyFiat	String	法币币种。可选值：USD、EUR、RUB	EUR	是
description	String	商品或服务的描述，在支付页面向买家展示	12 个月的 BITSBY 许可证	否
serviceData	String	店铺侧的订单标识，不向买家展示。这些数据将收款单和付款与商户店铺中的买家关联起来。JSON 是适合它的格式	{"userId":100,"orderId":500}	否
timeToPay	Float	收款单的支付期限，单位为小时。可选值：0.5、1、3、6、12	1	是

响应示例

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

响应参数

参数	说明
id	收款单 ID，UUID 格式
uid	收款单 ID（面向买家）
createDatetime	收款单创建日期和时间 (UTC)
timeToPayDatetime	收款单有效期截止的日期和时间 (UTC)。买家须在此时间之前支付收款单
commissionFiatUSD	服务费金额，按 amountFiatUSD 金额计算
amountFiatUSD	以 USD 计的金额，在创建收款单时按当前汇率由 invoice.amountFiat 换算得出
url	面向买家的支付页面链接。将此链接发送给买家以支付收款单