Menu

User Tools

Create PDF

Site Tools


Differences

This shows you the differences between two versions of the page.

Go

Link to this comparison view

payment_methods:paypal:start [2017-09-20 13:24]
lkn [Recurring payments]
payment_methods:paypal:start [2019-10-04 09:26] (current)
Line 102: Line 102:
 | paypalPayerFirstName  | Success         | Alphanumeric with a variable length of up to 64. | First name of consumer as returned by PayPal. | | paypalPayerFirstName  | Success         | Alphanumeric with a variable length of up to 64. | First name of consumer as returned by PayPal. |
 | paypalPayerID | Success | Alphanumeric with a variable length of up to 13. | ID of consumer as returned by PayPal. | | paypalPayerID | Success | Alphanumeric with a variable length of up to 13. | ID of consumer as returned by PayPal. |
-| paypalPayerLastName | Success | Alphanumeric with a variable length of up to 64. | Last name of consumer as returned by PayPal |+| paypalPayerLastName | Success | Alphanumeric with a variable length of up to 64. | Last name of consumer as returned by PayPal|
  
  
- 
-===== Parameter mapping ===== 
-The tables below show the **parameter mapping between Wirecard** request and response parameters **and** the respective **PayPal** interface parameters. 
- 
-==== Request parameter mapping ==== 
- 
-(m): Payment request number.\\ 
-(n): Basket item number. 
- 
-^ Wirecard parameter ^ PayPal interface parameter ^ 
-| [[:request_parameters#amount|amount]]                                   | PAYMENTREQUEST_(m)_AMT          |  
-| [[:request_parameters#currency|currency]]                               | PAYMENTREQUEST_(m)_CURRENCYCODE | 
-| //Calculated by Wirecard.//                                             | PAYMENTREQUEST_(m)_ITEMAMT      | 
-| //Calculated by Wirecard.//                                             | PAYMENTREQUEST_(m)_TAXAMT       | 
-| [[:request_parameters#shopping_basket_data|basketItem(n)ArticleNumber]] | L_PAYMENTREQUEST_(m)_NUMBER(n)  | 
-| [[:request_parameters#shopping_basket_data|basketItem(n)Description]]   | L_PAYMENTREQUEST_(m)_DESC(n)    |  
-| [[:request_parameters#shopping_basket_data|basketItem(n)Name]]          | L_PAYMENTREQUEST_(m)_NAME(n)    |  
-| [[:request_parameters#shopping_basket_data|basketItem(n)Quantity]]      | L_PAYMENTREQUEST_(m)_QTY(n)     | 
-| [[:request_parameters#shopping_basket_data|basketItem(n)UnitNetAmount]] | L_PAYMENTREQUEST_(m)_AMT(n)     |  
-| [[:request_parameters#shopping_basket_data|basketItem(n)UnitTaxAmount]] | L_PAYMENTREQUEST_(m)_TAXAMT(n)  |  
-| [[:request_parameters#consumer_shipping_data|consumerShippingAddress1]] | SHIPTOSTREET                    | 
-| [[:request_parameters#consumer_shipping_data|consumerShippingAddress2]] | SHIPTOSTREET2                   | 
-| [[:request_parameters#consumer_shipping_data|consumerShippingCity]]     | SHIPTOCITY                      | 
-| [[:request_parameters#consumer_shipping_data|consumerShippingCountry]]  | SHIPTOCOUNTRYCODE               | 
-| [[:request_parameters#consumer_shipping_data|consumerShippingFirstName]] | SHIPTONAME                     | 
-| [[:request_parameters#consumer_shipping_data|consumerShippingLastName]] | SHIPTONAME                      | 
-| [[:request_parameters#consumer_shipping_data|consumerShippingPhone]]    | PHONENUM                        | 
-| [[:request_parameters#consumer_shipping_data|consumerShippingState]]    | SHIPTOSTATE                     | 
-| [[:request_parameters#consumer_shipping_data|consumerShippingZipCode]]  | SHIPTOZIP                       | 
-| [[:request_parameters#customerStatement]]                               | DESC                            | 
-| [[:request_parameters#orderReference]]                                  | INVNUM                          | 
-| [[:request_parameters#transactionIdentifier]]                | L_BILLINGTYPE(m), MerchantInitiatedBilling | 
- 
- 
-^ LEGACY ^  [[:request_parameters#shopping_basket_data|Shopping basket data]]     ^^ 
-^ :::    ^ Wirecard parameter                                                      ^ PayPal interface parameter ^ 
-^ :::    | [[:request_parameters#shopping_basket_data|basketAmount]]               | ITEMAMT   | 
-^ :::    | [[:request_parameters#shopping_basket_data|basketCurrency]]             | Not needed for PayPal. | 
-^ :::    | [[:request_parameters#shopping_basket_data|basketItems]]                | Not needed explicitly within PayPal interface. | 
-^ :::    | [[:request_parameters#shopping_basket_data|basketItem(n)ArticleNumber]] | L_NUMBERn | 
-^ :::    | [[:request_parameters#shopping_basket_data|basketItem(n)Description]]   | L_DESCn   |  
-^ :::    | [[:request_parameters#shopping_basket_data|basketItem(n)Quantity]]      | L_QTYn    | 
-^ :::    | [[:request_parameters#shopping_basket_data|basketItem(n)Tax]]           | L_TAXAMTn |  
-^ :::    | [[:request_parameters#shopping_basket_data|basketItem(n)UnitPrice]]     | L_AMTn    | 
-^ :::    | //Calculated by Wirecard.//                                             | TAXAMT    | 
- 
-==== Response parameter mapping ==== 
- 
-^ Wirecard parameter ^ PayPal interface parameter ^ 
-| [[:response_parameters#Response_parameters_which_will_be_returned_for_successful_payments|gatewayReferenceNumber]] | TRANSACTIONID | 
-| paypalBillingAgreementID      | BILLINGAGREEMENTID |  
-| paypalPayerAddressCity        | SHIPTOCITY         |  
-| paypalPayerAddressCountry     | SHIPTOCOUNTRY      |  
-| paypalPayerAddressCountryCode | SHIPTOCOUNTRYCODE  |  
-| paypalPayerAddressName        | SHIPTONAME         |  
-| paypalPayerAddressState       | SHIPTOSTATE        |  
-| paypalPayerAddressStreet1     | SHIPTOSTREET       |  
-| paypalPayerAddressStreet2     | SHIPTOSTREET2      |  
-| paypalPayerAddressZIP         | SHIPTOZIP          |  
-| paypalPayerEmail              | EMAIL              |  
-| paypalPayerFirstName          | FIRSTNAME          |  
-| paypalPayerID                 | PAYERID            | 
-| paypalPayerLastName           | LASTNAME           | 
 ===== Back-end operations ===== ===== Back-end operations =====
 Please refer to [[back-end_operations:transaction-based:table|transaction-based operations by payment method]] and [[back-end_operations:non-transaction-based:table|non-transaction-based operations by payment method]] for further information and details on back-end operations in [[wcp:start|Wirecard Checkout Page]] and [[wcs:start|Wirecard Checkout Seamless]]. Please refer to [[back-end_operations:transaction-based:table|transaction-based operations by payment method]] and [[back-end_operations:non-transaction-based:table|non-transaction-based operations by payment method]] for further information and details on back-end operations in [[wcp:start|Wirecard Checkout Page]] and [[wcs:start|Wirecard Checkout Seamless]].
Line 175: Line 112:
 To carry out recurring payments the parameter [[:request_parameters#transactionIdentifier]] is used. For more information visit [[back-end_operations:transaction-based:recurpayment|recurPayment]].  To carry out recurring payments the parameter [[:request_parameters#transactionIdentifier]] is used. For more information visit [[back-end_operations:transaction-based:recurpayment|recurPayment]]. 
  
-=== Additional required request parameter ===+=== Additional required request parameters === 
 + 
 +This otherwise optional request parameter ''consumerDeviceId'' is required by PayPal for so-called "on-demand payments" initiated by the consumer in the online shop.
  
-The required request parameter ''consumerDeviceId'' is a security parameter used in terms of a Device Fingerprinting (DFP) which is a method of fraud protection and allows to identify technical devices used by the consumer.+Recurring payments initiated by the merchant, without interaction of consumer, used for handling subscription-based transactions do not need this parameter.
  
 ^  Security parameter  ^^^ ^  Security parameter  ^^^
 ^ Parameter  ^ Data type  ^ Short description  ^ ^ Parameter  ^ Data type  ^ Short description  ^
-| consumerDeviceId  | Alphanumeric with special characters and a variable length of up to 255 characters. | Unique token which serves as a method of fraud protection. |+| consumerDeviceId  | Alphanumeric with special characters and a variable length of up to 32 characters. | Unique token which serves as a method of fraud protection. |
  
 Please note that the parameter ''consumerDeviceId'' is NOT part of the fingerprint. Please note that the parameter ''consumerDeviceId'' is NOT part of the fingerprint.
  
-For any further information on the parameter ''consumerDeviceId'' have a look at the descriptions in [[:payment_methods:invoice:ratepay?&amp;#required_request_parameters|Device fingerprinting]].+<note>We recommend merchants to contact PayPal on integration to obtain more information on this parameter in tems of the specific business case.&lt;/note>;
  
-=== Additional optional request parameter === 
  
 Additionally for payment method PayPal the [[:back-end_operations:transaction-based:recurpayment?&#additional_optional_request_parameters|basket parameters]] can be set and will be displayed when used in a recurring payment. Additionally for payment method PayPal the [[:back-end_operations:transaction-based:recurpayment?&#additional_optional_request_parameters|basket parameters]] can be set and will be displayed when used in a recurring payment.

This website uses cookies to deliver the best service to you. By continuing to browse the site, you are agreeing to our use of cookies.