pay flow gateway

[bryantshannon516-cmd]

Configuring Hosted Checkout Pages (PayPal Payflow Gateway)

PayPal allows you to customize the hosted checkout pages so that they match the look and feel of your website. Buyers move smoothly from your site to the PayPal-hosted pages to complete the payment. Because the pages are hosted on PayPal’s servers, you do not need to capture or store credit card data on your own site, helping you toward PCI compliance.

Note: The Payflow implementation helps with PCI compliance but does not guarantee it.

---

Two Ways to Configure Hosted Checkout Pages

1. Using PayPal Manager (recommended for most merchants)
2. Using a Secure Token to pass customization parameters dynamically (overrides PayPal Manager settings)

---

1. Configuring Hosted Pages Using PayPal Manager

Log in to PayPal Manager → Service Settings tab → Hosted Checkout Pages section. You will see three tabs:

• Setup
• Customize
• Integrate

Setup Tab

You can configure:

• Billing and shipping fields the buyer must complete
• Payment confirmation page (PayPal-hosted or your own page)
• Cancel URL and return link text
• Enable/disable Silent Post
• Send email receipts to the buyer
• PayPal Express Checkout display settings

Important notes:

• PayPal ignores the cancel URL when using Layout C unless you prefix it with DISPLAY_URL | (example: DISPLAY_URL | https://example.com/home.php).

Customize Tab

Choose from three layout templates:

Layout	Description
A (default)	Redirect template
B	Redirect template
C	Embedded template (iFrame)

You can customize the header, background, payment method section, and order summary for Layouts A and B. Layout C is embedded in your own page, so you already control most of the appearance.

Customizable elements (mainly for Layouts A & B):

• Header height, background color, font, business name/logo
• Page background color and image
• Payment method section colors and button colors
• Order summary column

Buttons on Customize page:

• Preview
• Save and Publish
• Cancel
• Undo Changes

Note: All changes must be made in one session. If the session expires, changes are lost.

Integrate Tab

Contains instructions for setting up a test account and submitting test transactions.

---

2. Using a Secure Token to Pass Customization Parameters

You can override the settings in PayPal Manager by passing parameters in a form post along with a secure token.

Setup Parameters (form post)

Variable	Description	Max Length
CANCELURL	URL when buyer clicks Cancel	512
CSCREQUIRED	Require Card Security Code (TRUE/FALSE)	-
CSCEDIT	Allow editing of CSC (TRUE/FALSE)	-
DISABLERECEIPT	Use your own confirmation page (TRUE/FALSE)	-
EMAILCUSTOMER	Send email confirmation to buyer (TRUE/FALSE)	-
ERRORURL	URL on error	512
RETURNURL	URL after successful transaction	512
SILENTPOSTURL	URL for Silent Post	512
TEMPLATE	TEMPLATEA, TEMPLATEB, or MOBILE / MINLAYOUT for Layout C	-
URLMETHOD	POST or GET (default is GET)	-

Customize Parameters (form post)

Variable	Description	Example
PAGECOLLAPSEBGCOLOR	Border color around Layout C	993300
PAGECOLLAPSETEXTCOLOR	Text color for "Pay with PayPal"	990000
PAGEBUTTONBGCOLOR	"Pay Now" button background color	AA66FF
PAGEBUTTONTEXTCOLOR	"Pay Now" button text color	33FFFF
LABELTEXTCOLOR	Labels like "Card Number", "Expiration"	330000

Other Useful Parameters

| Variable | Description | Values |
|--------------|-----------------------------------------------------------------------------|-------------|<|eos|>