phpyellowtm developer guide

Start | Customize | Payment | Questions

Payment

This page contains information or links to the following:

Overview

You may offer free listings to every visitor to your directory. Listings may all be free. Listings can also be paid. If you will be receiving payment, you first decide if the payment will be "elective" or "required". Here are directions on how to turn payment logic on or off:

Insta-pay

Insta-PayTM is the internal phpYellow payment switch. It has three modes: off, elective and required.

  1. in 'off' mode no payment is ever required for any listing
  2. in 'elective' mode the customer chooses if and when to pay
  3. in 'required' mode the customer MUST pay for their listing

The administrator may easily change Insta-PayTM mode. Just one word in the configuration file needs to be changed. Look for the CONSTANT called INSTAPAY in the Pro Edition util.php. Modify the value to be 'off', 'elective' or 'required'. Insta-PayTM is available ONLY in the Pro Edition.

Setting Prices

You decide the prices to charge for your listings in util.php. Default prices are provided. 

/* phpYellow Listing Types and Your Pricing 
   To NOT display a listing type open util.php and comment out with 2 forward slashes, like this: 
	// define("LISTING_TYPE_E", "Test"); // for testing only
*/
define("LISTING_TYPE_A", "Sponsor"); // default is to allow Sponsor listings when paid
define("TYPE_A_PRICE", "364.00"); // set your own price
define("LISTING_TYPE_B", "Premium"); // default is to allow Premium listings when paid
define("TYPE_B_PRICE", "149.00"); // set your own price, do NOT use a currency symbol
define("LISTING_TYPE_C", "Featured"); // default is to allow Featured listings when paid
define("TYPE_C_PRICE", "79.00"); // set your own price

/* default is to allow free basic listings,
uncommenting the next 2 lines will require payment for every listing */
//define("LISTING_TYPE_D", "Basic"); 
//define("TYPE_D_PRICE", "39.00"); // set your own price

//define("LISTING_TYPE_E", "Test"); // for testing only
//define("TYPE_E_PRICE", "FREE"); // for testing only - "00.01"

Set Listing Duration

The default duration is 1 year. Support has been discontinued for the 12 month periods. It is believed that decreasing the number of options improves the checkout because it makes the checkout simpler to understand and quicker to complete. The hope is to induce more listing sales through a simplified checkout process.

If you wish to add your own additional months the process is: 


1. SET UP THE OPTIONS
a) make an html page duration.php with radio buttons, one selection per month desired, 
   and call the month selected as '$monthsGoodFor'
b) include duration.php in proCheckout.php, in the 'Listing Type' column

2. PROCESS THE SELECTION
c) add your own script code section in proBuy.php to:
   i) initialize or capture the new $monthsGoodFor variable
   ii) assign a price for the $monthsGoodFor selected
   iii) update the $chargeTotal 

   Note: see proBuy.php: switch(item)

Payment methods

Given that you have decided to receive payment, the next decision is what payment methods will you accept? Default payment methods are included. These default methods include:


Credit Card by Internet
Paypal
E-Check
Credit Card by Fax
Credit Card by Phone
Credit Card by Mail
Check by Fax
Check by Mail
Money Order by Mail
Travelers Checks
Wire
Email Invoice to me
US Currency
( via courier or registered mail )


Each method has a corresponding code module which processes it. If you set aside "Credit Card by Internet" and only consider all the others, you see that the customer must communicate with you to arrange for payment.

How to remove payment methods

To remove methods do this:
  1. open paymentMethodsListAll.php in an html editor
  2. to remove a payment method delete the line it is on
  3. save this modified file as paymentMethodsList.php
  4. paymentMethodsList.php is automatically included in the online form called proCheckout.php

Example: to remove 'Credit Card by Internet' delete all of line 9 and next save this file as paymentMethodsList.php.

Set a default method

In the file paymentMethodsList.php move the word "CHECKED" to the html tag you want as the default.

Credit Card by Internet

If you have selected payment by Credit Card by Internet then customer payment is handled differently. You need to have a payment gateway provider for this method. The provider will approve or decline the transaction. You also need to supply the code to post the transaction to your provider, and then supply code to respond to the transaction outcome.

If you use Paypal then ignore the above requirement for code. Default paypal code is provided free.

Paypal instructions

Paypal is the best and default payment gateway. Click here for instructions on how to use Paypal with phpYellow.

Offer to connect payment gateway

If you do not use Paypal then the folks from phpyellow can connect phpYellow Pro with your own payment gateway provider. Inquire for details.


Start | Customize | Payment | Questions