Form plugin paypal

From Fabrik

Jump to: navigation, search

Image:Paypal.png

  • Paypal email account - The email address registered with Paypal that will accept the payment
  • Or use an element - Alternatively select an element that will contain the Paypal account email
  • Payment type - If set to be a subscription all following subscription options need to be selected
  • Currency codeThree letter code stating the currency that the transaction will be billed in e.g. USD, GBP
  • Cost - Enter a value of the transaction
  • Eval -Eval the cost field or not
  • Or select an element - Select an element that will contain the transaction value
  • Purchase item - The name of the product being purchased
  • Eval - Eval the item field or not
  • Or select an element - Select an element that will contain the name of the item being purchased
  • Return URL - Optional URL for PayPal to use for the 'Return to merchant site' button after payment is complete. You can use standard Fabrik {placeholders}. Paypal will also automatically append all of the
  • or Return Message - Rather than giving a Return URL, you may specify message text here, which will be displayed on the default 'thanks' page. As with the IPN Custom field, you can use {table___element} and [paypal_things] as placeholders. To see all the request data available to use as [paypal_things], insert the special placeholder [show_all] in this field, and the thanks page will show you all the request data.


Image:Paypal-subs.png


  • Subscription connection - Optional - The Fabrik connection that contains the subscription table. Subscription settings are only required if you select this connection and table.
  • Subscription switch - This is for sites where you can toggle between a subscription or a single payment. Should be some PHP code which returns true if you want the payment to be handled as a subscription. If left blank then the Payment type option will be used.
  • Subscription table - The Fabrik table that contains the subscription information
  • ID - The field that contains the subscription plan id. A record must exists where the ID field contains the same value as that of this plug-ins 'Purchase item' field
  • Name - The subscription plan's name, can use {placeholders}
  • Duration - The element that contains the duration of the subscription (must contain data that are integers)
  • Duration period - The element that contains the subscriptions duration period (must contain values such as D (for day) W (for week), M (for month), Y (for year)
  • Invoice Num - Optional - A placeholder, e.g. {myinvoice}. Put $_REQUEST['myinvoice'] = $whatever; in your IPN PHP file's createInvoice() method. If the placeholder is not found or left empty then a unique invoice id is generated
  • Recurring - Value should be 0 for non-recurring, 1 for recurring. Can use {placeholders}
  • Subscription switch - This is for sites where you can toggle between a subscription or a single payment. Should be some PHP code which returns true if you want the payment to be handled as a subscription. If left blank then the Payment type option will be used.

Image:Paypal-shipping.png


  • Shipping Table - OPTIONAL - Select the table from which the user shipping data will be grabbed. If selected, please complete the following fields.
  • User ID - Select the field recording the User-Id in the table selected above. The logged on Joomla user ID will be used to look up shipping data.
  • First Name
  • Last Name
  • Last Name
  • Address 1
  • Address 2
  • ZIP - Postcode
  • State - Required for some countries, like the US
  • City
  • Country - Must be a valid ISO 3166-1 two letter code. See http://bit.ly/ipvTk
  • Address override - Optional. May causes errors on Paypal side depending on your Paypal settings.

Image:Paypal-ipn.png

  • IPN Custom Element - Optional - Select the element whose data will be updated when the transation has finished
  • IPN Custom Value - Optional - if you have selected an IPN Custom Element, enter the value that should be stored upon successful IPN. DO NOT USE : IN THIS FIELD! Use standard Fabrik {placeholders} for substitution before sending to PayPal. Use [name] as placeholders for PayPal IPN notify values (like [receiver_email], etc), subsitution happens during IPN notify phase. If left blank (but a Custom Element has been selected), the txn_id will be stored here.
  • IPN Txn-Id Element - Optional (but STRONGLY advised!) - element which will store the PayPal transaction ID
  • IPN Payment Element - Optional (but STRONGLY advised!) - element which stores the paymount_amount from the PayPal transaction
  • IPN Status Element - Optional (but STRONGLY advised!) - element which will store the PayPal transaction status
  • IPN Address Element - Optional (but STRONGLY advised!) - element which will store the PayPal buyer address and its status (confirmed or unconfirmed)
  • IPN PHP File - Select a PHP file to execute during the Paypal IPN phase. See scripts/paypal_ipn_example.php for details.
  • Condition - Optional PHP code. If code returns false, Paypal transaction will not be run.
  • Test mode - If set to yes then the plug-in will post to the paypal sand box. Use this for testing
  • Sandbox account email - Your Paypal sandbox seller email address. Only used when test mode is on.
  • Receive debug emails - Receive the debug emails (sent for each IPN update)
  • Send default emails - Send the default emails to buyer (sent for each IPN update)
  • Test Site - OPTIONAL - you may provide a site address for the test PayPal IPN notify, which the script will use instead of your standard Joomla live site (if you have selected Test Mode above). This is useful if you are testing on a private host, with no external DNS entry.
  • Test QS - OPTIONAL - you may provide any &foo=bar query string args for testing, which the script will add to the IPN notify URL (if you have selected Test Mode above). This is useful for triggering remote xdebug, with whatever directive your PHP development environment uses (like &XDEBUG_SESSION_START=name)
  • Custom Return to Merchant Text - This will replace PayPal's standard (and rather unhelpful) 'Return to Merchant' text after payment by card
Personal tools