Integration with BTCPay Server for Vendor Payouts (Non-custodial workflow)

[shayanreyes]

Hello HivePress Team and Community,

I am developing a professional marketplace using the ExpertHive theme and HivePress. Due to the specific macroeconomic conditions of my market (restricted banking access), I have successfully integrated BTCPay Server for customer payments via WooCommerce.

My question is regarding the Payout side: Is there a known way or a snippet to use BTCPay Server as a payout method for vendors?

Ideally, I am looking to leverage BTCPay’s ‘Pull Payments’ feature. This would allow vendors to request their balance, and I could approve the transaction directly from my BTCPay instance, ensuring a non-custodial and ‘asset-light’ flow.

1. Does HivePress have a hook or bridge to map the internal vendor balance to a BTCPay Payout request?

2. Has anyone successfully implemented a crypto-native payout workflow that doesn’t rely on Stripe or PayPal?

Any guidance on which HivePress classes or hooks to look into for custom payout gateway development would be greatly appreciated.

Thank you!

[kseniia]

Hi,

You can use Manual Payouts and hook into the payout creation and status update processes to implement this. For example, you can use hooks like hivepress/v1/models/payout/create or hivepress/v1/models/payout/update_status (you can find all available hooks for models in our hook reference documentation).

This way, you can catch when a payout is created and extract the necessary details from it, such as a BTC wallet address or account number. You could create this as a vendor profile attribute and pull it from there. Then you’d write your PHP logic to execute the transfer and change the payout status to “publish.” New payouts start with a “pending” status, and when the status changes to “publish,” the amount is deducted from the vendor’s balance.

Hope this helps.