Skip to content

BTCPayments Plugin

Daniel Neto edited this page Aug 18, 2026 · 26 revisions

BTCPayments plugin

BTCPayments lets a user fund an AVideo wallet with Bitcoin. The plugin depends on YPTWallet and is currently marked under development in the source, so test it before production use.

Testnet compared with mainnet

Mode Uses real Bitcoin Address setting Use it for
Testnet No siteWalletTest Testing the complete payment workflow
Mainnet Yes siteWallet Real payments after testing and operational review

Testnet coins have no monetary value. Mainnet transactions can have network and service fees and normally cannot be reversed.

Configure it in the UI

  1. Enable and configure YPTWallet.
  2. Sign in as an administrator and open Admin → Plugins → BTCPayments.
  3. Open the plugin parameters.
  4. Enter the appropriate receiving address in siteWallet and a separate test address in siteWalletTest.
  5. Enter the BTCMarketPlaceKey issued for this site.
  6. Set useTestNet to true and save.
  7. Use Edit on the plugin row to review invoices/payments and Status to check the service connection.
  8. Complete a testnet payment before switching useTestNet off.

Never use a testnet address on mainnet or a mainnet address on testnet. Verify a receiving address outside AVideo before accepting payments.

User payment flow

  1. The user opens the wallet and selects Add Funds.
  2. The user enters an amount and chooses Bitcoin.
  3. The payment page displays a Bitcoin amount, address, and QR code.

Choose Bitcoin when adding funds

Bitcoin payment address and QR code

  1. The user sends the exact amount using a wallet on the configured network.
  2. After the required confirmation, AVideo credits the user's wallet.
  3. The user can review the invoice and receipt.

Bitcoin invoice history

Common questions

Why is the wallet not credited immediately? The transaction may still be unconfirmed, may have used the wrong network or amount, or the status callback may have failed.

Does it support recurring Bitcoin charges? It funds YPTWallet. Recurring access is managed separately by the relevant AVideo monetization workflow.

Are fees fixed? No. Network and service fees can change. Check the amount shown before payment and the current service terms.

What should be recorded for support? Keep the invoice ID, transaction ID, network, time, amount, and sanitized logs. Never share wallet seed phrases or private keys.

Clone this wiki locally