Skip to main content

Create LNURL/LN address payment quote

Endpoint accepts idempotency-key header to prevent the same quote from being created twice. In case of a duplicate request, the error code DUPLICATE_PAYMENT_QUOTE containing the id of the original quote (paymentQuoteId) will be returned. The key should be a random v4 UUID to avoid false collisions.

Required scopes:

  • partner.payment-quote.lightning.create

Header Parameters
idempotency-key uuid
Request Body REQUIRED
lnAddressOrUrl string REQUIRED

LN Address or LNURL to pay to.

sourceCurrency string REQUIRED

Possible values: [BTC, USD, EUR, USDT, GBP]

Currency to spend. If BTC is specified then amount.currency must also be BTC.

amount object REQUIRED

Amount to send.

amount string REQUIRED

Currency amount in decimal format

currency string REQUIRED

Possible values: [BTC, USD, EUR, USDT, GBP]

Currency code

description string

Possible values: 1 ≤ length

Payment description. Can be set only if the LNURL service allows comment. Max length of the description is defined by the commentAllowed property of the GET LNURL details endpoint response.

Responses
200

OK

Schema OPTIONAL
lightningNetworkFee object OPTIONAL

The fee required by LN network

amount string

Currency amount in decimal format

currency string

Possible values: [BTC, USD, EUR, USDT, GBP]

Currency code

paymentQuoteId uuid

The payment quote's ID

description string OPTIONAL

The description forwarded from the related invoice

validUntil date-time OPTIONAL

The expiry timestamp

conversionRate object OPTIONAL

The conversion rate details

amount string

Currency amount in decimal format

sourceCurrency string

Possible values: [BTC, USD, EUR, USDT, GBP]

Source currency code

targetCurrency string

Possible values: [BTC, USD, EUR, USDT, GBP]

Target currency code

amount object

The amount that the receiver will receive in sender’s currency

amount string

Currency amount in decimal format

currency string

Possible values: [BTC, USD, EUR, USDT, GBP]

Currency code

totalFee object OPTIONAL

The total of all fees

amount string

Currency amount in decimal format

currency string

Possible values: [BTC, USD, EUR, USDT, GBP]

Currency code

totalAmount object

The amount that the sender will spend

amount string

Currency amount in decimal format

currency string

Possible values: [BTC, USD, EUR, USDT, GBP]

Currency code

reward object OPTIONAL

The reward that the sender might receive, if applicable

amount string

Currency amount in decimal format

currency string

Possible values: [BTC, USD, EUR, USDT, GBP]

Currency code