DriveWorks Pro 16: PayPal Create Express Checkout Payment [send feedback...]

eCommerce PowerPack: PayPal Create Express Checkout Payment

This Task is the first stage of creating and executing a PayPal payment using the eCommerce PowerPack. This Task is used to send the required Data to PayPal for it to then correctly populate its checkout. If all the correct information is sent and received the Task will report back into a Constant with the Payment ID for the transaction and a URL link for the PayPal checkout page.

Properties

Property NameDescription
TitleChanges the Title (not the name) of the Task.
Return ConstantThe name of the Constant the payment information will be posted to.
Item ArrayA DriveWorks table of items to be purchased. Please see how to structure this Array below.
CurrencyThe currency to use. See below for the full list.
Note To BuyerThis is an optional note to the recipient of the goods in this transaction.
Transaction DescriptionThis is an optional description of what is being paid for. This appears under memo for the merchant.
Invoice NumberThe invoice number that is used to track this payment. Maximum is 127 characters. This must be unique.
Return URLThe URL the payer will be directed to upon successful completion of payment.
Cancel URLThe URL the payer will be directed to if the payment is canceled.
Shipping CostAny Shipping costs are defined here.
Tax CostAny Tax costs are defined here.
Handling FeeAny Handling fees are defined here.
Shipping DiscountAny Shipping Discounts are defined here. This is a numerical value.
Insurance CostAny Insurance costs are defined here
Gift Wrap CostAny Gift Wrap costs are defined here.

Item Array

PayPal requires the Item Array to be formatted in a certain way to interact with there API. The Item Array should be set out like the example below:

DescriptionNamePriceQuantitySKU
Medium Rock Crusher manufactured by Kear-Stuart Ltd.KS-300 Series Rock Crusher Red3200.001KS34M19R

Item Array Properties

Item Array HeaderDescription
DescriptionDescription of the item. This is a text value.
NameItem Name with a maximum of 127 characters. This is a text value.
Price

Item cost. This is formatted as a number to two decimal places (0.00).

Please note that for each item within the array the price is for only one unit. The total cost will be calculated by multiplying the price by the quantity.

QuantityThe quantity of the item. This is a numerical value.
SKUStock Keeping Unit. This is your SKU for the product. This is a text value.

Currency

We currently support these currency codes:

Currencies
  • AUD
  • BRL
  • CAD
  • CZK
  • DKK
  • EUR
  • HKD
  • HUF
  • ILS
  • JPY
  • MYR
  • MXN
  • NOK
  • NZD
  • PHP
  • PLN
  • GBP
  • DUB
  • SGD
  • SEK
  • CHF
  • TWD
  • THB
  • USD

Example

When this Task is added the properties are static. To be able to build rules on a static properties see How To: Change A Static Property To A Dynamic Property.

Property NameExample RuleExample ResultMeaning
Return Constant"DWConstantCreateReport"{"PaymentID","Approval link";"PAY-73S74723HO108541VLL9VSWQ",
"https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_express-checkout&token=EC-11535950SF892203H"}
This is the name of the Constant that the Task will report to. The Task reports as an Array containing Payment ID and an Approval Link.
Item ArrayDwLookupOrderDWLookupOrderThis is a look up of a Simple Table that is storing the created order
Currency"USD"USDThis will use the Dollar as the currency for the transaction.
Note to Buyer"Thank you for your order"Thank you for your orderThis is a note to the buyer that will appear on the check out.
Transaction DescriptionDWVariableTransactionDescriptionDWVariableTransactionDescriptionThis Variable contains the text that appears as a memo within your PayPal merchant store for each payment. The customer does not see this.
Invoice NumberDate()&DWSpecificationId432319999This will use the current date with the SpecificationId to create a unique Invoice Number.
Return URL"http://MyDomainName/Integration?Specification=
"&UrlEncode(DWSpecification)&"&Transition=Edit"
"http://MyDomainName/Integration?Specification=
"&UrlEncode(DWSpecification)&"&Transition=Edit"
This is the URL that the customer will be directed to when they have completed the check out process. This example is showing using the Integration Module to reenter the Specification on the Edit Transition. The Integration Module combined with a Decision in the Form Navigation allows you to create a pre and post paid forms for the customer to be directed to depending on which part of the transaction they are in.
Cancel URL"http://www.driveworks.co.uk/""http://www.driveworks.co.uk/"This is the URL that the customer will be directed to if the payment process fails. This example would send them to the DriveWorks Website.
Shipping Cost"2.00"2.00This is the amount to charge for Shipping Cost.
Tax CostDWVariableTaxCost1.20This is the Variable containing the amount of Tax the customer needs to pay.
Handling Fee"0.90"0.90This is the amount to charge for the Handling fee.
Shipping Discount"0.00"0.00This is the amount discounted from the Shipping Cost.
Insurance CostDWVariableInsuranceCost3.50This is the Variable that contains the amount to charge for the Insurance cost.
Gift Wrap Cost"5.00"5.00This is the amount charged for Gift Wrapping services.

Please check your PayPal merchant FAQs relating to fees and take this into consideration when creating your costings.

Table of Contents