LogoLogo
Go to Bitcoin Support Home
  • Why we recommend BTCPay Server
  • Guide Overview
  • 🛫Deployment
    • Choosing a Deployment Method
      • LunaNode
      • Bull Bitcoin Hosting
      • Use Your Own Hardware
  • 🏪Create Your Store
    • Account Registration
    • Build Your Store
    • Customize Your Store
    • Connect Your Wallet
      • Hardware Wallet Integration
    • Connecting to an e-commerce platform
    • Issuing Refunds
    • Accounting
  • 🔗Setup Your Apps
    • Overview
    • Point of Sale App
    • Crowdfunding App
    • Payment Button
    • Payment Requests
  • ⚡Enabling Lightning
    • Activating Your Lightning Wallet
    • Get Inbound Capacity
    • Accessing the Lightning Wallet
    • Withdrawing Your Bitcoins
  • 🎆Additional Configurations
    • Setting Exchange Rate Provider
    • Configuring Users
    • Two-factor authentication
Powered by GitBook
On this page
  • Create a Payment Request
  • Customize Your Payment Requests

Was this helpful?

Edit on GitHub
Export as PDF
  1. Setup Your Apps

Payment Requests

PreviousPayment ButtonNextActivating Your Lightning Wallet

Last updated 3 years ago

Was this helpful?

Payment Requests are a feature which allows BTCPay store owners to create long-lived invoices. Funds paid to a payment request use the exchange rate at the time of payment. This allows users to make payments at their convenience without having to negotiate or verify exchange rates with the store owner at the time of payment.

Users can pay requests in partial payments. The payment request will remain valid until it is paid in full or if the store owner requires an expiration time. Addresses are never reused.

A new address is generated each time the user clicks pay to create an invoice for the payment request.

Store owners can also print payment requests (or export invoice data) for record keeping and accounting. BTCPay automatically labels invoices as Payment Requests in your store's invoice list.

Create a Payment Request

Click Payment Requests > Create new payment request.

Provide the Request Name, Amount, Display Denomination, Associated Store, Expiration Time & Description (Optional).

Select the option Allow payee to create invoices in their own denomination if you want to allow partial payments to be made.

Payment requests are store-dependent, which means that each payment request is associated with a store during creation. Be sure to have a wallet connected to your store which the payment request belongs to.

Click Save & View to review your payment request.

BTCPay creates a URL for the payment request. Share this URL to view your payment request.

The status will appear as Settled if the payment has been received in full. If only a partial payment was made, the Amount Due will show the balance due.

Customize Your Payment Requests

  • Invoice Amount - Set Requested Payment Amount

  • Denomination - Show Requested Amount in Fiat or Cryptocurrency

  • Payment Quantity - Allow only single payments or partial payments

  • Expiration Time - Allow payments until a date or without expiry

  • Description - Text Editor, Data Tables, Embed Photos & Videos

  • Appearance - Color and Style with CSS Themes

🔗