[How-To] Extending the vBulletin Payment Gateway
Overview
This tutorial shows you how to add a new payment method to the vBulletin Payment Gateway. It uses my pgStormPay hack as the example. Step 1: The database The first thing you need to understand is the paymentapi table in the database. Code:
Field Type The title of the payment method, in our case ?StormPay?. Currency Comma delimited list of currency types this payment method can accept. StormPay only accepts us dollars, so in our case it?s just ?usd?. Recurring Whether or not this payment method can handle recurring payments (monthly, yearly, etc?). Classname The name of the class in yourforum/includes/paymentapi that contains the functions needed to use this payment method. This field name is a little deceptive, because it you look in yourforum/payment_gateway.php you see the following: PHP Code:
Active Is this payment method active? In general you should set this to 0 initially and let the admin activate your payment method from the admincp. Settings This is a critical part of the payment method, and needs some explaining. It represents the information the admin must fill in for this payment method to work. It will be different for each payment method. It is an array of arrays, with each inner array representing a field to be filled out. The structure of the inner array is similar to a html input element. It has a type, a value, and how to validate the value. For StormPay, we create four fields, as shown bellow. PHP Code:
Once you know the values you want for your payment method, you can write them into the database in your install section of your product xml file. PHP Code:
Next you?ll need to create a template for your payment form. This is the form that is filled out automatically by vBulletin before it submits data to your payment method. In the case of StormPay, we are going to use a simple single item payment, as specified in their integration api: http://www.stormpay.com/stormpay/user/manual.php Note: I use unit_price instead of amount. It works the same, and seems to clear up some minor bugs. HTML Code:
<input type="hidden" name="test_mode" value="$settings[test_mode]"> To create this template, vBulletin expects it to have the name subscription_payment_classname. So in our case the template section of the product xml would look like this: HTML Code:
<templates> This is not the only way to accomplish this step, but it is the way I have chosen. You need to add the StormPay phrase to the vbphrases array, so it can appear on the ?Order Using? button. Since these are service names, and not translated, vBulletin hard codes them in yourforum/payment.php. However, it does provide a hook (paidsub_order_start). The hook code we need is very simple: PHP Code:
HTML Code:
<plugins> Code:
Global HTML Code:
<phrases> This is the final part, and the real meat of the payment method. It ties everything else together. It extends the vBulletin class vB_PaidSubscriptionMethod, and the easiest thing is probably to copy one of the existing classes and modify it. It has three functions you need to deal with: verify_payment() function This function will depend on what the payment method you are using sends back to the payment_gateway.php file. In general you?ll want to get the variables from the submitted request, check them for successful payment, and return true or false to the payment_gateway.php file. Here is a look at the verify_payment() function for StormPay: PHP Code:
test() function This function is used by the Test Communications link under the Paid Subscriptions menu in the admincp. In general it is just a validation of the specific data (settings) needed by the payment method. In our case, we need a valid email and a ?secret code?. So, or method looks like this: PHP Code:
This function generates the form that is sent to your payment method, using the template you created earlier. Several variables get passed into the method, and you can also retrieve any values you put into settings. Here is a look at the StormPay function. PHP Code:
One final thing to be aware of is that in order to display feedback from your payment method payment_gateway.php requires the value ?display_feedback? be set to true. It defaults to false in the vBulletin class you extend. So, you must force it true: PHP Code:
That?s it folks! Check out the pgStormPay hack if you still need more details. |
Can someone do one for me for verotel with re-occuring billing... i can pay for this mod...
|
I am extending the Payment Gateway
What is username Hambil here? I'll need to change it right?? |
I'm sorry, I don't understand what you are asking me...
|
in a lot of places in your code your username is mentioned
like in PHP Code:
|
1 Attachment(s)
After installing my payment gateway extenssion I am geting two submit button instead of one..
see the image attached. any idea why it can happen.. |
Quote:
|
Quote:
|
Quote:
It can be used for logging purpose but not completely coz it can't be associated with a user in the user table of the party who is installing the hack. because the developer need not be a member in the forum of the party installing it. right?? |
Right, which really doesn' t have anything to do with this hack, it's the same for all hacks. It's just the name of the author of the template.
|
All times are GMT. The time now is 11:51 PM. |
Powered by vBulletin® Version 3.8.12 by vBS
Copyright ©2000 - 2024, vBulletin Solutions Inc.
X vBulletin 3.8.12 by vBS Debug Information | |
---|---|
|
|
More Information | |
Template Usage:
Phrase Groups Available:
|
Included Files:
Hooks Called:
|