Add Invoice V2

❗️

Fiat Amount

In some rare case you will not be credited of the exact amount inputed.
The amount credited to your account is the amount in fiat converted from the amount of sats at settlement time.

🚧

Webhook

A best practice is to set a WebHookUrl and WebhookSecret when you create an Invoice.
This will allow us to notify you when the invoice is paid.

The secret is here to make sure that we are triggering your WebHook.
When you receive the WebHook, make sure that the secret match the one you gave us when created the invoice.

📘

Webhook Body

If you set a WebHookUrl, this url will be called via a POST request with the following json body:

{
  "hash": string,
  "settledAtUtc": string,
  "receivedMsat": int,
  "transaction": {
    "id": string,
    "createdAt": string,
    "accountId": string,
    "amount": float,
    "networkFee": float,
    "exchangeRateCurrencySats": float,
    "currencyID": int,
    "transactionTypeId": int,
    "invoice": {
      "hash": string,
      "bolt11": string,
      "preImage": string,
      "memo": string,
      "creationDateUtc": string,
      "expiryDateUtc": string,
      "settleDateUtc": string,
      "amountMsat": int,
      "receiveMsat": int,
      "stateId": 1,
      "state": {
        "id": int,
        "name": sting,
        "description": string
      }
    }
  }
}

Date example: "2022-11-09T21:33:47.48778Z"

📘

Invoice state

Check the invoice state table: invoice-states-table