Search TipsPayPal Integration Guide
How to enable PayPal on your websites and packages, and how PayPal transactions appear on your pay pages, postbacks, and reports.
Before you begin
Segpay must enable PayPal for your merchant account and websites before you can accept PayPal payments. Contact your Account Manager or email Tech Support at techsupport@segpay.com to request it.
PayPal does not support every country. If your business targets customers in one of the countries listed under Countries not supported by PayPal, PayPal is not available as a payment option.
You don't need separate packages or join links for PayPal. After Segpay enables your account, you can turn PayPal on for any of your existing credit card packages. See Packages below.
PayPal configuration
Segpay enables PayPal for your merchant account and your websites. You control PayPal for each package.
Websites
After Segpay enables your websites for PayPal, the PayPal is enabled indicator appears on the Edit Website screen in the Merchant Portal.
For more information on websites, see our article, Manage Websites.
Packages
When you enable PayPal for a package, your pay page displays both the credit card and PayPal payment options. Control which options display using the allowedpaymenttypes parameter rather than by building separate packages.
For more information on packages, see our article, Manage Packages .
Join links
Enabling PayPal for a package does not change your existing pay page links. PayPal displays on your page alongside the credit card option.
To set one of these options as your page's default payment method, use the "Allowed Payment Types" feature with your join link.
Using "Allowed Payment Types"
The allowedpaymenttypes parameter controls which payment options display on your pay page and which one Segpay selects by default. You don't need custom payment pages for specific payment types.
Postbacks return this data as allowedpaymenttypes=pp.
Segpay adds new values to this parameter as new payment options become available.
Setting PayPal as the default option
List the pp value (PayPal) before the cc value (Credit Card) to make PayPal the default selection on your pay page.
Example:
Result:
Setting Credit Card as the default option
List the cc value (Credit Card) before the pp value (PayPal) to make Credit Card the default selection on your pay page.
Example:
Result:
Show PayPal only
To display only PayPal on a package configured for multiple payment methods, use the pp value alone with the allowedpaymenttypes parameter in your join link.
Example:
Result:
Show Credit Card only
To display only Credit Card on a package configured for multiple payment methods, use the cc value alone with the allowedpaymenttypes parameter in your join link.
Example:
Result:
One-click payments
One-click payments let consumers buy with a single click. When you set a price point to One Click Enabled and a consumer pays with PayPal, the checkout depends on the price point type.
One-time price points
For a one-time price point with one-click enabled, Segpay reuses the existing purchase ID. On later purchases, consumers enter only their PayPal email address and skip the full PayPal sign-up.
Payment page example:
Recurring price points
Recurring price points with one-click enabled require consumers to complete the full PayPal sign-up. Each transaction generates a unique purchase ID and a new PayPal billing agreement. The same applies to Dynamic Recurring price points. Consumers can also pay with a credit card.
Payment page example:
Instant Conversion
Instant Conversion lets a consumer convert to a full membership before a limited trial ends. The Instant Conversion page presents PayPal as the only payment option and asks the consumer for their email address. For price point setup and the ICToken request, see Instant Conversion.
Payment page example:
Refunds on disputed transactions
You can't refund a PayPal transaction through the Segpay Reporting Service (SRS) while it has an open dispute. A RefundTransaction request for a transaction with an open dispute fails and returns:
Refund cannot be completed due to pending PayPal Dispute
To check whether a transaction has an open dispute, see the PayPal Dispute Console.
Postback notifications
Segpay postbacks show whether a consumer paid with PayPal or a credit card. Look for these two variables in each transaction postback:
-
cardtype=PayPal -
paymenttype=PayPal
| Postback notification type | Description | Required updates |
|---|---|---|
| Default | Segpay appends all available variables and sends them to you. | None |
| Custom | You specify variables, their names, and order. | Add: cardtype= and paymenttype= |
Postback data example:
Dispute notifications and postbacks are configured separately. See PayPal Dispute Configuration.
Reporting
All reports show when a consumer paid with PayPal. In the Merchant Portal, you can search for PayPal transactions or filter results by payment type.
Transaction Detail report
The Transaction Detail report includes PayPal as a criteria selector under Payment Types, and displays card and payment types in the results. For more information, see Transaction Detail Report.
Select Payment Type and Card Type in the advanced options to return those values in your report results.
Detail Ledger report
The Detail Ledger report includes PayPal as a criteria selector under Payment Types, and displays card and payment types in the results. For more information, see Detail Ledger report.
Invoices report
Segpay invoices PayPal transactions separately. The Paid By column identifies them. For more information, see Invoice report.
Chargeback report
Filter on Bank to see your PayPal chargeback ratios. For more information, see Chargeback report.
CB Reversals (Chargeback Reversals)
A CB Reversal, short for Chargeback Reversal, is a new transaction type that you may see in your reports. A CB Reversal occurs when an external PayPal chargeback dispute was resolved in your favor. This means the original transaction was valid, and the disputed funds have been returned to your merchant account.
CB Reversal Process:
-
External Chargeback: A customer disputes a charge directly with their bank or credit card company (an "external" chargeback) instead of through PayPal's dispute resolution process. -
Dispute Resolution: The chargeback dispute is resolved in your favor, confirming the validity of the original transaction. -
CB Reversal Creation: Segpay's system automatically generates a new transaction called "CB Reversal." -
Funds Returned: The disputed amount is credited back to your merchant account as a positive entry in the CB Reversal transaction. -
Merchant Fee: A small processing fee is deducted from the returned funds. This fee is either $15 or half the original transaction amount, whichever is less.Merchant Fee Calculations for CB Reversals
-
$100 Transaction: The merchant fee would be $15 (since half of $100 is $50, and the fee is capped at $15).
-
$25 Transaction: The merchant fee would be $12.50 (since half of the transaction amount is under $15).
-
-
Notification: You'll receive a notification (postback) informing you of the CB Reversal. -
Reporting: CB Reversal transactions are clearly labeled in your transaction reports, such as the Transaction Detail Report and Detail Ledger Report.
-
Subscription/Access: CB Reversals do not reactivate any associated subscriptions or member access that may have been suspended due to the chargeback.
-
Customer Blacklist: The customer's information remains blacklisted within the Segpay system.
Dispute reports
PayPal disputes have their own reports, available in the Merchant Portal (see PayPal Disputes Report) and through SRS (see PayPal Dispute Reporting).
Other reports
Other reports show PayPal as the card type, so you can identify and filter your PayPal transactions. This includes the Approval Rates report and the Declined Transactions report.
Segpay Reporting Service (SRS)
The Segpay Reporting Service (SRS) API includes a report called TransactionsList. It returns <CardType> values that include PayPal for all your PayPal transactions.
The TransactionsPurchasesByURL report includes PayPal transactions in the <USERDATA> field.
For more information on the Segpay Reporting Service transaction reports, see the SRS API Reporting operations.
Managing consumers
Run a consumer search in the Merchant Portal to find purchase information by name, email address, or Transaction ID. The Payment Type column shows which purchases used PayPal.
PayPal approved countries
Financial regulations and restrictions prevent PayPal from operating in some countries.
Countries not supported by PayPal
- Azerbaijan
- Bangladesh
- Belarus
- Botswana
- Bulgaria
- China (PRC & Hong Kong SAR)
- Cuba
- Egypt
- Estonia
- Guyana
- India
- Indonesia
- Iran
- Lebanon
- Libya
- Lithuania
- Malaysia
- Malta
- North Korea
- Pakistan
- Papua New Guinea
- Philippines
- Russia
- Saudi Arabia
- Singapore
- South Africa
- South Korea
- Sri Lanka
- Sudan
- Syria
- Taiwan
- Thailand
- Turkey
- Ukraine
- Vietnam