Add Shipping Details to Deposits

Sending the shipping details to some payment providers enables the use of additional services (like Paypal's Guaranteed Payment). The merchant has to collect the shipping information from the user and pass it in

  • getRedirectDataRequest.additionalDetails (in case of Redirect Integration, see getRedirectData) or
  • initiatePaymentRequest.shippingDetails (in case of Backend2Backend Integration, see initiatePayment)

collection respectively.

Redirect Integration

Example of valid shipping details for a PayPalDeposit:

<additionalDetails>
  <detail xsi:type="keyStringValuePair">
    <key>shippingName</key>
    <value>Max Mustermann</value>
  </detail>
  <detail xsi:type="keyStringValuePair">
    <key>shippingStreet</key>
    <value>Marxergasse 1B</value>
  </detail>
  <detail xsi:type="keyStringValuePair">
    <key>shippingCity</key>
    <value>Wien</value>
  </detail>
  <detail xsi:type="keyStringValuePair">
    <key>shippingPostalCode</key>
    <value>1030</value>
  </detail>
  <detail xsi:type="keyStringValuePair">
    <key>shippingCountryCode2</key>
    <value>AT</value>
  </detail>
  <detail xsi:type="keyStringValuePair">
		<key>shippingTelephoneNumber</key>
		<value>00436667788999</value>
  </detail>
  <detail xsi:type="keyStringValuePair">
		<key>shippingMethod</key>
		<value>Express</value>
  </detail>  
  <detail xsi:type="keyStringValuePair">
		<key>shippingTotal</key>
		<value>10.00</value>
  </detail>    
</additionalDetails>

Backend2Backend Integration

Example of valid shipping details for a PayPalDeposit:

<shippingDetails>
  <name>John Doe</name>
  <address>
			<street>Marxergasse</street>
			<houseNumber>1b</houseNumber>
			<postalCode>1030</postalCode>
			<city>Vienna</city>
			<countryCode2>AT</countryCode2>
			<telephoneNumber>00437778889999</telephoneNumber>    
  </address>
  <method>Express</method>
</shippingDetails>