Create LNURL Pay invoice

To retrieve LNURL Pay invoice for customer and for merchants need to setup webhook.

LNURL is a protocol used in the world of Bitcoin and Lightning Network (LN) to facilitate various types of interactions and payments. LNURL stands for "Lightning Network URL," and it is designed to simplify the process of setting up and executing Lightning Network transactions and services.

Kaminari provides two options, first one returns LNURL Pay invoice for user.

Swagger UI: GET /gateway/api/lightning/v1/lnurl/address

curl --location --request GET 'https://api.kaminari.cloud/gateway/api/lightning/v1/lnurl/address?nonce=1699926593' \
--header 'X-kaminari-api-key: <API_KEY>' \
--header 'X-kaminari-api-signature: <API_SIGNATURE>' \
--header 'Content-Type: application/json' \

Response

{
    "invoice":"LNURL1DP68GURN8GHJ7CTSDYKKGETK9E4KZMTFDESHY6FWVDKX7ATY9ANKZAR9WASHJTMPWP5J7MRFVA58GMNFDENJ7A339AKXUATJDSHKZERYWFJHXUE0D9HXVMELW4EK2UJLD9JR6EFKVSCNXETXVGKKGDE3XYKNGE3NXQKNSWFHVSKNZWFCVS6RZETPVC6RWDSKNKEWU"
}

Second one returns LNURL for merchant.

Swagger UI: GET /gateway/api/lightning/v1/lnurl/address/for/merchant/<merchant_id>

curl --location --request GET 'https://api.kaminari.cloud/gateway/api/lightning/v1/lnurl/address/for/merchant/<MERCHANT_ID>' \
--header 'X-kaminari-api-key: <API_KEY>' \
--header 'X-kaminari-api-signature: <API_SIGNATURE>' \
--header 'Content-Type: application/json' \

Response

{
    "invoice": "LNURL1DP68GURN8GHJ7CTSDYKKGETK9E4KZMTFDESHY6FWVDKX7ATY9ANKZAR9WASHJTMPWP5J7MRFVA58GMNFDENJ7A339AKXUATJDSHKZERYWFJHXUE0D9HXVME0D4JHYCMGV9H8G0M4WDJHYHMFVS7K2DNYXYEK2ENZ94JRWVF3956XVVES95URJDMY95CNJWRYXSCK2CTXXSMNVFNDV4EXX6RPDE6976TY848X7APQWDCX2CMFVE5K2EQ046LT9"
}

When somebody will create LN for merchant invoice from LNURL, customer will be notified with webhook. After successful payment Kaminari will make customer known.