20 Mar Edited #1

BankPipe documentation

Administrator
BankPipe is a MyBB plugin which implements a seamless paid experience to deliver subscriptions and premium attachments across the whole board. This document will help you setting up the plugin after you have uploaded and installed the plugin successfully. It is always tailored to the latest BankPipe version available.


BankPipe is a copyrighted product. If you did not pay for it, please report the source of illegal redistribution and purchase a legit copy of the product. Its owner and only developer partially lives off the revenue from BankPipe. Thank you.


PACKAGE Installation


KEYCAP 1 Click on the Install & activate button in your plugins list. BankPipe adds 39 templates to every theme of your board. The plugin also applies 1 core edit automatically. Ensure the core edit is in place by checking the plugin's row after the installation.

[Image: qe15izA.png]

KEYCAP 2 To add additional functionalities, alter your theme's templates as follows:
to see the user's purchases as an admin, add to member_profile:
{$memprofile['purchases']} 
to see the cart link, add to header_welcomeblock_member:
{$cart
to see the price box before uploading an attachment if using third party monetization, add to post_attachments_attachment:
{$paidOptions

WRENCH Configuration


In order to accept payments you must set up gateway-specific applications.

PayPal


KEYCAP 1 Go to PayPal Developers and log in. If you haven't got a sandbox developer account yet and you want to use sandbox (fictional) payments, create one.

KEYCAP 2 Go to the applications panel and scroll down to REST APIs. Click on Create app and fill the required fields.

[Image: X6ZA8IX.png]

You will be presented a page similar to the following:

[Image: yDmYOWt.png]

KEYCAP 3 Scroll down and click on Add webhook. Fill in the fields with the following configuration and save:
Webhook Url: https://YOURBOARDURL/bankpipe.php?action=webhooks&gateway=PayPal
Event types: All events

WARNING SIGN Replace YOURBOARDURL with your board's base URL, including subfolders.

KEYCAP 4 Open BankPipe's module in your Admin Control Panel. Beneath PayPal's row, copy the client ID and client secret tokens into the respective fields. Add your PayPal email address where you want to receive your funds in the wallet field and save.

WARNING SIGN BankPipe can run in 2 modes: Sandbox and Live. Sandbox mode allows you to try the app with dummy accounts and payments, while Live mode collects real money from real accounts. Ensure you are using the correct tokens while using Sandbox mode and viceversa.

KEYCAP 5 Congrats! You're ready to receive PayPal payments!

Coinbase


KEYCAP 1 Go to Coinbase Commerce and log in. Create an account if you don't have one yet.

KEYCAP 2 Go to the settings panel and scroll down to API keys. Click on Create an API key.

[Image: nMoKilH.png]

KEYCAP 3 Scroll down to Webhook subscriptions. Click on Add an endpoint. Fill in the field with the following endpoint and save:
https://YOURBOARDURL/bankpipe.php?action=webhooks&gateway=Coinbase

[Image: sFIAvTm.png]

WARNING SIGN Replace YOURBOARDURL with your board's base URL, including subfolders.

KEYCAP 4 Open BankPipe's module in your Admin Control Panel, and keep Coinbase Commerce settings page at hand. Fill Coinbase's row in BankPipe's settings as follows:
BankPipe identifier: leave empty
BankPipe secret token: Coinbase shared secret. You can obtain the shared secret by clicking on Show shared secret under Webhook subscriptions
BankPipe wallet ID: Coinbase API key. You can obtain the API key by clicking on Reveal under API keys

WARNING SIGN Coinbase does not have a sandbox, so the respective option won't have any effect if enabled.

The configuration should be similar to the following:

[Image: 8qfpnTA.png]

KEYCAP 5 Congrats! You're ready to receive Coinbase payments!

Third party monetization


If you enable third party monetization, users in the "Usergroups allowed to manage" will be able to set a price for their attachments. They will be also able to specify a personal wallet where they will receive money for their attachments. Wallets format depend upon each gateway: for example, a PayPal wallet equals to a plain email address.


At present stages, users can specify a Coinbase wallet but they will NOT receive funds on them. A workaround is under active development.


WARNING SIGN If an user has permissions to create items but he has not set a wallet in his User Control Panel, the board's wallet will be used instead.

Hooks list


A complete hooks list ordered by filename is available below. It is formatted as JSON and includes: filename, name of the hook, code line and eventual arguments. You can easily integrate your plugins within BankPipe by injecting your code into these hooks.
Filename Size Downloads
5.85 KB 8