Home

CyberSource PayPal Services User Guide

Contents

1. lt form gt PayPal Services User Guide August 2013 36 Chapter 3 Requesting Services with the Simple Order API The encrypted information in the above example has been shortened for A illustration The actual length of the information is about 2000 3000 characters Note The unencrypted version of the button looks similar to this lt form action https www paypal com cgi bin webscr method post gt lt input type image sre https https www paypal com en_US i btn x click but23 gif border 0 name submit gt lt input type hidden name cmd value _s xclick gt lt input type hidden name business value jdoe example com gt lt input type hidden name first_name value Larry gt lt input type hidden name last name value Smith gt lt input type hidden name address1 value 37 Main St gt lt input type hidden name address2 value Suite 2 gt lt input type hidden name city value Bloomington gt lt input type hidden name sState value IN gt lt input type hidden name zip value 47404 gt s lt input type hidden name amount value 0 00 gt lt input type hidden name tax value 0 gt s lt input type hidden name handling value 0 00 gt lt input type hidden name shipping value 0 00 gt lt input type hidden name item_number value 123454 gt lt input type hidden name cancel_ return value http cancel example com gt lt input type hidden name undefined_
2. I receive money with PayPal O I request money with PayPal I receive PayPal Website Payments and Instant Purchase Disabling Electronic Checks Depending on your business rules or the type of products you sell you may not want to let customers use their electronic checking accounts when paying through PayPal Checks typically take 3 to 4 business days to clear Use the Business Center or the Payment Events Report to verify that a check has cleared To disable acceptance of electronic checks in the Payment Receiving Preferences page disable eCheck for PayPal Website Payments and Smart Logo payments PayPal Services User Guide August 2013 20 Chapter 2 Setting Up Your System Payment Receiving Preferences Back to Profile Summary Note If you are using IPN you must update your scripts to handle payments in currencies other than U S Dollars Learn More Block payments from U S users who do not provide a Confirmed Address Yes No Ask Me Block payments if they are sent to me in a currency that I do not hold O Yes No accept them and convert them to U S Dollars Ask Me Block Payments from users who C Have non uU s PayPal accounts OInitiate payments from the Pay Anyone subtab of the Send Money tab If checked you may enter an Alternate Payment URL for your buyers Alternate Payment 3 URL optional http Ea Block Payments funded by MleCheck for PayPal Website Payments and Sm
3. Method Description CyberSource If you are using CyberSource s purchaseTotals_grandTotalAmount Using a total freight field to give a total amount for the order then you must use the amount purchaseTotals_freightAmount field to give the total shipping and handling for the order CyberSource will map this to the PayPal HTML variable shipping This method overrides any profile based amount you have set See below CyberSource If you are using item level information instead of the Using an item for the purchaseTotals_grandTotalAmount field you must create at least freight amount one separate item for the shipping and or handling amounts For more details see the information about creating requests in Getting Started with CyberSource Essentials CyberSource will sum the amounts for items where the item_ _productCode shipping _ only or shipping and_handling and assign the value to the PayPal HTML variable shipping CyberSource will sum the amounts for items where the item_ _productCode handling _ only and assign the value to the PayPal HTML variable handling This method overrides any profile based amount you have set See below PayPal Services User Guide August 2013 34 Chapter 3 Requesting Services with the Simple Order API Table 2 Methods for Specifying Shipping and Handling Charges Continued Method Description PayPal You can configure your PayPal profile to use flat shipping and Using a profile based handling amo
4. address address state State of customer s address 40 address _ status Whether the address is confirmed This field will contain one of the following values a confirmed Customer provided a confirmed address unconfirmed Customer provided an unconfirmed address address street Customer s street address 200 address zip Postal code of customer s address 20 business Merchant s email address or account ID Equivalent to receiver 127 email if payment is sent to primary account and essentially an echo of the business variable that was passed to PayPal in the button custom CyberSource populates this field with various identifiers and PayPal 255 echoes the field in the IPN message The field contains six identifiers separated by commas If you are using the Simple Order API the first three identifiers are the payPalButtonCreateReply_reconciliationID from CyberSource s reply the requestID from CyberSource s reply and the merchantReferenceCode that you provided in the request The last three identifiers are CyberSource internal tracking values exchange rate Exchange rate used if a currency conversion occurred first_name Customer s first name 64 invoice CyberSource populates this field with an identifier and PayPal echoes the field in the IPN message 255 If you use the Simple Order API the identifier in CyberSource s reply is payPalButtonCreateReply_reconciliationID item_
5. requestDateTime DDThh mm sszZ For example 2003 08 11T22 47 57Z is equal to August 11 2003 at 10 47 57 P M The T separates the date and the time The Z indicates UTC PayPal Services User Guide August 2013 47 Chapter 3 Requesting Services with the Simple Order API Table 5 Reply Fields for Button Create Continued Reply Field Description Data Type amp Length payPalButtonCreateReply_ Unencrypted version of the button String no unencryptedFormData length limit reasonCode Numeric value corresponding to the result of the overall request Integer 5 See Reason Codes page 51 for a list of possible values requestID Unique identifier for the request String 26 requestToken Request token data created by CyberSource for each reply The String field is an encoded string that contains no confidential information 256 such as an account or card verification number The string can contain a maximum of 256 characters Processing a Credit You can perform a credit for a regular payment by using payPalCreditService For general information about refunding PayPal payments see PayPal Credits page 10 You must perform the credit within 60 days of the payment request At this time you can perform only one credit for an order for either a partial Important amount or the full amount of the payment To request the service send a request with payPalCreditService_run true A PayPal credit is a fo
6. The sum of all the mc_gross_ values should total mc_gross mc_handling and mc_handling Total handling amount associated with the transaction For a shopping cart transaction PayPal appends the number of the item mc_handling1 and so on For a shopping cart transaction the handling cart cart wide variable is also included in the mc_handling variable for this reason the sum of the mc_hand1ing values may not be equal to mc_handling mc_shipping and mc_shipping Total shipping amount associated with the transaction For a shopping cart transaction this is the combined total of the paypal_shipping and paypal_shipping2 API fields that you pass to CyberSource where is the number of the item The mc __ shipping is only returned when you apply a shipping amount for a specific item Because profile shipping may apply the sum of the mc_shipping values may not equal mc_shipping notify version Version of the IPN message Example 1 6 num_cart_items For a shopping cart transaction number of items in the cart option_namel and option _namel Option 1 name as requested by you 64 For a shopping cart transaction PayPal appends the number of the item option_namel_1 and so on option _name2 and option _name2_ Option 2 name as requested by you 64 For a shopping cart transaction PayPal appends the number of the item option _name2_1 andso on option _selectionl an
7. Description Transaction ID Payment Data Transfer token You can use the token to receive additional transaction information from PayPal For more information see PayPal s Merchant User Manual and Integration Guide st Status variable indicating whether the payment was successful and whether you can ship the goods This variable will contain one of the following values Completed Payment is complete a Denied You denied the payment Failed Payment failed Only occurs if the payment comes from the customer s bank account a Pending Payment is pending amt Total amount of the payment cc Currency code cm During the button creation CyberSource populates this field with various identifiers and PayPal echoes the field in the PDT reply The field contains three identifiers separated by commas If you are using the Simple Order API the three identifiers are the payPalButtonCreateReply_ reconciliationID from CyberSource s reply the requestID from CyberSource s reply and the merchantReferenceCode that you provided in the request sig PayPal s signature PayPal Services User Guide August 2013 66 Appendix B PayPal Reply Variables IPN Variables for Regular Payments IPN messages contain only alphanumeric characters Unless otherwise specified the maximum field length for each IPN variable returned is 127 characters Special characters are translated into URL encoding format For exa
8. Information from CyberSource Transaction Details in the Business Center page 14 PayPal Services User Guide August 2013 10 Chapter 1 Introduction Order Tracking with an API For general information about order tracking see Getting Started with CyberSource Essentials Reconciliation IDs The following table lists the field names for the PayPal reconciliation IDs in the API reply messages Table 1 Reconciliation IDs in Replies Service Field Names Button create Simple Order API payPalButtonCreateReply_reconciliationID Credit Simple Order API payPalCreditReply_reconciliationID Request IDs For all PayPal services the request ID is returned in the reply message in the requestID field The field names for the PayPal request IDs in the credit request messages is payPalCreditService_payPalPaymentRequestID Transaction Reply Information Information from PayPal Payment Data Transfer PDT PayPal s Payment Data Transfer is an optional feature you can use if it fits your implementation You use PDT to display payment transaction details to the customer when they are redirected to your site after completing a regular payment at PayPal s site If you want to use PDT you must enable Auto Return See Enabling Auto Return page 28 You might choose to use PDT because it is one way to determine whether to ship the goods Note that if the customer uses a delayed payment type such as an electronic check the PDT inform
9. Regular Payment Button 32 Sending the Shipping Address for a Regular Payment Button 33 Specifying Shipping and Handling Charges for a Regular Payment Button 34 Specifying Tax for a Regular Payment Button 35 Interpreting CyberSource s Reply 36 Receiving PayPal s POST Response 37 Request Fields 38 Reply Fields 47 Processing a Credit 48 Request Fields 49 Reply Fields 50 Reason Codes 51 Testing 53 Chapter 4 Creating a Shopping Cart Button 54 Appendix A Examples for the Simple Order API 56 Name Value Pair Examples 57 Creating a Regular Payment Button 57 Processing a Credit 59 Creating a Shopping Cart Button 60 XML Examples 61 Creating a Regular Payment Button 61 Processing a Credit 63 Creating a Shopping Cart Button 65 PayPal Services User Guide August 2013 4 Contents Appendix B PayPal Reply Variables 66 PDT Reply Variables 66 IPN Variables for Regular Payments 67 Appendix C Product Codes 74 Index 75 PayPal Services User Guide August 2013 5 Recent Revisions to This Document REVISIONS Release Changes August 2013 Removed incorrect information about Customer Support Ss Updated the information about request tokens September 2012 This revision contains only editorial changes and no technical updates April 2011 Updated the PayPal account setup information in Enabling API Access page 25 June 2010 Added Cybersource API usernames Production paypal_cybersource_api1 cyberso
10. String 5 PayPal Services User Guide August 2013 49 Chapter 3 Requesting Services with the Simple Order API Table 6 PayPal Credit Request Fields Continued Request Field Description Required Data Optional Type amp Length purchaseTotals currency Currency used for the order PayPal currently accepts Required String 5 orders that use USD CAD EUR GBP or JPY only purchaseTotals _ Amount of the credit At this time you can perform See String 15 grandTotalAmount only one credit for an order for either a partial amount description or the full amount of the payment You must include either this field or item_ _unitPrice in your request See the information about items and grand totals in Getting Started with CyberSource Essentials This value cannot be negative Reply Fields The following table lists the reply fields for processing a credit Table 7 PayPal Credit Reply Fields Reply Field Description Data Type amp Length decision Summarizes the result of the overall request The field can contain String 6 one of the following values m ACCEPT ms ERROR REJECT invalidField_0 N Fields in the request that contained invalid data These reply fields String are included as an aid to software developers only No attempt 100 should be made to use these fields for end user interaction See the information about missing and invalid fields in Getting Started with CyberSource Essentials merchantRef
11. The copyrighted software that accompanies this document is licensed to You for use only in strict accordance with the Agreement You should read the Agreement carefully before using the software Except as permitted by the Agreement You may not reproduce any part of this document store this document in a retrieval system or transmit this document in any form or by any means electronic mechanical recording or otherwise without the prior written consent of CyberSource Restricted Rights Legends For Government or defense agencies Use duplication or disclosure by the Government or defense agencies is subject to restrictions as set forth the Rights in Technical Data and Computer Software clause at DFARS 252 227 7013 and in similar clauses in the FAR and NASA FAR Supplement For civilian agencies Use reproduction or disclosure is subject to restrictions set forth in subparagraphs a through d of the Commercial Computer Software Restricted Rights clause at 52 227 19 and the limitations set forth in CyberSource Corporation s standard commercial agreement for this software Unpublished rights reserved under the copyright laws of the United States Trademarks CyberSource The Power of Payment CyberSource Payment Manager CyberSource Risk Manager CyberSource Decision Manager CyberSource Connect Authorize Net and eCheck net are trademarks and or service marks of CyberSource Corporation All other brands and product names are trademarks or
12. Will be empty for non USD payments This is a legacy field replaced by mc_ fee If this amount is negative it indicates a refund or reversal and the refund or reversal can be for the full or partial amount of the original transaction payment gross Full USD amount of the customer s payment before the transaction fee is subtracted Will be empty for non USD payments This is a legacy field replaced by mc_gross If this amount is negative it indicates a refund or reversal and the refund or reversal can be for the full or partial amount of the original transaction PayPal Services User Guide August 2013 70 Appendix B PayPal Reply Variables Table 10 IPN Variables for Regular Payments Continued Variable Description Max Length payment status Status of the payment This field can contain one of the following values Canceled Reversal1 Reversal has been canceled For example you won a dispute with the customer and the funds for the reversed transaction have been returned to you Completed If referring to an initial purchase this means the payment has been completed and the funds have successfully been added to your account balance Denied You denied the payment This happens only if the payment was previously pending due to one of the reasons specified by the pending reason variable See below Failed Payment has failed This happens only if the payment was attempted from the customer s bank account Pendin
13. goods immediately and you cannot wait for the confirmation that comes in the CyberSource reports When you configure your CyberSource account you give CyberSource the secure URL where you want to receive the IPN messages The Payment Events Report which is described in Information from CyberSource Reports page 13 includes the information from every IPN Important message that is forwarded to you If the system that receives your IPN messages is not available PayPal will repeat forwarding each IPN message at specific intervals until your system receives it or until PayPal s system reaches its retry limit Each of these instances will be included in the Payment Events Report so you will see multiple occurrences of the same information in the report if your system does not receive the IPN message the first time it is forwarded to you To use IPN message forwarding your server certificate must be issued by a Certificate Authority CA that is known to CyberSource If it is not CyberSource cannot authenticate your server certificate during the handshake with your server CyberSource supports all of the CA s that are generally used Check with CyberSource Customer Service to make sure your certificate meets these requirements PayPal Services User Guide August 2013 12 Chapter 1 Introduction For regular payments you receive an IPN message when these events occur Payment Clearing of an electronic check Reversal of a pa
14. if any shipping information is included 2 Optional but CyberSource encourages you to send the shipping address to increase chances that the transaction will be covered under PayPal s Seller Protection Policy See Sending the Shipping Address for a Regular Payment Button page 33 3 Required if shipTo_country is US or CA PayPal Services User Guide August 2013 38 Table 4 Button Create Request Fields Continued Chapter 3 Requesting Services with the Simple Order API Request Field item_ _ productName Description Product s name This information is not displayed in the button but is displayed on the Use With Button Data Type amp Length String 30 Required Optional See description Regular payment transaction details screen in the Business Center Required if item_ productCode is NOT default stored_value or one of the values related to shipping and or handling Note This value is NOT used for the item_ name variable in the button paypal_item_ name is used for that see the field description in this table You may include both item_ _ productName and paypal_item_name in the request item_ _productSKU Product s identifier code This information is not displayed in the button but is displayed in See description Regular String 30 payment the transaction details screen in the Business Center Required if item_ productCode is NOT default stored_v
15. lt input type hidden name shipping value 4 95 gt lt input type hidden name item_number value 3362710 gt lt input type hidden name cancel_ return value http paypalcancel example com gt lt input type hidden name undefined quantity value 0 gt lt input type hidden name quantity value 0 gt lt input type hidden name return value http paypalsuccess example com gt lt input type hidden name item_name value Noveau Lamp gt lt input type hidden name shipping2 value 0 00 gt lt input type hidden name currency code value USD gt lt input type hidden name bn value CyberSource gt lt input type hidden name notify_url value http example com ipn gt lt input type hidden name invoice value RYXWMQX04MC9 gt lt input type hidden name custom value RYXWMQX04MC9 0305782650000167905080 482046C3A7EQXYZ gt lt form gt payPalButtonCreateReply encryptedFormData lt form action https www paypal com cgi bin webscr method post gt lt input type image src https https www paypal com en_US i btn x click but23 gif border 0 name submit gt lt input type hidden name cmd value _s xclick gt lt input type hidden name encrypted value LaS ase BEGIN PKCS7 MIIGTQYJKoZIhvcNAQcDoIIGP j CCBj oCAQAxggE6MI IBNgIBADCBnj CBmDELMAkGA1UEBhMCVVMXEZARBgGNVB AgTCkNhbG1mb3 JuaWExETAPBGNVBAcTCFNhbiBKb3N1MRUwEWYDS 1b3 DQEBAQUABIGAgOSFSADkAz5103qK8w e8z3zt8
16. must manually accept or deny the payment other Payment is pending for a reason other than the other reasons listed here Contact PayPal Customer Service unilateral The payment was made to an email address that is not yet registered or confirmed upgrade Payment was made via credit card and you must upgrade your account to Business or Premier status to receive the funds You could also get this status because you have reached the monthly limit for transactions on your account verify You are not yet verified You must verify your account before you can accept the payment quantity Quantity passed by you or entered by the customer if not passed by 127 you For a shopping cart transaction PayPal appends the number of an the item quantityl1 and so on quantity reason_code Reason for a refund or reversal This field is returned only if payment _status Reversed or Refunded This field contains one of these values buyer complaint A reversal has occurred because of a complaint from your customer about the transaction chargeback A reversal has occurred because of a chargeback by the customer guarantee A reversal has occurred because the customer triggered a money back guarantee refund A reversal has occurred because you have given the customer a refund other A reversal has occurred for a reason other than those stated above PayPal Services User Guide August 2013 72 Appendix B PayPal Reply V
17. registered trademarks of their respective owners Contents Recent Revisions to This Document 6 CONTENTS Chapter 1 Introduction 7 About PayPal Payments 7 PayPal Payments 7 Payments Through the Hosted Order Page 7 Payments Through an API 8 PayPal Credits 10 Order Tracking with an API 11 Reconciliation IDs 11 Request IDs 11 Transaction Reply Information 11 Information from PayPal Payment Data Transfer PDT 11 Information from PayPal Instant Payment Notification IPN 12 Information from CyberSource Reports 13 Information from CyberSource Transaction Details in the Business Center 14 PayPal EmailMessages 14 CyberSource Email Messages 15 Chargebacks 17 Additional Documentation 18 PayPal References 18 CyberSource Guides 18 Chapter 2 Setting Up Your System 19 Opening and Configuring Your PayPal Account 19 Settings for Hosted Order Page and API 20 Disabling Email Notifications 20 Disabling Electronic Checks 20 Setting Your Credit Card Statement Name 21 Entering the IPN URLs 22 PayPal Services User Guide August 2013 Contents Settings for API Users Only 25 Enabling API Access 25 Enabling Auto Return 28 Enabling the Settlement File 29 Configuring Your CyberSource Account 29 Merchants Using the API 30 Merchants Using the Hosted Order Page 30 AllMerchants 31 Chapter 3 Requesting Services with the Simple Order API 32 Creating Buttons 32 Requesting the Service 32 PayPal s HTML Variables for a
18. these fields for end user interaction See the information about missing and invalid fields in Getting Started with CyberSource Essentials merchantReferenceCode Order reference or tracking number that you provided in the request String 50 If you included multi byte characters in this field in the request the returned value might contain corrupted characters missingField_0 N Required fields that were missing from the request These reply String fields are included as an aid to software developers only No attempt 100 should be made to use these fields for end user interaction See the information about missing and invalid fields in Getting Started with CyberSource Essentials payPalButtonCreateReply_ Type of button created This field will contain one of the following String 30 buttonType values a buy Regular Buy Now payment button shopping cart Shopping Cart button See Chapter 4 Creating a Shopping Cart Button on page 54 payPalButtonCreateReply_ Encrypted version of the button String no encryptedFormData length limit payPalButtonCreateReply_ A numeric value corresponding to the result of the button creation Integer 5 reasonCode request See Reason Codes page 51 for a list of possible values payPalButtonCreateReply_ Reference number for the transaction that you use to reconcile your String 60 reconciliationID transactions payPalButtonCreateReply_ Time of the button creation request The format is YYYY MM String 20
19. values for all of the items becomes the value for the tax variable in the button This is the total tax to apply to the product The value is NOT multiplied by item_ quantity This value overrides any profile based tax you have set See Specifying Tax for a Regular Payment Button page 35 for more details The item_ _taxAmount field is additive For example if you send one item with unitPrice of 10 00 and taxAmount of 0 80 and you send another item with unitPrice of 20 00 and taxAmount of 1 60 the total amount authorized will be for 32 40 not 30 00 with 2 40 of tax included The item_ _taxAmount and the item_ _ unitPrice must be in the same currency The value cannot be negative Use With Button Regular payment Required Data Optional Type amp Length Optional String 15 item_ _unitPrice Per item price of the product You must include either this field or purchaseTotals_ grandTotalAmount in your request See the information about items and grand totals in Getting Started with CyberSource Essentials This value cannot be negative This field is used to calculate the value that goes into the amount variable in the button You can include a decimal point in this field but you cannot include any other special characters The amount will be truncated at the request level to the correct number of decimal places Regular payment See String 15 description linkToRequest Value that
20. will see separate numbered IPN variables for each item The variables are included in the list in IPN Variables for Regular Payments page 67 PayPal Services User Guide August 2013 55 APPENDIX Examples for the Simple Order API The buttons in the examples include line breaks to make it easier to see the A different variables and their values The actual buttons will not include line Note breaks The encrypted buttons in the examples have been shortened for illustration The actual length of the encrypted information is about 2000 3000 characters PayPal Services User Guide August 2013 56 Appendix A Examples for the Simple Order API Name Value Pair Examples Creating a Regular Payment Button Example Request payPalButtonCreateService run true payPalButtonCreateService buttonType buy merchant ID infodev merchantReferenceCode 4 82046C3A7EOXYZ billTo firstName Joe billTo_lastName Smith billTo_ street1 1040 Elm St billTo_ city San Jose billTo_state CA billTo_postalCode 95127 billTo_country US shipTo_ firstName Joe shipTo_lastName Smith shipTo_ street1 1040 Elm St shipTo city San Jose shipTo state CA shipTo_ postalCode 95127 shipTo country US purchaseTotals grandTotalAmount 25 99 purchaseTotals taxAmount 2 55 purchaseTotals freightAmount 4 95 purchaseTotals_ currency USD paypal _cancel return http paypalcancel example com paypal _return http paypalsuccess example com paypal _item_
21. you will already be specifying a purchaseTotals_grandTotalAmount or item_ _unitPrice which will be used to populate PayPal s amount variable in the button See PayPal s HTML Variables for a Regular Payment Button page 32 for more information N A paypal_cancel_ return URL of the Web page to show the customer if Regular Required the customer cancels the regular PayPal payment payment Example http cancel example com String 255 paypal_customer_ email Customer s email address including the full Both Optional domain name for example jdoe example com String 255 paypal_handling Do NOT use this field if you are using Regular Optional purchaseTotals_freightAmount or if you payment have an item with item_ productCode handling only CyberSource populates the handling variable in the button based on your values for these fields If you are not using purchaseTotals_ freightAmount or an item for handling paypal_handling becomes the value for the handling variable in the button This is a flat handling charge for the order The value is NOT multiplied by the number of items in the order paypal_quantity The value overrides any profile based handling charge you have set See Specifying Shipping and Handling Charges for a Regular Payment Button page 34 for more details 1 Required if any shipping information is included 2 Optional but CyberSource encourages you to send t
22. 6F9IZB8q8J 0CSjmBWgrZdh VKHgPL2SKuRGri fwXDCGFOJonj YKSEKExeSCmR eZRUwzIpUmnKAY r7Hqzd ellIslJuFZ9 ikKQO2hK wRq5VYIL22MGn0fY8GZ6CBmM76ceYoj0e Xm1pUOLjANQnx2MVMI85hhpMAcaM S lt form gt PayPal Services User Guide August 2013 58 Appendix A Examples for the Simple Order API Processing a Credit Example Request payPalCreditService_ run true merchant ID infodev merchantReferenceCode 4 82046C3A7E94F3 payPalCreditService_ payPalPaymentRequest ID 0305782650000167905052 purchaseTotals_ currency USD purchaseTotals_ grandTotalAmount 10 00 Example Reply request ID 0305782650000167943227 merchantReferenceCode 4 82046C3A7E94F5 decision ACCEPT reasonCode 100 payPalCreditReply reasonCode 100 payPalCreditReply requestDateTime 2005 06 19T18 49 552 payPalCreditReply reconconciliationID RYX9483QxX04WC4 payPalCreditReply amount 10 00 purchaseTotals currency USD PayPal Services User Guide August 2013 59 Appendix A Examples for the Simple Order API Creating a Shopping Cart Button Example Request payPalButtonCreateService run true payPalButtonCreateService buttonType shopping cart merchant ID infodev merchantReferenceCode 4 82046C3A7E94F5 paypal _cancel return http paypalcancel example com paypal _return http paypalsuccess example com paypal_item_name_1 Book paypal_item_number_1 999999 paypal amount _1 25 95 paypal quantity _1 1 paypal_shipping 1 3 95 paypal_shipping2_ 1 0 00 paypal_ hand
23. Accounts Set Up Shipping Calculations Password Currency Balances Payment Receiving Preferences Notifications Gifts and Discounts Instant Payment Notification Language Preference Recurring Payments Preferences Time Zone Pay List Reputation Multi User Access Customer Service Message API Access Website Payment Preferences Getting Started Steps Encrypted Payment Settings Business Information Custom Payment Pages Invoice Templates Language Encoding PayPal Services User Guide August 2013 25 Chapter 2 Setting Up Your System Step 2 Click the Grant API Permission link My Account Send Money Request Money Merchant Services Auction Tools Products amp Services Overview AddFunds Withdraw History Resolution Center Profile Setting up PayPal API Credentials and Permissions Select one of the following options to use PayPal s secure Application Programming Interfaces APIs If you re not sure what you need ask your shopping cart or solution provider Grant API Permission to your shopping cart or Request API Credentials to create an API solution provider if the cart will make API calls on username and password for either your your behalf preintegrated shopping cart or a custom solution that you are developing Learn more about PayPal API concepts and terminology Contact Us Leaal Aareements Developers Step 3 For testing enter cybersource_paypal_apil cybersource com which is the CyberSource API account username For
24. CyberSource PayPal Services User Guide Simple Order API August 2013 CyberSource the power of payment CyberSource Corporation HQ P O Box 8999 San Francisco CA 94128 8999 Phone 800 530 9095 CyberSource Contact Information For technical support questions go to the Home page in the Business Center to see the contact information appropriate for your account Visit the Business Center your central location for managing your online payment transactions at https ousinesscenter cybersource com For general information about our company products and services go to http www cybersource com For sales questions about any CyberSource Service email sales cybersource com or call 650 432 7350 or 888 330 2300 toll free in the United States Copyright 2013 CyberSource Corporation All rights reserved CyberSource Corporation CyberSource furnishes this document and the software described in this document under the applicable agreement between the reader of this document You and CyberSource Agreement You may use this document and or software only in accordance with the terms of the Agreement Except as expressly set forth in the Agreement the information contained in this document is subject to change without notice and therefore should not be interpreted in any way as a guarantee or warranty by CyberSource CyberSource assumes no responsibility or liability for any errors that may appear in this document
25. EDEX payment shipTo_state State or province to which to ship the product Regular Optional 3 String 2 Use the two character codes See the payment Support Center for a list of valid codes shipTo_street1 First line of the address to which to ship the Regular Optional 2 String 60 product payment shipTo_street2 Second line of the address to which to ship Regular Optional 2 String 60 the product payment 1 Required if any shipping information is included 2 Optional but CyberSource encourages you to send the shipping address to increase chances that the transaction will be covered under PayPal s Seller Protection Policy See Sending the Shipping Address for a Regular Payment Button page 33 3 Required if shipTo_country is US or CA PayPal Services User Guide August 2013 46 Chapter 3 Requesting Services with the Simple Order API Reply Fields The following table describes the reply fields for creating a button The fields you receive are the same for either type of button Table 5 Reply Fields for Button Create Reply Field Description Data Type amp Length decision Summarizes the result of the overall request The field can contain String 6 one of the following values m ACCEPT ERROR REJECT invalidField_0 N Fields in the request that contained invalid data These reply fields String are included as an aid to software developers only No attempt 100 should be made to use
26. In your request to create the button set the button type to shopping cart instead of buy To specify the information about the different items use the numbered item specific fields listed below Start the numbering with 1 See the example requests below All of the fields are optional See PayPal s Merchant User Manual and Integration Guide for more information about on0_ and the similar fields paypal_item_name_ paypal_shipping_ on0_ paypal_item_number_ paypal_handling_ os0O_ paypal_quantity_ paypal_tax_ on1_ paypal_amount_ paypal_shipping2_ os1_ Do not include any of CyberSource s standard API fields for items for example do not use item_0_unitPrice Also you do not need to provide a grand total Note for the offer If you want to specify cart wide tax or handling charges use these fields paypal_tax_cart This value overrides any item level paypal_tax_ values or profile based tax paypal_handling_cart This value is added to any item level shipping or handling charges you have specified with paypal_ shipping _ and or paypal_handling_ values PayPal Services User Guide August 2013 54 Chapter 4 Creating a Shopping Cart Button Step 4 Send CyberSource the request as you would for a regular payment button The reply you receive contains the same API reply fields as for a regular payment button If you have configured your CyberSource account so that you are forwarded your IPN messages you
27. LMAkGALIUEBhMCVVMXEZARB9NVB AgTCkNhbGlmb3JuaWExXETAPBgNVBAcTCFNhbiBKb3N1MRUwEwYDSIb3DQEBAQUABIGAgOSFsADkAz5103qK8w e8z3zt86F9IZB8q8J 0CSjmBWgrZdh VKHgPL2SkKuRGri fwXDCGFOJonj YKSEKExeSCmR eZRUwzIpUmnKAY r7Hqzd ellIslJuFZ9 ikKQO2hK wRq5VYIL22MGn0fY8GZ6CBmM76ceYoj0e Xm1pUOLjANQnx2MVMI85hhpMAcaM eek ims END PKCS7 gt lt form gt lt c encryptedFormData gt lt c unencryptedFormData gt lt form action https www paypal com cgi bin webscr method post gt PayPal Services User Guide August 2013 62 Appendix A Examples for the Simple Order API lt input type image src https https www paypal com en_US i btn x click but23 gif border 0 name submit gt lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input lt input type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden name cmd value _s xclick gt name business value a person example com gt name first_name value Joe gt name Smith value Smith gt name addr
28. Use the Regular Optional String 2 two character ISO codes See the Support payment Center for a list of codes shipTo_firstName First name of person receiving the product Regular Optional String 60 payment shipTo_lastName Last name of person receiving the product Regular Optional 2 String 60 payment 1 Required if any shipping information is included 2 Optional but CyberSource encourages you to send the shipping address to increase chances that the transaction will be covered under PayPal s Seller Protection Policy See Sending the Shipping Address for a Regular Payment Button page 33 3 Required if shipTo_country is US or CA PayPal Services User Guide August 2013 45 Chapter 3 Table 4 Button Create Request Fields Continued Requesting Services with the Simple Order API Request Field Description Use With Required Data Button Optional Type amp Length shipTo_postalCode Postal code for the shipping address The Regular Optional 3 String 10 postal code must consist of 5 to 9 digits payment If the shipping country is the U S the 9 digit postal code must follow this format 5 digits dash 4 digits Example 12345 6789 If the shipping country is Canada the 6 digit postal code must follow this format alpha numeric alpha space numeric alpha numeric Example A1B 2C3 shipTo_ Shipping method for the product For Regular Optional String 10 shippingMethod example F
29. _return 30 paypal_cmd 33 payPalCreditService 48 paypal_custom 33 paypal_invoice 33 paypal_notify_url 33 paypal_return 8 28 30 PDT 37 described 11 reply variables 66 POST from PayPal 37 PayPal Services User Guide August 2013 product codes 74 R reason codes 51 reconciliation IDs 11 reconciliation with settlement file 29 refunds described 10 Simple Order API 48 regular payments described 8 IPN events 13 IPN variables 67 shipping address 33 shipping and handling 34 specifying tax 35 variables in the button 32 reports 13 request IDs 11 and credits 48 S sample code 56 sandbox 53 Security Center 18 Seller Protection Plan 17 31 settings 20 settlement file 29 shipping address 31 33 shipping and handling 34 shipping goods 11 shopping cart button 54 signing up CyberSource 29 PayPal 19 success URL 8 28 76 Index ABCDEFGHIJKLMNOPQRSTUVWXYZ T tax 35 testing 53 time format 47 tx token 66 U unencrypted button 36 UTC 47 PayPal Services User Guide August 2013 77
30. address Both Required String 50 billTo_country Country of the billing address Use the two Both Required String 2 character ISO codes See the Support Center for a list of codes billTo_email Customer s email address including the full Both Optional String domain name for example 255 jdoe example com billTo_firstName Customer s first name Both Required String 60 billTo_lastName Customer s last name Both Required String 60 billTo_postalCode Postal code for the billing address The postal Both Required if String 10 code must consist of 5 to 9 digits country is If the billing country is the U S the 9 digit ee a postal code must follow this format alae 5 digits dash 4 digits Example 12345 6789 If the billing country is Canada the 6 digit postal code must follow this format alpha numeric alpha space numeric alpha numeric Example ALB 2C3 billTo_state State or province of the billing address Use Both Required if String 2 the two character codes See the Support country is Center for a list of valid codes U S or Canada item_ _ Type of product The default value is Regular Optional String 30 productCode default See Product Codes page 74 for payment a list of valid values If you set this to a value other than default stored_value or any of the values related to shipping and or handling the item_ quantity item_ _ productName and item_ productSKU fields are required 1 Required
31. al_item_number and item_ _ productSKU in the request paypal_ quantity This becomes the value for the quantity Regular See Integer variable in the button This is the quantity of payment description no limit items to be purchased If omitted the value defaults to 1 and does not show in the payment flow Make sure to include this if you are providing the paypal_shipping2 field Note Although CyberSource has a similar API field item_ quantity the quantity variable in the button is NOT populated based on CyberSource s item_ _ quantity field 1 Required if any shipping information is included 2 Optional but CyberSource encourages you to send the shipping address to increase chances that the transaction will be covered under PayPal s Seller Protection Policy See Sending the Shipping Address for a Regular Payment Button page 33 3 Required if shipTo_country is US or CA PayPal Services User Guide August 2013 42 Chapter 3 Table 4 Button Create Request Fields Continued Requesting Services with the Simple Order API Request Field paypal_return Description After a customer approves a regular payment at PayPal s site they are returned to a URL at your Web site for example http success example com CyberSource suggests that you set the default URL for regular payments Note This value overrides the value you may have configured to use with PayPal s Auto Return See Enabling Auto Retur
32. alue or one of the values related to shipping and or handling Note This value is not used for the item_ number variable in the button paypal_item_ number is used for that see the field description in this table You may include both item_ _productSKU and paypal_item_ number in the request item_ _ quantity default value is 1 Quantity of the product being purchased The See description Regular payment Integer 10 Required if item_ productCode is NOT default stored_value or one of the values related to shipping and or handling Note This value is NOT used for the quantity variable in the button paypal_ quantity is used for that see the field description in this table This field is used to calculate the value that goes into the amount variable in the button You may include both item_ _ quantity and paypal_ quantity in the request 1 Required if any shipping information is included 2 Optional but CyberSource encourages you to send the shipping address to increase chances that the transaction will be covered under PayPal s Seller Protection Policy See Sending the Shipping Address for a Regular Payment Button page 33 3 Required if shipTo_country is US or CA PayPal Services User Guide August 2013 39 Chapter 3 Requesting Services with the Simple Order API Table 4 Button Create Request Fields Continued Request Field item_ _taxAmount Description The sum of these
33. ane eects ns a Step 2 You request the PayPal Button Create PEO ALG ma o One e aL Service and createa Da regular payment button e ei nex coraeravon Payment Ostats Step 3 You receive the eee W a ee foot Tae re a 92a Qmo grows Ore J poo SS ABC Sei Pes Order The customer logs in P ub Paha i j authorizes the payment J Sf m m ee 5 apa ABC Corporation ee Be aoe The customer goes to your success Web page After PayPal processes the payment PayPal sends you an email notification of the payment you can turn this off if you do not want to get the emails PayPal sends the customer an email receipt for the payment f you are using the Hosted Order Page CyberSource sends to you and to the customer the email receipts that you configured Your PayPal account reflects the payment CyberSource receives PayPal s Instant Payment Notification IPN message for the payment See Information from PayPal Instant Payment Notification IPN page 12 PayPal Services User Guide August 2013 9 Chapter 1 Introduction CyberSource forwards you the IPN message if you configure your CyberSource account for this See Configuring Your CyberSource Account page 29 The information from the IPN is included in CyberSource s Payment Events Report See Information from CyberSource Reports page 13 The details for the payment are ava
34. ansactions will still be forwarded to Note CyberSource The data from those transactions will be included in the Payment Events Report but not in the Business Center To reduce inconsistency within your transaction management system you should perform all of your PayPal transactions through CyberSource The Payment Events Report includes the information from every IPN message that is forwarded to you If the system that receives your IPN messages is not available PayPal will repeat forwarding each IPN message at specific intervals until your system receives it or until PayPal s system reaches its retry limit Each of these instances will be included in the Payment Events Report so you will see multiple occurrences of the same information in the report if your system does not receive the IPN message the first time it is forwarded to you PayPal Services User Guide August 2013 13 Chapter 1 Introduction a Capture Detail Report Lists the card type as PayPal for your PayPal transactions If you are already subscribed to these reports then you will automatically start to see PayPal transactions in the reports If you are a new user of these reports you can subscribe to and obtain the reports in the Business Center For general information about the reports see the online help in the Business Center Information from CyberSource Transaction Details in the Business Center You can view the details of your PayPal transactions in th
35. ariables Table 10 IPN Variables for Regular Payments Continued Variable receiver email Description Max Length Merchant s primary email address If the payment is sent to a non 127 primary email address on your PayPal account the receiver _ email will still be your primary email receiver id Merchant s unique account ID same as the referral ID 13 settle amount Amount deposited into the account s primary balance after a currency conversion either by automatic conversion through your Payment Receiving Preferences or manual conversion through manually accepting a payment settle currency Currency of settle amount tax Amount of tax charged on the payment and For a shopping cart transaction PayPal appends the number of the item tax1 and so on The tax is only included if there was a tax wes f specific tax amount applied to a particular shopping cart item Because profile based tax may apply to other items in the cart the sum of tax might not total to tax txn_id PayPal s unique transaction ID 17 txn_type Type of transaction This field will contain one of the following values a cart Payment was sent by the customer via the PayPal Shopping Cart a send_money Payment was sent by your customer from the PayPal Web site using the Send Money tab a web_accept Payment was sent by your customer via Buy Now buttons Donations or Smart Logos verify sign Encrypte
36. art Logo payments The Credit Card Statement Name is the name that will appear on your customers credit card statements The name can only be 11 alpha numeric characters in length including spaces Credit Card Statement ApC CORP E Name Setting Your Credit Card Statement Name Whenever a customer funds a payment with a credit card your name will be included on the customer s credit card statement in the purchase description Setting your credit card statement name helps reduce chargebacks and customer confusion PayPal is appended at the beginning of the credit card statement name For A example YourCompany is included as PayPal YourCompany Note To set the credit card statement name go to the Payment Receiving Preferences page See the screen in Disabling Electronic Checks page 20 PayPal Services User Guide August 2013 21 Chapter 2 Setting Up Your System Entering the IPN URLs If you want to receive IPN notifications so that you can see the payment information in the Business Center return to the Profile Summary page A You can return to this page to change the URL as necessary Note Step 1 Click Instant Payment Notification Preferences This page is displayed Merchant Services Send Money Request Money My Account Overview Add Funds History Instant Payment Notification Preferences Back to Profile Summary PayPal s Instant Payment Notifi
37. ation will not be sufficient because it takes typically several days before the check clears PayPal Services User Guide August 2013 11 Chapter 1 Introduction Another disadvantage of PDT is that it is possible that the customer will close the browser before the redirect to your site is complete causing you to miss receiving the PDT information The information you receive with PDT is also available in CyberSource s reports and in the Instant Payment Notification message CyberSource recommends that you use one of these methods instead of PDT if you need a reliable order fulfillment indicator For information about setting up and using PDT see PayPal s Merchant User Manual and Integration Guide For information about the content of the PDT reply variables that you receive see PDT Reply Variables page 66 Information from PayPal Instant Payment Notification IPN PayPal s Instant Payment Notification IPN provides immediate notification about your payments and any events relating to them CyberSource automatically receives all of the IPN messages for your PayPal account and uses the information to populate CyberSource s reports Because CyberSource receives your IPN messages for you you do not need to set up your PayPal account to receive them You can configure your CyberSource account so that you are forwarded your IPN messages as soon as CyberSource receives them You might want to do this if you need to ship the ordered
38. cation IPN allows you to integrate PayPal payments with your website back end operations Instant Payment Notification IPN Off Instant Payment Notification IPN URL Money Market ATM Debit Card Referrals About Us Accounts Fees Privacy Plus Card Security Center Contact Us User Agreement Developers PayPal Services User Guide August 2013 22 Chapter 2 Setting Up Your System Step 2 Click Edit My Account Send Money Request Money Merchant Services Overview Add Funds History Instant Payment Notification Preferences Activate Instant Payment Notification Before activating Instant Payment Notification please read the instructions to ensure that you can support the notification system LJInstant Payment Notification integrates PayPal payment notification and authentication with your website s back end operations Check this box to activate Instant Payment Notification and enter the URL at which you will receive the payment notifications below Notification URL http Save Money Market ATM Debit Card Referrals About Us Accounts Fees Privacy Plus Card Security Center Contact Us User Agreement Developers Step 3 Check the box and enter one of these URLs For CyberSource s test environment https paypaltest ic3 com ipn For CyberSource s production environment https paypal ic3 com ipn PayPal Services User Guide August 2013 23 Chapter 2 S
39. ce Available Permissions See the Third Party Definitions for help l Use Express Checkout to process payments Issue a refund a specific transaction l Process your customers credit or debit card payments l Authorize and capture your PayPal transactions Create and manage PayPal payment buttons on your website Obtain your PayPal account balance L Obtain information about a single transaction Search your transactions for items that match specific criteria and display the results Initiate a transaction based on a prior transaction or existing billing agreement Create and manage Recurring Payments Obtain authorization for pre approved payments and initiate pre approved transactions Issue a refund for any prior transaction Initiate transactions to multiple recipients in a single batch L Dynamically encrypt PayPal payment buttons on your web site Consolidate funds from two or more child accounts to a master account Generate consolidated reports for all accounts Use Express Checkout to process mobile payments Authorize transactions with Universal Air Travel Plans jAdd Cancel PayPal Services User Guide August 2013 27 Chapter 2 Setting Up Your System Step 6 You can edit or view permissions from the Success page Log Out Security and Protection Search My Account Sen
40. complete If omitted or set to 0 the customer will not be able to edit the quantity and a default quantity of 1 will be used Optional Integer 1 payPalButtonCreate Service_buttonType Type of button to create Use one of the All following values a buy Regular payment button PayPal s Buy Now button shopping cart PayPal s Shopping Cart button Note If you are creating a button for a regular payment CyberSource prefers that you use the buy button Instructions for creating a shopping cart button are included in Chapter 4 Creating a Shopping Cart Button on page 54 Required String 30 payPalButtonCreate Service_run Set this field to true to request Both payPalButtonCreateService Required String 5 purchaseTotals _ currency This becomes the value forthe currency Regular code variable in the button This is the payment currency used for the order PayPal currently accepts orders that use USD CAD EUR GBP or JPY only 1 Required if any shipping information is included 2 Optional but CyberSource encourages you to send the shipping address to increase chances that the transaction will be covered under PayPal s Seller Protection Policy See Sending the Shipping Address for a Regular Payment Button page 33 3 Required if shipTo_country is US or CA Required String 5 PayPal Services User Guide August 2013 44 Chapter 3 Requesting Services with t
41. d option _selectionl Option 1 choice as entered by the customer 200 For a shopping cart transaction PayPal appends the number of the item option_selection1_1 and so on PayPal Services User Guide August 2013 69 Appendix B PayPal Reply Variables Table 10 IPN Variables for Regular Payments Continued Variable Description Max Length option_selection2 Option 2 choice as entered by the customer 200 and For a shopping cart transaction PayPal appends the number of the f item option selection2 1 and so on option _ selection2_ parent_txn_id In the case of a refund reversal or canceled reversal this variable 17 contains the txn_id of the original transaction while txn_id contains a new ID for the new transaction See the description of txn_id in this table payer business name Customer s company name 127 payer email Customer s primary email address Use this email to provide any 127 credits payer _id PayPal s unique customer ID 13 payer status Whether the customer has a verified account This field will contain one of the following values a Verified Customer has a Verified PayPal account a Unverified Customer has an Unverified PayPal account payment date PayPal s time stamp Example 18 30 30 Jan 1 2000 PST payment fee USD transaction fee for the payment The payment_ gross minus payment_ fee will equal the amount deposited into the receiver email account
42. d Money Request Money Merchant Services Products amp Services Community Overview Add Funds Withdraw History Resolution Center Profile Manage Third Party Access 0 You have successfully added cybersource_paypal_api1 cybersource com Manage permission given to a third party application to access specific information in your account and take actions on your behalf For more information about the permissions you are granting see Third Party Permissions Third Party Username Organization cybersource_paypal_api1 cybersource com CyberSource Edit Third Party w Add New Third Party About Us ContactUs Legal Agreements Privacy Fees Site Feedback Information about FDIC pass through insurance Enabling Auto Return CyberSource recommends that you use PayPal s Auto Return which returns the customer immediately to your Web site at the conclusion of the purchase With Auto Return the typical PayPal hosted payment complete page is replaced with a page on your site allowing you to control the customer s experience at the end of the purchase and perform any follow on sales or marketing activities To enable Auto Return go to the Website Payment Preferences page You will need to provide the URL for the return page For more information about Auto Return see PayPal s Merchant User Manual and Integration Guide PayPal Services User Guide August 2013 28 Chapter 2 Setting Up Your System You can override th
43. d string used to validate the authenticity of the transaction PayPal Services User Guide August 2013 73 Product Codes APPENDIX This table lists the values you can use for the product code For the Simple Order API use the item_ productCode request field to specify the product code Table 11 Product Codes Product Code adult_content Definition Adult content coupon Coupon applied to the entire order default Default value for the product code CyberSource uses default when a request message does not include a value for the product code electronic good Electronic product other than software electronic_software Software distributed electronically rather than on disks or other media gift_certificate Gift certificate handling only Fee that you charge your customer to cover your administrative selling costs service Service that you perform for your customer shipping _and_handling The shipping portion is the charge for shipping the product to your customer The handling portion is the fee you charge your customer to cover your administrative selling costs shipping only Charge for transporting tangible personal property from your location to your customer You must maintain documentation that clearly establishes the location where the title to the property passed from you to your customer subscription Subscription to a web site or other c
44. de in your payPalButtonCreateService request However you could theoretically include paypal_amount in your request in addition to a purchaseTotals_grandTotalAmount or item_ _unitPrice because CyberSource allows you to pass most of the available PayPal variables generically as paypal_ lt variable name gt through the CyberSource API But you should not do this because CyberSource will then include two values for the amount variable in the button one based on the purchaseTotals_grandTotalAmount or item_ _ unitPrice values and one based on the paypal_amount field you sent This might lead to unpredictable amount values being displayed at PayPal s site when the customer goes there to approve the payment If a particular PayPal HTML variable is being populated by CyberSource based on the value you provide for a similar CyberSource API field the description for that PayPal variable in Table 4 page 38 will say so For example see the description for paypal_ amount in the table Sending the Shipping Address for a Regular Payment Button When creating a regular payment button you should include the shipping address in the request even though it is optional PayPal will check the shipping address you provide against the customer s list of confirmed addresses If the address is one of the confirmed addresses the transaction may be eligible for chargeback protection under PayPal s Seller Protection Policy See PayPal s Security Center at www pa
45. ds on the order form and clicks the Buy button At that time you send the order information to CyberSource as you would through the API and CyberSource redirects the order information to PayPal s Web site so that the transaction can be completed CyberSource passes to PayPal the request ID the success and cancellation URLs your billing information your email address the amount of the transaction and the currency PayPal Services User Guide August 2013 7 Chapter 1 Introduction When using the Hosted Order Page the transaction process is similar to that used by the API for regular payments Payments Through an API page 8 except that by default the customer is returned to these Hosted Order Page success and cancellation pages m If the customer completed the transaction successfully the customer is returned to the same success page as for card or check transactions a If the customer did not complete the transaction or if the transaction failed the customer is returned to the order form to choose another form of payment In addition if you configure the Hosted Order Page to do so CyberSource sends to you and to your customer an email receipt for the order See the samples in CyberSource Email Messages page 15 Payments Through an API You can process regular PayPal payments This is a standard payment for goods and services You can also process credits refunds This section describes the flow for accepting regula
46. e Auto Return URL that you have specified by using a particular API field in your Button Create Service request For more information see the description of paypal_return in Table 4 page 38 Website Payment Preferences Back to Profile Summary Auto Return for Website Payments Auto Return for Website Payments brings your buyers back to your website immediately after payment completion Auto Return applies to PayPal Website Payments including Buy Now Donations Subscriptions and Shopping Cart Learn More Auto Return On O off Return URL Enter the URL that will be used to redirect your customers upon payment completion This URL must meet the guidelines detailed below Learn More Return URL http return abecorp com Return URL Requirements The following items are required in order to set up Auto Return e Per the user agreement you must provide verbiage on the page displayed by the Return URL that will help the buyer understand that the payment has been made and that the transaction has been completed e You must provide verbiage on the page displayed by the Return URL that explains that payment transaction details will be emailed to the buyer e Example Thank you for your payment Your transaction has been completed and a receipt for your purchase has been emailed to you You may log into your account at https www paypal com to view details of this transaction Enabling the Settlement File Your PayPal paymen
47. e Business Center just as you can for other payment types You can search for transactions by date application type PayPal Button Create PayPal Credit PayPal Payment customer name and other transaction identifiers To find transactions processed with the Hosted Order Page you need to search for all transactions These transactions will be identified in the search results and search details as PayPal Button Create PayPal Email Messages You automatically receive email notifications for any successful payments canceled payments and pending payments You can turn off these emails by disabling them in your PayPal profile For more information see Disabling Email Notifications page 20 PayPal Services User Guide August 2013 14 Chapter 1 Introduction CyberSource Email Messages If you use the Hosted Order Page you can configure in the settings page notification messages in addition to those sent by PayPal Merchant s Purchase Data merchant ID infodev orderPage_serialNumber 1483085059980167904065 orderNumber 1148408942800 orderAmount 9 orderCurrency usd orderNumber publicSignature yy09eRmdwbyeKP1TpEBGClbdurk orderAmount_publicSignature OoZcyV2 90VGj Sj wbCWONwfxxTms orderCurrency publicSignature 3Fgv79o0TZ8e6cnJru2pzkG KyOY decision _publicSignature AQpYVF5 84wiP6aQ8jj 8mI15juVE billTo_street1 1111 Sample Avenue billTo_city Your Town billTo_state CA billTo_country us billTo_postalCode 99999 billTo_f
48. e using CyberSource s purchaseTotals_grandTotalAmount field to give a total amount for the order then you must use the purchaseTotals_taxAmount field to give the total tax for the order This method overrides any profile based amount you have set See below CyberSource Using an item level tax amount If you are using item level information instead of the purchaseTotals_ grandTotalAmount field you must specify the total tax for each item in item_ _ taxAmount See the information about items and grand totals in Getting Started with CyberSource Essentials This method overrides any profile based amount you have set See below PayPal Services User Guide August 2013 35 Chapter 3 Requesting Services with the Simple Order API Table 3 Methods for Specifying an Order s Tax Continued Method Description PayPal You can configure your PayPal profile to use certain tax amounts based on the Using a profile based tax customer s country and state See PayPal s Merchant User Manual and Integration amount Guide for more information PayPal You can configure your PayPal account so that you can override the profile based Overriding the profile based tax amount by using a the tax HTML variable when creating the button See the tax amount description of the corresponding CyberSource API field paypal_tax in Table 4 page 38 Interpreting CyberSource s Reply CyberSource returns to you an encrypted version and an unencry
49. er a partial amount description or the full amount of the payment You must include either this field or purchaseTotals_ grandTotalAmount in your request See the information about items and grand totals in Getting Started with CyberSource Essentials This value cannot be negative merchantID Your CyberSource merchant ID Use the same Required String 30 merchantID for evaluation testing and production merchantReferenceCode Merchant generated order reference or tracking Required String 50 number See the information about order tracking in Getting Started with CyberSource Essentials orderRequestToken The request token value returned from a previous Required String request This value links the previous request to the 256 current follow on request This field is an encoded string that does not contain any confidential information such as account numbers or card verification numbers The string can contain a maximum of 256 characters payPalCreditService_ Request ID from the payment reply Required String 26 payPalPaymentRequest ID payPalCreditService_ The requestToken value returned from a previous Optional String payPalPaymentRequest request for payPalButtonCreateService 256 Lehi The field is an encoded string that contains no confidential information such as an account number or card verification number The string can contain a maximum of 256 characters payPalCreditService_run Setto true to request payPalCreditService Required
50. erenceCode Order reference or tracking number that you provided in the String 50 request If you included multi byte characters in this field in the request the returned value might contain corrupted characters missingField_0 N Required fields that were missing from the request These reply String fields are included as an aid to software developers only No 100 attempt should be made to use these fields for end user interaction See the information about missing and invalid fields in Getting Started with CyberSource Essentials payPalCreditReply_amount Amount of the credit String 15 payPalCreditReply_ A numeric value corresponding to the result of the PayPal credit Integer 5 reasonCode request See Reason Codes page 51 for a list of possible values PayPal Services User Guide August 2013 50 Chapter 3 Requesting Services with the Simple Order API Table 7 PayPal Credit Reply Fields Continued Reply Field Description Data Type amp Length payPalCreditReply_ Reference number for the transaction that you use to reconcile your String 60 reconciliationID transactions payPalCreditReply_ Time of the PayPal credit The format is YYYY MM String 20 requestDateTime DDThh mm sszZ For example 2003 08 11T22 47 57Z is equal to August 11 2003 at 10 47 57 P M The T separates the date and the time The Z indicates UTC purchaseTotals_currency Currency used for the order String 5 reasonCode Numeric value corre
51. ess1 value 1040 Elm St gt name city value San Jose gt name SsState value CA gt name Zip value 95127 gt name amount value 25 99 gt name tax value 2 55 gt 5 name handling value 0 00 gt name Shipping value 4 95 gt name item_number value 3362710 gt name cancel_ return value http paypalcancel example com gt name undefined quantity value 0 gt name quantity value 0 gt name return value http paypalsuccess example com gt name item_name value Noveau Lamp gt name sShipping2 value 0 00 gt name currency code value USD gt name bn value CyberSource gt name notify_url value http example com ipn gt name invoice value RYXWMQX04MC9 gt name custom value RYXWMQX04MC9 0305782650000167905080 482046C3A7E94F5 gt lt form gt lt c unencryptedFormData gt lt c requestDateTime gt 2005 04 27T18 49 55Z lt c requestDateTime gt lt c recondiliationID gt RYXWMQX04MC9 lt c reconciliationID gt lt c buttonType gt buy lt c buttonType gt lt c payPalButtonCreateReply gt lt c replyMessage gt Processing a Credit Example Request lt requestMessage xmlns urn schemas cybersource com transaction data 1 37 gt lt merchant ID gt infodev lt merchantID gt lt merchantReferenceCode gt 482046C3A7E94F3 lt merchantReferenceCode gt lt purchaseTotals gt lt purchaseTotals gt lt currency gt USD lt currency gt lt grandT
52. etting Up Your System Step 4 Click Save My Account Send Money Request Money Merchant Services Overview Add Funds History Instant Payment Notification Preferences Back to Profile Summary You have successfully activated Instant Payment Notification PayPal s Instant Payment Notification IPN allows you to integrate PayPal payments with your website back end operations Instant Payment Notification IPN On Instant Payment Notification IPN URL https paypal ic3 com ipn Money Market ATM Debit Card Referrals About Us Accounts Fees Privacy Plus Card Security Center Contact Us User Agreement Developers You are ready to proceed to the next section PayPal Services User Guide August 2013 24 Chapter 2 Setting Up Your System Settings for API Users Only Enabling API Access To process PayPal payments and credits through the CyberSource API you must enable CyberSource to act on your behalf in the PayPal system Step 1 Under Account Information click the API Access link LogQut Security Center Search PayPal My Account Send Money Request Money Merchant Services Auction Tools Products amp Services Overview Add Funds Withdraw History Resolution Center Profile Profile Summary To edit your Profile information please click on a link below Account Information Financial Information Selling Preferences Email Credit Debit Cards Sales Tax Street Address Bank
53. f any shipping information is included 2 Optional but CyberSource encourages you to send the shipping address to increase chances that the transaction will be covered under PayPal s Seller Protection Policy See Sending the Shipping Address for a Regular Payment Button page 33 3 Required if shipTo_country is US or CA Regular Optional payment String 15 PayPal Services User Guide August 2013 43 Chapter 3 Requesting Services with the Simple Order API Table 4 Button Create Request Fields Continued Request Field paypal_ tax Description Use With Button Do NOT use this field if you are using the Regular purchaseTotals_taxAmount or item_ _ payment taxAmount field CyberSource populates the tax variable in the button based on your values for these fields If you are not using the purchaseTotals _ taxAmount or item_ _taxAmount field paypal_tax becomes the value for the tax variable in the button This is a flat tax for the order The value is NOT multiplied by the number of items in the order paypal_quantity The value overrides any profile based tax charge you have set See Specifying Tax for a Regular Payment Button page 35 for more details Required Optional Optional Data Type amp Length String 15 paypal_undefined_ quantity If set to 2 the customer will be able to edit the Regular quantity at PayPal s site They will see a payment quantity field that they must
54. fields Merchants Using the Hosted Order Page Merchants who use the Hosted Order Page cannot use the PayPal return fields a Existing merchants Your settings are transferred Customers are now returned to the default Hosted Order Page receipt and decline pages a New merchants You need to call CyberSource Customer Support to be enabled for the Hosted Order Page After that you need to configure your Hosted Order Page settings a In the Business Center go to Settings gt HOP Settings Scroll to the Payment Types subsection Check the box for PayPal You can choose PayPal as sole form of payment or any of the other forms available Enter your PayPal login ID If you use the Hosted Order Page leave this field blank f Complete the other configuration fields as necessary for your Hosted Order Page implementation You can begin processing PayPal payments with the Hosted Order Page g Setthe payment currencies and payment types If you customize your order form use the field paymentOption to indicate the type of payment card check or paypal You can also set the currencies you want to accept for each payment type For more information see the Business Center Hosted Order Page User s Guide PayPal Services User Guide August 2013 30 Chapter 2 Setting Up Your System All Merchants Step 1 Enable cookies in your web browser Open your web browser and follow the instructions appropriate for your browser For Internet Ex
55. g See the pending_reason variable for the reason why the payment is pending You will receive another IPN when the status changes to Completed Failed or Denied Refunded You refunded the payment Reversed Payment was reversed due to a chargeback or other type of reversal The funds have been debited from your account balanced and returned to the customer Look for the reason for the reversal in the reason_code variable See below payment type Indicates whether the payment is instant or delayed This field will contain one of the following values echeck Electronic check instant Credit card PayPal balance or Instant Transfer PayPal Services User Guide August 2013 71 Appendix B PayPal Reply Variables Table 10 IPN Variables for Regular Payments Continued Variable Description Max Length pending reason Reason ifpayment_status Pending This field contains one of these values address Customer did not include a confirmed shipping address and you have your Payment Receiving Preferences set to manually accept or deny each of these payments echeck Electronic check has not cleared yet int1 You hold a non U S account and do not have a withdrawal method You must manually accept or deny this payment from your PayPal Account Overview multi currency You do not have a balance in the currency sent and you do not have your Payment Receiving Preferences set to automatically convert and accept the payment You
56. g information here gt lt billTo gt lt shipTo gt lt fill in shipping information here gt lt shipTo gt lt purchaseTotals gt lt currency gt USD lt currency gt lt purchaseTotals gt lt paypal gt lt item _name_1 gt Book lt item_name_1 gt lt item _number_1 gt 999999 lt item_number_1 gt lt amount_1 gt 25 95 lt amount_1 gt lt quantity_151 lt quantity_1 gt lt shipping 1 gt 3 95 lt shipping 1 gt lt shipping2_1 gt 0 00 lt shipping2_1 gt lt handling_1 gt 0 00 lt handling_1 gt lt tax_1 gt 0 00 lt tax_1 gt lt item_name_2 gt DVD lt item_name_2 gt lt item _number_2 gt 777777 lt item_number_ 2 gt lt amount 2 gt 18 95 lt amount_2 gt lt quantity 2 gt 1 lt quantity_2 gt lt shipping 2 gt 0 00 lt shipping 2 gt lt shipping2_ 2 gt 0 00 lt shipping2 2 gt lt handling 2 gt 0 00 lt handling 2 gt lt tax_2 gt 0 00 lt tax_2 gt lt paypal gt lt payPalButtonCreateService run true gt lt buttonType gt shopping cart lt buttonType gt lt payPalButtonCreateService gt lt requestMessage gt PayPal Services User Guide August 2013 65 PayPal Reply Variables Table 9 APPENDIX PDT Reply Variables if you are using Payment Data Transfer you receive these variables from PayPal in the POST when you create a regular payment button See Information from PayPal Payment Data Transfer PDT page 11 for more information PayPal s PDT Reply Variables Variable tx
57. he Simple Order API Table 4 Button Create Request Fields Continued Request Field Description Use With Required Data Button Optional Type amp Length purchaseTotals _ This becomes the value for the shipping Regular Optional String 15 freightAmount variable in the button This is the total freight payment amount for the order If you include this field purchaseTotals_grandTotalAmount is required This value overrides any profile based shipping charge you have set See Specifying Shipping and Handling Charges for a Regular Payment Button page 34 for more details purchaseTotals _ This becomes the value for the amount Regular See String 15 grandTotalAmount variable in the button This is the grand total payment description for the order You must include either this field or item_ _unitPrice in your request See the information about items and grand totals in Getting Started with CyberSource Essentials purchaseTotals _ This becomes the value for the tax variable Regular Optional String 15 taxAmount in the button This is the total tax for the order payment If you include this field purchaseTotals _ grandTotalAmount is required This value overrides any profile based tax charge you have set See Specifying Tax for a Regular Payment Button page 35 for more details shipTo_city City to which to ship the product Regular Optional 2 String 50 payment shipTo_country Country to which to ship the product
58. he shipping address to increase chances that the transaction will be covered under PayPal s Seller Protection Policy See Sending the Shipping Address for a Regular Payment Button page 33 3 Required if shipTo_country is US or CA PayPal Services User Guide August 2013 String 15 41 Chapter 3 Requesting Services with the Simple Order API Table 4 Button Create Request Fields Continued Request Field Description Use With Required Data Button Optional Type amp Length paypal_item_name This becomes the value forthe item_name Regular Optional String variable in the button This is the description payment 127 of the item If omitted the customer will see a field where they can enter a description of the item Note Although CyberSource has a similar API field item_ _productName the item_ name variable will NOT be populated based on CyberSource s item_ productName field You may include both paypal_item_ name and item_ _ productName in the request paypal_item_ This becomes the value for the item_ Regular Optional String number number variable in the button It is not payment 127 displayed to the customer but it is passed back to you upon completion of the payment If omitted it is not passed back to you Note Although CyberSource has a similar API field item_ _productSKU the item_ number variable will NOT be populated based on CyberSource s item_ _ productSKU field You may include both payp
59. ich fields are missing Resend the request with the complete information See the information about missing and invalid fields in Getting Started with CyberSource Essentials 102 One or more fields in the request contains invalid data Possible action See the reply fields invalidField_0 N for which fields are invalid Resend the request with the correct information See the information about missing and invalid fields in Getting Started with CyberSource Essentials 150 Error General system failure See the documentation for your CyberSource client for information about how to handle retries in the case of system errors 151 Error The request was received but there was a server timeout This error does not include timeouts between the client and the server Possible action To avoid duplicating the transaction do not resend the request until you have reviewed the transaction status in the Business Center See the documentation for your CyberSource client for information about how to handle retries in the case of system errors 152 Error The request was received but a service did not finish running in time Possible action To avoid duplicating the transaction do not resend the request until you have reviewed the transaction status in the Business Center See the documentation for your CyberSource client for information about how to handle retries in the case of system errors 223 A request was made t
60. ilable for you to view in the Business Center See Information from CyberSource Transaction Details in the Business Center page 14 PayPal Credits You can perform only one credit for an order for either a partial amount or the full amount of the payment You can refund a customer s money through the Business Center or by using an API to request the PayPal credit service Business Center Search for and retrieve the original payment request from the database by using the request ID or another identifier for the payment Then click a button in the Business Center interface to request the credit You must perform the credit within 60 days of the payment request PayPal credit service Provide the request ID from the original payment so that CyberSource can locate the payment information in the database You must perform the credit within 60 days of the payment request After a credit is processed CyberSource receives PayPal s Instant Payment Notification IPN message for the credit See Information from PayPal Instant Payment Notification IPN page 12 CyberSource forwards you the IPN message if you configure your CyberSource account for this See Configuring Your CyberSource Account page 29 The information from the IPN is included in CyberSource s Payment Events Report See Information from CyberSource Reports page 13 The details of the credit are available for you to view in the Business Center See
61. irstName John billTo_lastName Doe request ID 1484089639110167904065 decision ACCEPT reasonCode 100 paymentOption paypal orderPage_transactionType authorization PayPal Services User Guide August 2013 15 Chapter 1 Introduction Merchants Purchase Confirmation Sample Header Purchase Description Payment Details Order Number 1148408942800 Subtotal 9 00 Tax 0 00 Total 9 00 For Support contact Your Merchant 800 555 1212 merchant example com Order Details Payment Type paypal Customer ID Billing Address John Doe 1111 Sample Avenue Your Town CA 99999 Return Codes Result Code Request was processed successfully Transaction Details Transaction Type authorization Transaction Source Hosted Order Page Reconciliation ID Merchant Defined Data Field 1 Fast shipping Field 2 Gift Thank you and please visit us again PayPal Services User Guide August 2013 16 Chapter 1 Introduction Customer s Receipt Sample Header Purchase Description Payment Details Order Number 1148408942800 Subtotal 9 00 Tax 0 00 Total 9 00 For Support contact Your Merchant 800 555 1212 merchant example com Order Details Payment Type paypal Customer ID Billing Address John Doe 1111 Sample Avenue Your Town CA 99999 Thank you and please visit us again Chargebacks PayPal offers several services related to chargebacks a If the customer chooses a credi
62. lar testing environment for sending test transactions If using the Simple Order API make sure your CyberSource client is configured to send transactions to the test server See the documentation for your client for information about how to do this The buttons generated by CyberSource s test system submit the form to PayPal s Sandbox test environment htips www sandbox paypal com You need to set up your Sandbox account as soon as you begin creating your implementation See PayPal s Sandbox User Guide for instructions Always log in to the Sandbox before clicking any of your test buttons Then when you click a test button you will automatically go to the Sandbox site which mimics the live PayPal site that the customer logs in to PayPal Services User Guide August 2013 53 Creating a Shopping Cart CHAPTER Button Step 1 Step 2 Step 3 CyberSource s recommended solution is to use the regular payment button where the button type buy This is PayPal s Buy Now button which uses an aggregate amount for the total order However if you want to specify information about the individual items the customer is purchasing you can create a Shopping Cart button instead You should still read the information about creating a regular Buy Now button as this appendix covers only the differences between creating a Shopping Cart Note button and a regular Buy Now button See Chapter 3 Creating Buttons on page 32
63. ling 1 0 00 paypal tax_1 0 00 paypal _item_name_2 DVD paypal _item_number_2 777777 paypal amount _2 18 95 paypal quantity 2 1 paypal_shipping 2 0 00 paypal_shipping2 2 0 00 paypal_handling 2 0 00 paypal tax_2 0 00 Include the API fields for the billing and shipping information here PayPal Services User Guide August 2013 60 Appendix A Examples for the Simple Order API XML Examples Creating a Regular Payment Button Example Request lt requestMessage xmlns urn schemas cybersource com transaction data 1 23 gt lt merchant ID gt infodev lt merchantID gt lt merchantReferenceCode gt 482046C3A7E94F5 lt merchantReferenceCode gt lt billTo gt lt firstName gt Joe lt firstName gt lt lastName gt Smith lt lastName gt lt street1 gt 1040 Elm St lt street1 gt lt city gt San Jose lt city gt lt state gt CA lt state gt lt postalCode gt 95127 lt postalCode gt lt country gt US lt country gt lt billTo gt lt shipTo gt lt firstName gt Joe lt firstName gt lt lastName gt Smith lt lastName gt lt street1 gt 1040 Elm St lt street1 gt lt city gt San Jose lt city gt lt state gt CA lt state gt lt postalCode gt 95127 lt postalCode gt lt country gt US lt country gt lt shipTo gt lt purchaseTotals gt lt currency gt USD lt currency gt lt taxAmount gt 2 55 lt taxAmount gt lt grandTotalAmount gt 25 99 lt grandTotalAmount gt lt freightAmount gt 4 95 lt freightAmo
64. links the current request to a previous authorization request for a debit card or prepaid card This value is useful when using multiple payment methods to complete an order For details see the information about partial authorizations in the Credit Card Services User Guide 1 Required if any shipping information is included 2 Optional but CyberSource encourages you to send the shipping address to increase chances that the transaction will be covered under PayPal s Seller Protection Policy See Sending the Shipping Address for a Regular Payment Button page 33 3 Required if shipTo_country is US or CA PayPal Services User Guide August 2013 Regular payment Optional String 26 40 Chapter 3 Requesting Services with the Simple Order API Table 4 Button Create Request Fields Continued Request Field merchantID Description Use With Required Button Optional Your CyberSource merchant ID Use the Both Required same merchantID for evaluation testing and production Data Type amp Length String 30 merchantReference Code Merchant generated order reference or Both Required tracking number CyberSource suggests you use a unique value for each order See the information about tracking orders in Getting Started with CyberSource Essentials String 50 paypal_amount CyberSource suggests you do NOT use this Neither See in your request for a regular payment button description as
65. live transactions enter paypal_cybersource_apil cybersource com PayPal My Account Send Money Request Money Merchant Services Products amp Services Community Overview Add Funds Withdraw History Resolution Center Profile Add New Third Party Permissions Manage permission given to a third party application to access specific information in your account and take actions on your behalf For more information about the permissions you are granting see Third Party Permissions Third Party Permission Username source_paypal_api1 cybersource com Lookup Cancel cybersource_paypal_api1 cybersource com About Us ContactUs Legal Agreements Privacy Fees Site Feedback Information about FDIC pass through insurance Step 4 Click Lookup PayPal Services User Guide August 2013 26 Chapter 2 Setting Up Your System Step 5 Select the permissions circled in red in the following figure and then click Add PayPal My Account Send Money Request Money Merchant Services Products amp Services Community Overview Add Funds Withdraw History Resolution Center Profile Add New Third Party Permissions Manage permission given to a third party application to access specific information in your account and take actions on your behalf For more information about the permissions you are granting see Third Party Permissions Third Party Permission Username cybersource_paypal_api1 cybersource Lookup Organization CyberSour
66. llow on service It uses the requestID returned from a previous payPalButtonCreateService request to link the credit to the payment Send the request ID value in the payPalCreditService_payPalPaymentRequestID field CyberSource uses these values to look up the customer s billing and account information from the original payment so you do not have to supply those fields in the payPalCreditService request See Appendix A Examples for the Simple Order API on page 56 for example requests and replies When requesting the service do not include any other ICS services in the request PayPal Services User Guide August 2013 48 Request Fields The following table lists the request fields for processing a credit Chapter 3 Requesting Services with the Simple Order API Table 6 PayPal Credit Request Fields Request Field Description Required Data Optional Type amp Length item_ _ productCode Type of product The default value is default See Optional String 30 Product Codes page 74 for a list of valid values item_ productName Product s name Optional String 30 item_ _productSKU Product s identifier code Optional String 30 item_ _ quantity Quantity of the product being returned Optional Integer 10 item_ _taxAmount Total tax to apply to the product Optional String 15 item_ _unitPrice Amount of the credit At this time you can perform See String 15 only one credit for an order for eith
67. ly add the corresponding paypal_ lt variable_name gt field to PayPal Services User Guide August 2013 32 Chapter 3 Requesting Services with the Simple Order API your payPalButtonCreateService request to include that variable in the button This also allows you to easily use any new Buy Now button variables that PayPal might create in the future CyberSource does not validate the content of the HTML variable API fields that you send For some of the available HTML variables CyberSource automatically assigns values and does not need your input Specifically CyberSource sets the values Important for cmd business custom invoice and notify url and does not provide corresponding API fields for you to use If you send fields called paypal_cmd paypal_business paypal_custom paypal_invoice or paypal_notify_url in your request the request will be rejected Some of CyberSource s regular API fields for specifying amounts and item level information are similar to or duplicate the function of some of PayPal s HTML fields For example PayPal has an HTML variable called amount CyberSource has similar API fields called purchaseTotals_grandTotalAmount and item_ _unitPrice and one of these two are required in the payPalButtonCreateService request CyberSource automatically populates the PayPal amount variable that is included in the button with a value based on the purchaseTotals_grandTotalAmount or item_ _unitPrice values that you provi
68. mple the colon in http is translated to 3A in the IPN message A sample IPN message looks like this line breaks have been added for clarity status Completed amp address_zip 47405 amp mc_shipping 0 00 amp mc_handling 0 00 amp first_name Larry amp mc_fee 1 49 amp address _name Larry Smith amp notify version 1 6 amp custom 0000015593 2C1036035196510167905065 amp payer _status verified amp business jdoe 40companyABC com amp address_country United States amp num_cart_items 1 amp mc_handling1 0 00 amp address city bloomington amp payer _email lsmith 40customer com amp verify _sign A0SZ O1CLAWJ jd5 kpi9BUKj Y1uAIQAZfebUT8pdPM2vJIhPr9AHE if amp mc_shipping1 0 00 amp tax1 0 00 amp txn_id 1LM18508KU470513M amp payment _type instant amp last_name Smith amp receiver email jdoe companyABC com amp item_name1l Book amp address state IN amp payment fee 1 49 amp quantity1 1 amp receiver _id 8CZZHSZRQUHUA amp t xn_type cart amp mc_currency USD amp mc_gross_ 1 41 00 amp test_ipn 1 amp payment _gross 41 00 PayPal Services User Guide August 2013 67 Appendix B PayPal Reply Variables Table 10 IPN Variables for Regular Payments Variable Description Max Length address city City of customer s street address 40 address country Country of customer s address 64 address name Name used with address included when the customer provides a gift 128
69. n page 28 Use With Required Button Optional Regular Required payment Data Type amp Length String 255 paypal_shipping Do NOT use this field if you are using purchaseTotals_freightAmount or if you have an item with item_ _ productCode shipping onlyor shipping _and_handling CyberSource populates the shipping variable in the button based on the values for these fields If you are not using purchaseTotals _ freightAmount or an item for shipping and handling paypal_shipping becomes the value for the shipping variable in the button This is a flat shipping charge for the order The value is NOT multiplied by the number of items in the order paypal_quantity The value overrides any profile based handling charge you have set See Specifying Shipping and Handling Charges for a Regular Payment Button page 34 for more details Regular Optional payment String 15 paypal_shipping2 This becomes the value for the shipping2 variable in the button This is the cost of shipping each additional item beyond the first item PayPal multiplies this value by the number of items in the order minus one paypal_ quantity 1 and then adds it to the values for the shipping variable and the handling variable in the button to give the total shipping and handling charge they display to the customer See Specifying Shipping and Handling Charges for a Regular Payment Button page 34 for more details 1 Required i
70. name and item_name Item name passed by you or entered by the customer if not passed 127 by you If this is a shopping cart transaction PayPal appends the number of the item item _name1 and so on item_number and item_number last_name Pass through variable for you to track purchases that is passed back 127 to you at completion of payment Not returned if not included in the button Customer s last name PayPal Services User Guide August 2013 64 68 Table 10 Appendix B PayPal Reply Variables IPN Variables for Regular Payments Continued Variable mce_currency Description Max Length Currency of the payment The value will be USD CAD EUR GBP or JPY mc_fee Transaction fee for the payment The mc_gross minus mc_ fee will equal the amount deposited into the receiver email account Equivalent to payment_ fee for USD payments If this amount is negative it indicates a refund or reversal and the refund or reversal can be for the full or partial amount of the original transaction mc_gross and mc_gross Full amount of the customer s payment before transaction fee is subtracted Equivalent to payment_ gross for USD payments If this amount is negative it indicates a refund or reversal and the refund or reversal can be for the full or partial amount of the original transaction For a shopping cart transaction PayPal appends the number of the item mc_gross_1 andsoon
71. name Nouveau Lamp paypal _item_number 3362710 PayPal Services User Guide August 2013 57 Example Appendix A Reply Examples for the Simple Order API request ID 0305782650000167905080 merchantReferenceCode 482046C3A7E9XYZ decisi on ACCEPT reasonCode 100 payPal payPal payPal But But But tonCreateReply reasonCode 100 tonCreateReply buttonType buy tonCreateReply amount 33 49 purchaseTotals_ currency USD payPalButtonCreateReply requestDateTime 2005 04 27T18 49 552Z payPalButtonCreateReply reconconciliationID RYXWMQX04MC9 payPalButtonCreateReply unencryptedFormData lt form action https www paypal com cgi bin webscr method post gt type image src https https www paypal com en_US i btn x click but23 gif border 0 name submit gt lt input lt input type hidden name cmd value _s xclick gt lt input type hidden name business value a person example com gt lt input type hidden name first name value Joe gt lt input type hidden name Smith value Smith gt lt input type hidden name address1 value 1040 Elm St gt lt input type hidden name city value San Jose gt lt input type hidden name state value CA gt lt input type hidden name zip value 95127 gt lt input type hidden name amount value 25 99 gt lt input type hidden name tax value 2 55 gt lt input type hidden name handling value 0 00 gt
72. nt Payment Notification Muller Aeease Preapproved Payments Preferences Reputation API Access i Customer Service Message Getting Started Steps s Website Payment Preferences Business Information Encrypted Payment Settings Custom Payment Pages Invoice Templates Risk Controls Language Encoding This chapter describes the PayPal settings needed to make your PayPal and CyberSource accounts work together To configure additional PayPal settings see PayPal s Merchant User Manual and Integration Guide which is available at www paypal com PayPal Services User Guide August 2013 19 Chapter 2 Setting Up Your System Settings for Hosted Order Page and API Disabling Email Notifications If you do not want to receive an email message every time a customer pays with PayPal at your store you can turn off email notifications To do this go to the Notifications page and disable notifications for I receive money with PayPal and I receive PayPal Website Payments and Instant Purchase Notifications Back to Profile Summary To save changes to your Notifications preferences please click Save below General Notifications I would like to receive C PayPal Periodical Monthly Newsletter and Product Updates O Auction Seller Tips O ALL Policy Change Notices O Customer Feedback Surveys oO Partner Third Party Promotions C PayPal Developer Network updates Payment Notifications Please send me an email when
73. o credit an order for which there is no corresponding unused payment record Occurs if there was not a previously successful payPalButtonCreateService request or if the previously successful payment has already been used by another payPalCreditService request Possible action Verify that have not already credited this payment or verify that you are crediting the correct payment 233 General decline by the processor Possible action Request a different form of payment 234 There is a problem with your CyberSource merchant configuration Possible action Do not resend the request Contact Customer Support to correct the configuration problem 236 Processor failure Possible action Wait a few minutes and resend the request 239 The requested transaction amount must match the previous transaction amount Possible action Correct the amount and resend the request PayPal Services User Guide August 2013 52 Chapter 3 Requesting Services with the Simple Order API Table 8 Reason Codes Continued Reason Description Code 241 The request ID is invalid Possible action Verify you are using the correct request ID 250 Error The request was received but there was a timeout at the payment processor Possible action To avoid duplicating the transaction do not resend the request until you have reviewed the transaction status in the Business Center Testing You can use CyberSource s regu
74. on page 54 A PayPal also has a Shopping Cart button that uses individual item information For more information about regular payments see PayPal Payments page 7 Requesting the Service To request the service send a request with payPalButtonCreateService_run true Use the payPalButtonCreateService_buttonType field to indicate which type of button you want See Appendix A Examples for the Simple Order API on page 56 for example requests PayPal s HTML Variables for a Regular Payment Button The regular payment button PayPal s Buy Now button that CyberSource creates includes a list of HTML variables that give transaction information to PayPal and that control the display of the PayPal site when the customer goes there to approve the payment CyberSource adds paypal_ before the name of each variable to create the corresponding CyberSource API field that you use when creating the button For example PayPal has a variable called return The field you include in your request to CyberSource is paypal_return See the paypal_ fields in Table 4 page 38 Not all of the available PayPal HTML variables are listed in Table 4 only the basic ones you need to process a payment are included For the entire list of HTML variables available for use with a Buy Now button see PayPal s Merchant User Manual and Integration Guide If PayPal s guide lists any variables that you want to use that are not already listed in Table 4 simp
75. ontent PayPal Services User Guide August 2013 74 Index ABCDEFGHIJKLMNOPQRSTUVWXYZ A account configuration CyberSource 29 PayPal 19 API access 25 Auto Return 11 28 business 33 business account 7 button creation shopping cart 54 Simple Order API 32 Buy Now buttons See regular payments Buyer Complaint Process 17 C cancel URL 8 30 Capture Detail Report 14 chargebacks 17 cmd 33 configuring your account CyberSource 29 PayPal 19 confirmed address 17 cookies enabling 31 creating buttons shopping carts 54 Simple Order API 32 credit card statement name 21 PayPal Services User Guide August 2013 credits described 10 Simple Order API 48 currencies using multiple 29 custom 33 CyberSource reports 13 D date and time format 47 E electronic checks 20 email notifications 9 20 encrypted button 36 examples 56 F fulfilling orders 11 funding sources 7 G GMT 47 H Hosted Order Page Business Center settings 31 PayPal settings 20 75 INDEX Index ABCDEFGHIJKLMNOPQRSTUVWXYZ invoice 33 IPN described 12 message forwarding 30 notification URL 22 variables 67 mp_id 37 multiple currencies 29 N notify_url 33 O order fulfillment 11 order tracking 11 P Payment Data Transfer See PDT Payment Events Report 10 13 PayPal Account opening and configuring 19 PayPal business account 7 paypal_business 33 payPalButtonCreateService 32 paypal_cancel
76. otalAmount gt 10 00 lt grandTotalAmount gt lt payPalCreditService run true gt lt payPalPaymentRequest1ID gt 0305782650000167905052 lt payPalPaymentRequestID gt lt payPalCreditService gt lt requestMessage gt PayPal Services User Guide August 2013 63 Appendix A Examples for the Simple Order API Example Reply lt c replyMessage xmlns c urn schemas cybersource com transaction data 1 37 gt lt c merchantReferenceCode gt 482046C3A7E94F3 lt c merchantReferenceCode gt lt c request 1ID gt 0305782650000167943227 lt c requestID gt lt c decision gt ACCEPT lt c decision gt lt c reasonCode gt 100 lt c reasonCode gt lt purchaseTotals gt lt c currency gt USD lt c currency gt lt c purchaseTotals gt lt c payPalCreditReply gt lt c reasonCode gt 100 lt c reasonCode gt lt C amount gt 10 00 lt c amount gt lt c requestDateTime gt 2005 06 19T18 49 55Z lt c requestDateTime gt lt c reconconciliationID gt RYX9483QxX04WC4 lt c reconconciliationID gt lt c payPalCreditReply gt lt c replyMessage gt PayPal Services User Guide August 2013 64 Appendix A Examples for the Simple Order API Creating a Shopping Cart Button Example Request lt requestMessage xmlns urn schemas cybersource com transaction data 1 23 gt lt merchant ID gt infodev lt merchantID gt lt merchantReferenceCode gt 482046C3A7E94F5 lt merchantReferenceCode gt lt billTo gt lt fill in billin
77. plorer a Select Tools gt Internet Options gt Privacy b In the Settings section move the slider to the bottom Accept All Cookies c Click Apply d Click OK For Netscape Communicator a Select Edit gt Preferences b Click Advanced c Check the box Accept All Cookies and click OK Step 2 Send the shipping address When collecting information about the order CyberSource recommends that you collect the shipping address information even though it is optional PayPal will check the shipping address that you provide against the customers list of confirmed addresses If the address is one of the confirmed addresses the transaction may be eligible for chargeback protection under PayPal s Seller Protection Policy See PayPal s Security Center for more information If PayPal returns to you a different address than that entered by the customer in the Hosted Order Page use the address returned by PayPal when fulfilling the order PayPal Services User Guide August 2013 31 CHAPTER Requesting Services with the Simple Order API Creating Buttons The payPalBuittonCreateService lets you create a button for processing a regular payment with an aggregate amount for the order PayPal s Buy Now button and amounts instead of an aggregate order total This chapter discusses how Note to create PayPal s Buy Now button For information about requesting a Shopping Cart button see Chapter 4 Creating a Shopping Cart Button
78. pted version of the button in the payPalButtonCreateReply_encryptedFormData and payPalBuitonCreateReply_unencryptedFormDaia fields Use the encrypted version when in production and the unencrypted version when troubleshooting or testing your system See Appendix A Examples for the Simple Order API on page 56 for example replies You insert the button into your HTML page like this lt html gt lt body gt lt Insert your page header gt Click PayPal Checkout to proceed with your PayPal payment This will take you to the PayPal login page lt Replace the s below with the button which is a self contained form that CyberSource returns to you gt Ss lt body gt lt html gt The encrypted version of the button looks similar to this lt form action https www paypal com cgi bin webscr method post gt lt input type image src https https www paypal com en_US i btn x click but23 gif border 0 name sSubmit gt lt input type hidden name cmd value _s xclick gt lt input type hidden name encrypted value MIIGTQYJKoZIhvcNAQcDoIIGPj CCBj oCAQAxggE6MI IBNgIBADCBnj CBmDELMAkGA1UEBhMCVVMxEZARBgGNVB AgTCkNhbG1mb3 JuaWExETAPBGNVBAcTCFNhbiBKb3N1MRUWEWYDS 1b3 DOEBAQUABIGAgOSFSADkAz5103qK8w e823 zt 86F9IZB8q8J0 0CSjmBWgrZdh VKHgPL2SKuRGri fwxXDCGFOJonj YK5EKExeSCmR eZRUwzIpUmnKAY r7Hqzd ellIslJuFZ9 ikKQO2hK wRq5VYIL22MGn0fY8GZ6CBmMM76ceYoj0e Xm1pUOLJANQnx2MVMI85hhpMAcaM END PKCS7
79. quantity value 1 s lt input type hidden name quantity value 5 s lt input type hidden name return value http success example com gt lt input type hidden name item_ name value book gt lt input type hidden name sShipping2 value 0 00 gt lt input type hidden name Currency_code value USD gt lt input type hidden name bn value CyberSource gt lt input type hidden name notify_url value http example com ipn gt lt input type hidden name invoice value 0000028962 gt lt input type hidden name Custom value 0000028962 1141312425560167905065 001 gt lt form gt Receiving PayPal s POST Response If you are using PayPal s Payment Data Transfer PDT you receive a POST from PayPal when the customer is redirected back to your site after approving a regular payment See Information from PayPal Payment Data Transfer PDT page 11 for more information The POST contains a variable called st that indicates whether you can fulfill the order See PDT Reply Variables page 66 for a full list of information you receive PayPal Services User Guide August 2013 37 Chapter 3 Requesting Services with the Simple Order API Request Fields The following table lists the request fields for creating buttons Table 4 Button Create Request Fields Request Field Description Use With Required Data Button Optional Type amp Length billTo_city City of the billing
80. r PayPal payments at your site See Figure 1 page 9 for a diagram of the payment flow The customer shops at your Web store and selects items to purchase You collect the billing and shipping addresses and calculate tax and shipping 1 The customer chooses PayPal as the payment type from the list of payment types you provide 2 You send the order information to CyberSource in a request for the Button Create Service indicating that you want a button for a regular PayPal payment 3 Inthe reply you receive the button a self contained form containing the secure payment data PayPal requires Note that the service returns to you two buttons an encrypted version of the button to use in production and an unencrypted version to use when testing or troubleshooting 4 The customer clicks the button which POSTs the secure payment data to PayPal while taking the customer to the PayPal Web site to log in and authorize the payment 5 Depending on the result e PayPal directs the customer to the success page e If the customer clicks cancel PayPal directs the customer to the cancellation page which instructs the customer to choose a new payment type PayPal Services User Guide August 2013 8 Chapter 1 Introduction Figure 1 Processing a Regular PayPal Payment ie w e ee o n DJa Que ye Gee J paR ABC Corporation Order Step 1 The customer selects PayPal as the Devereter Pantarse Guartty Price Waves L
81. sponding to the result of the overall request Integer 5 See Reason Codes page 51 for a list of possible values requestID Unique identifier for the request String 26 requestToken Request token data created by CyberSource for each reply The String field is an encoded string that contains no confidential information 256 such as an account or card verification number The string can contain a maximum of 256 characters Reason Codes The following table lists the reason codes returned by the Simple Order API for the PayPal Services See the information about handling replies in Getting Started with CyberSource Essentials for a discussion of replies decisions and reason codes Because CyberSource may add reply fields and reason codes at any time proceed as follows Important a You should parse the reply data according to the names of the fields instead of their order in the reply For more information on parsing reply fields see the documentation for your client Your error handler should use the decision field to determine the result if it receives a reason code that it does not recognize PayPal Services User Guide August 2013 51 Table 8 Chapter 3 Requesting Services with the Simple Order API Reason Codes Reason Code 100 Description Successful transaction 101 The request is missing one or more required fields Possible action See the reply fields missingField_0 N for wh
82. t Notification CyberSource Guides The CyberSource documents are available on the Business Center Getting started Account management technical resources basics about the Simple Order API See Getting Started with CyberSource Essentials Business Center Configuring account settings and searching for order information See the Business Center User s Guide Hosted Order Page Payment order form hosted by CyberSource See the Business Center Hosted Order Page User s Guide Simple Order API API for accessing CyberSource services See the Credit Card Services User s Guide a Reporting Using the CyberSource reports See the Business Center Reporting User s Guide PayPal Services User Guide August 2013 18 CHAPTER Setting Up Your System Opening and Configuring Your PayPal Account If you do not already have a PayPal business account go to www paypal com to open one To configure your PayPal account log in and click the Profile tab My Account Send Money Request Money Merchant Services Overview Add Funds History Profile Profile Summary To edit your Profile information please click on a link below Account Information Financial Information Selling Preferences Email Credit Cards Sales Tax Street Address Bank Accounts Shipping Calculations Password Currency Balances Payment Receiving Notifications Gift Certificates and Reward Preferences Time Zone Vouchers Insta
83. t card as the funding source for the PayPal payment they have the normal chargeback dispute rights If the customer disputes the charge PayPal performs the initial chargeback processing and contacts you for documentation PayPal offers a Buyer Complaint Process that is applicable to all purchases regardless of the funding source When a customer files a complaint PayPal performs an investigation and contacts you for documentation PayPal also provides a service called the Seller Protection Plan SPP which helps protect merchants against chargebacks due to fraud The service is available only to qualifying merchants and only for orders where the shipping address matches a confirmed address on file at PayPal CyberSource indicates whether the address is confirmed or unconfirmed in the list of transaction details which you can view by searching for the transaction in the Business Center PayPal Services User Guide August 2013 17 Chapter 1 Introduction For more information about these services contact your PayPal Account Manager or visit PayPal s Security Center go to www paypal com and click Security Center at the bottom of the page Additional Documentation PayPal References The PayPal documents are available on the PayPal web site Sandbox User Guide PayPal Sandbox test environment a Merchant User Manual and Integration Guide Your PayPal profile setup regular payments Payment Data Transfer and Instant Paymen
84. ts and credits will be reflected in your CyberSource reports For many merchants this is sufficient to support reconciliation However if you prefer additional detail for reconciliation you might want to use PayPal s Settlement File In particular you might want to use it if you are accepting payments in multiple currencies as it documents the exchange rate conversion Contact your PayPal Account Manager for more information Configuring Your CyberSource Account You need to configure your CyberSource account differently depending on the method that you choose to send your transaction requests to CyberSource As of May 31 2006 the configuration process differs slightly for existing and new merchants PayPal Services User Guide August 2013 29 Chapter 2 Setting Up Your System Merchants Using the API The PayPal return fields paypal_return and paypal_cancel_return were optional They are now required for API users For information about integrating with CyberSource s API see Requesting Services with the Simple Order API page 32 Existing merchants Your PayPal ID and IPN URL are transferred to the new implementation You only need to configure the PayPal return fields if you have not so already See Information from PayPal Instant Payment Notification IPN page 12 a New merchants You need to call CyberSource Customer Support to provide your PayPal ID and IPN URL After that you need to configure the PayPal return
85. unt gt lt purchaseTotals gt lt paypal gt lt cancel return gt http paypalcancel example com lt cancel_ return gt lt return gt http paypalsuccess example com lt return gt lt item_name gt Nouveau Lamp lt item_name gt lt item_number gt 3362710 lt item_number gt lt paypal gt lt payPalButtonCreateService run true gt lt buttonType gt buy lt buttonType gt lt payPalButtonCreateService gt lt requestMessage gt PayPal Services User Guide August 2013 61 Appendix A Examples for the Simple Order API Example Reply lt c replyMessage xmlns c urn schemas cybersource com transaction data 1 23 gt lt c merchantReferenceCode gt 482046C3A7E94F5 lt c merchantReferenceCode gt lt c request1ID gt 0305782650000167905080 lt c requestID gt lt c decision gt ACCEPT lt c decision gt lt c reasonCode gt 100 lt c reasonCode gt lt c purchaseTotals gt lt c currency gt USD lt c currency gt lt c purchaseTotals gt lt c payPalButtonCreateReply gt lt c reasonCode gt 100 lt c reasonCode gt lt c encryptedFormData gt lt form action https www paypal com cgi bin webscr method post gt lt input type image srce https https www paypal com en_US i btn x click but23 gif border 0 name submit gt lt input type hidden name cmd value _s xclick gt lt input type hidden name encrypted value BEGIN PKCS7 MIIGTQYJKoZIhvcNAQcDoIIGPjCCBRjoCAQAxggE6MIIBNgIBADCBnjCBmDE
86. unts based on the overall order total See PayPal s freight amount Merchant User Manual and Integration Guide for more information PayPal You can configure your PayPal account so that you can override the Overriding the profile flat profile based shipping and handling amounts by using specific based freight amount HTML variables when creating the button PayPal s shipping handling and shipping2 HTML variables let you do this See the descriptions of the corresponding CyberSource API fields paypal_shipping paypal_handling and paypal_shipping2 in Table 4 page 38 Specifying Tax for a Regular Payment Button CyberSource and PayPal both have methods for you to specify the tax for an order When creating a regular payment button for an order with tax you need to choose which method you want to use to specify the tax amount You might already be familiar with CyberSource s methods if you process other payment types with CyberSource The following table describes your choices CyberSource s methods override any PayPal profiled based tax settings you have Important You should choose one of these methods and not send CyberSource tax fields as well as PayPal HTML variables for tax If you do the customer may see unexpected amounts for the tax when they go to PayPal s site to approve the payment Table 3 Methods for Specifying an Order s Tax Method CyberSource Using a total tax amount Description If you ar
87. urce com a Testing cybersource_paypal_apii cybersource com May 2010 a Added the link to request fields See linkToRequest in Table 4 page 38 PayPal Services User Guide August 2013 CHAPTER Introduction About PayPal Payments If you are not already familiar with how PayPal works consider opening a personal PayPal account to understand the customer s experience In general a customer opens a PayPal account and adds one or more funding sources such as a credit card or an electronic checking account When the customer chooses to pay with PayPal they must choose which funding source to use for the payment If the customer receives payments and accumulates stored value in their PayPal Account they may also choose to pay with those stored funds For more information go to www paypal com Before you can process any PayPal payments you must open and configure a PayPal business account and configure your CyberSource account to use PayPal as described in Chapter 2 Setting Up Your System on page 19 When you open your PayPal business account PayPal assigns you a PayPal account manager who will assist you with configuring your PayPal account PayPal Payments Payments Through the Hosted Order Page To begin processing regular PayPal orders through the Hosted Order Page you only need to configure your CyberSource account See Chapter 2 Setting Up Your System on page 19 The customer completes the billing and shipping fiel
88. yment Cancelation of a reversal of a payment Refund of a payment See IPN Variables for Regular Payments page 67 for a list of IPN variables you receive for a regular payment Information from CyberSource Reports The CyberSource reports listed below include information about your PayPal transactions The information in the reports comes from your API requests the Hosted Order Page and from the IPN messages that PayPal sends For detailed information about the reports see the Business Center Reporting User s Guide Payment Events Report Shows the latest status of your PayPal payments and credits and whether you can fulfill the order It is a daily report that includes any new information from the past 24 hours that PayPal has about any of your transactions For example when you request a payment if the payment is pending which happens if the customer pays with an electronic check the transaction is included in the report for the first time with a status of pending The next time the transaction is included in the report which could be several days later it will have a status of completed or denied which indicates whether you can ship the goods The transaction will be included again in the report if other events occur For example it is included again if the customer initiates a reversal or if you initiate a refund If you perform any PayPal transactions outside of the CyberSource interface the IPN messages for those tr
89. ypal com for more information If you do not send a shipping address in your request CyberSource will not substitute the billing address for the shipping address when sending the information to PayPal PayPal Services User Guide August 2013 33 Chapter 3 Requesting Services with the Simple Order API To determine if the shipping address was confirmed or unconfirmed search for the transaction in the Business Center The transaction details include whether the address was confirmed or unconfirmed Specifying Shipping and Handling Charges for a Regular Payment Button CyberSource and PayPal both have methods for you to specify freight charges shipping and handling charges When creating a regular payment button for an order with freight charges you need to choose which method you want to use to specify the freight amount You might already be familiar with CyberSource s methods if you process other payment types with CyberSource The following table describes your choices CyberSource s methods override any PayPal profiled based shipping and handling settings you have You should choose one of these methods and not send CyberSource shipping and handling fields as well as PayPal HTML variables for shipping and Important handling If you do the customer may see unexpected amounts for the shipping and handling when they go to PayPal s site to approve the payment Table 2 Methods for Specifying Shipping and Handling Charges

Download Pdf Manuals

Related Search

Related Contents

Inventaire SOS Patrimoine en péril : Manuel d`utilisateur  Belkin Screen Guard Mirror Overlay  Manuale d`installazione CONSERVARE CON CURA Installation  Philips HTL1100  Henny Penny 610ESC60XXXX User's Manual  LG LWS3081ST User's Manual  ASSIST - California State University, East Bay  Operating Instructions for advanced features  Step2 531700 Use and Care Manual  

Copyright © All rights reserved. Failed to retrieve file