Fund Account

Add satoshis to your prepaid API Key balance to skip per-order invoices.

POST https://api2.sms4sats.com/fund

Creates a Lightning invoice to top up a prepaid API Key balance. Once funded, you can use immediate: true on order endpoints to skip per-order invoice payment and deduct directly from your balance.

Headers

Name	Type	Required	Description
X-API-Key	String	Yes	Your API Key to fund.

Request Body

Name	Type	Required	Description
amount	Number	Yes	Amount in satoshis to add to your balance.

200: OK

{
    status: 'OK', 
    orderId: '7dc6e6b61d8c54dff6b8d6ea2e3f08b018e57963df81d493a6f9728c4dc83318', 
    payreq: 'lnbc30u1p34yef6pp5...'
}

500: Internal Server Error

Response Fields

Field	Type	Description
status	String	OK on success
orderId	String	Funding order ID
payreq	String	BOLT11 Lightning invoice to pay to fund your balance

Once the invoice is paid, your balance is credited and visible via Get Balance. You can then use immediate: true when creating orders to deduct directly without receiving a new invoice each time.

Get in touch for volume discounts: [email protected].