Payment

This page contains information or links to the following:

• Overview
• Listing types and setting prices
• Set Listing Duration
• Payment methods
• Paypal instructions
• 2checkout.com instructions
• Other gateways
• Data out and in - Technical Specifications
• Offer to connect payment gateway

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-Pay^TM 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-Pay^TM 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-Pay^TM 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
					

Table of listing types, their default rank and label

For each listing type there is a corresponding signed integer value used by the database. Following are the values assigned:

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.

Example: when a listing is upgraded to "Silver" the rank of the listing is automatically changed to the value of 1.

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, 6 months and 3 months.

If you wish to customize the duration offered the process is:

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

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

   Note: see pro_buy.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:

How to remove payment methods

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 or 2checkout.com then ignore the above requirement for code. Paypal and 2checkout.com gateway connection code to process live internet payments and automatically update the phpYellow listing online is provided free of charge. Please note that gateways frequently update their processing and the code provided by phpYellow is freely given on an "as is" basis only.

Paypal instructions

Paypal gateway integration code is included FREE (as is) with every Pro Edition. When customers choose the payment method called "Paypal" their listing purchase is handled by Paypal (an Ebay company). Click here for instructions on how to use Paypal with phpYellow.

2checkout.com instructions

2checkout.com gateway integration code is included FREE (as is) with every Pro Edition. When customers choose the payment method called "Credit Card by Internet" their listing purchase is handled by 2checkout.com. Click here for instructions on how to use 2checkout.com with phpYellow.

Other gateways

phpYellow^TM Pro Edition can be connected with other gateways such as Authorizenet, Linkpoint International or others. To connect with other gateways you will need to provide code which is not included. The code - also called a script - needs to "talks" with your specific payment gateway. Your gateway may or may not need to have custom made code to complete a payment transaction.

Data out and in - Technical Specifications

Click here for information on the data out and data in required by phpYellow.

Offer to connect payment gateway

We can connect phpYellow^TM Pro Edition with your own payment gateway provider. Contact us for details.