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.

Listing types and setting prices

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

/* phpYellow Listing Types and Your Pricing 


	see improveMyListing.php for detailed listing comparisons
*/
define("LISTING_TYPE_A", "Sponsor"); // modify - Sponsor - default is to allow Sponsor listings when paid
define("TYPE_A_PRICE", "199.95"); // set your own price
define("LISTING_TYPE_B", "Gold"); // modify - 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", "Silver"); // modify - Featured - default is to allow Featured listings when paid
define("TYPE_C_PRICE", "79.00"); // set your own price
define("LISTING_TYPE_D", "Bronze"); // modify - Basic - default is to allow free basic listings
define("TYPE_D_PRICE", "00.00"); // set your own price
define("LISTING_TYPE_E", "Test"); // modify - for testing only
define("TYPE_E_PRICE", "00.00"); // for testing only - "00.01"
define("LISTING_TYPE_F", "Mini Website"); /* DO NOT CHANGE - except to comment out with 2 forward slashes */
define("TYPE_F_PRICE", "179.95"); // set your own price

Disable Listing Types

Listing types are all available by default. To NOT display a listing type comment out with 2 forward slashes, like this:

// define("LISTING_TYPE_E", "Test"); // for testing only*

*Note: you SHOULD disable the test listing type because it allows customers to upgrade with out paying.

Currency Symbol

The currency symbol is the dollar character "$" by default. This may be changed to your currency character, for example the Euro or pound, by inserting the symbol in util.php like this: 

	define("CURRENCYSYMBOL", "$"); // replace the dollar character with your symbol

Set Listing Duration

The default durations are 1 year or 6 months. Support has been discontinued for the 12 individual month long 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 proDuration.php with radio buttons, one selection per month desired, 
   and call the month selected as '$monthsGoodFor'
b) include proDuration.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