What we require

In order to process PayPal payments for you, we ask you to provide us with the following configuration data:

• Paypal merchant ID (not the email address of the PayPal account).

Please create or register this ID using the links provided in the online documentation. There are links for the PayPal Sandbox system as well as for Production. Depending on which account you want to register, please use the respective link in the documentation.

After you send the ID to our helpdesk address, you will receive the "client ID" as well as the "data-partner-attribution-id" for the production system from us in return, please set these accordingly in the PayPal SDK button link.

 

Chapter: Grant API permissions to Computop Paygate

Link Documentation: https://developer.computop.com/display/DE/PayPal+V2

 

Please send us the necessary information by e-mail to helpdesk@computop.com.
We will inform you once the setup has been completed.

 

Note: Goods must always be sent to the delivery address, which you will receive back from PayPal for each transaction. Otherwise there is no seller protection. You can get more detailed information about this directly from PayPal.

In connection with PayPal there are a number of options you can use. We list the most important ones below:

Capture on Demand

There are the following 2 possibilities to transfer the parameter capture for a delayed booking (e.g. to charge the customer only at the time of delivery). If the payments are to be captured immediately, please transfer the parameter capture=auto.

1. Process Order (Parameter capture=manual + txtype=order)
   The payment is saved as an order without creating an authorization (Without PayPal creditworthiness check, therefore, a later authorization is not guaranteed!). In this case the customer’s PayPal account is "frozen,” therefore it cannot be closed by the customer. By capturing the payment, an authorization as well as capture is automatically created.
   Please keep in mind that orders are valid for 29 days.
    
   Note: Usually, it is not possible to process multiple captures for this option. If you want to execute multiple captures using txtype=order, please contact us at helpdesk@computop.com.
   
   
2. Process Authorization (Parameter capture=manual + txtype=auth)
   The payment is automatically authorized. The capture should be done within 3 days. Capture attempts after the time period also underlie the PayPal seller protection, but are more likely to fail due to PayPal risk management.
   

Settlement Files

PayPal offers a number of settlement files that contain different data sets. Computop can pick up the following PayPal files regarding settlement for you (Example files can be found at the end of the article):

• DR    = Dispute Report – Customer complaint file with the current status
• STL    = Settlement file including settled payments (incl. CT PayID as well as RefNr)
• TRR    = Settlement File including settled as well as outstanding payments

Computop picks up PayPal settlement files on a daily basis at 12:00 p.m. CET. They are provided to you at approx. 01:00 p.m. CET.
 
Note: In order for us to pick up the settlement files for you, we need the PayPal SFTP account data. Please contact your PayPal Account Manager to activate this feature. The account will then offer to create a secured SFTP server in the section account information. After you have successfully created the SFTP server, please send us the access data (user name and password). We will then complete the setup process for you. Please find the attached guide to create the SFTP account.

For additional information regarding PayPal and SFTP accounts, please refer to the attached pdf below. If you have any further questions, please contact helpdesk@computop.com

 

PayPal Shortcut

If you wish to redirect a customer back to the shop (to finish the order) after completing the PayPal payment, please note following procedure.

• PayPal Shortcut
  
  1. Request:
  Shop >> Paygate (PayPal.aspx incl. parameter PayPalMethod=shortcut) >> PayPal
  
      1a. Response:
      PayPal >> Paygate >> URLNotify/URLSuccess/URLFailure
  
  2. Request: Dieser führt erst zur abschließenden Zahlungsbestätigung (ohne Endkunde)
  Shop >> Paygate (PayPalcomplete.aspx) >> PayPal
  
      2a. Response:
      PayPal >> Paygate >> Server-to-server response to the shop, which informs customer
      about payment status
   
  If the shop is not aware of the delivery address yet, the customer will choose a respective address within the PayPal account, which will then be returned in the payment response.
   
  If the shop is already aware of the address and it is included in the payment request to Paygate it will be prefilled within the PayPal account and cannot be changed by the customer.
   
  Note: Only PayPal´s shortcut allows you to change the amount after the customer has paid (within the second request). PayPal´s standard procedure bills the customer immediately after receipt of the first success response.
   
  A change of PayPal´s delivery address is not possible through the second request.
  
  
• PayPal – Standard (for comparison)
  
  1. Request:
  Shop >> Paygate (PayPal.aspx) >> PayPal
  
      1a. Response:
       PayPal >> Paygate >> URLNotify/URLSuccess/URLFailure
  
  The payment response (1a) is the final payment confirmation.
  

  If the shop is not aware of the delivery address yet, the customer will choose a respective address within the PayPal account, which will then be returned in the payment response.
  
  If the shop initially sends an address to Paygate|PayPal, it automatically becomes the delivery address and cannot be changed by the customer in the PayPal account.
  The unique response received here is already the corresponding payment confirmation.