Skip to main content
POST
/
v1
/
wallet
/
fund
curl -X POST https://api.saturn-pay.com/v1/wallet/fund \
  -H "Authorization: Bearer sk_agt_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amountSats": 10000
  }'

{
  "paymentRequest": "lnbc100u1p3h9j2xpp5...",
  "paymentHash": "abc123def456...",
  "amountSats": 10000,
  "expiresAt": "2024-01-20T16:00:00Z"
}
Creates a Lightning Network invoice that, when paid, will credit your wallet with the specified amount of satoshis.

​
Request

​
amountSats
number
required
Amount in satoshis to add to wallet

​
Response

​
paymentRequest
string
Lightning invoice (BOLT11 format). Pay this with any Lightning wallet.
​
paymentHash
string
Payment hash for tracking
​
amountSats
number
Invoice amount in satoshis
​
expiresAt
string
ISO 8601 timestamp when invoice expires
curl -X POST https://api.saturn-pay.com/v1/wallet/fund \
  -H "Authorization: Bearer sk_agt_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amountSats": 10000
  }'

{
  "paymentRequest": "lnbc100u1p3h9j2xpp5...",
  "paymentHash": "abc123def456...",
  "amountSats": 10000,
  "expiresAt": "2024-01-20T16:00:00Z"
}

​
Notes

  • Invoice expires after 1 hour
  • Credits are added instantly when payment is received
  • No minimum amount
  • No fees charged by Saturn (you pay Lightning routing fees)