The missing PayPal Digital Goods PHP library. Discontinued - PayPal no longer offer the Digital Good...
Important: PayPal Digital Goods is deprecated as of January 1, 2017. PayPal continues to support existing merchants using this method, but new features and enhancements will not be applied to these integrations. For new integrations, see the PayPal Checkout Integration Guide.
PayPal's Digital Goods for Express Checkout service is a great payment solution with a needlessly complicated API and an unfortunately verbose name.
This library makes it easier to write code using the PayPal Digital Goods API. It supports both one off purchases and recurring payments (subscriptions).
If you are not a programmer, or just want to save yourself the heartache of working with PayPal APIs, try setting up PayPal Digital Goods with WooCommerce - no code required.
Using a class to interact with the PayPal API provides all the advantages you love about Object-Oriented programming:
Like to learn by example?
Check out the PayPal Digital Goods PHP Examples repository.
Before creating a payment, you need to register a few settings with the
The minimum configuration settings required are your PayPal API Credentials, a return URI and cancel URI.
PayPal_Digital_Goods_Configuration::username( 'PAYPAL_API_USERNAME' ); PayPal_Digital_Goods_Configuration::password( 'PAYPAL_API_PASSWORD' ); PayPal_Digital_Goods_Configuration::signature( 'PAYPAL_API_SIGNATURE' );
PayPal_Digital_Goods_Configuration::return_url( 'http://example.com/return.php?paypal=paid' ); PayPal_Digital_Goods_Configuration::cancel_url( 'http://example.com/return.php?paypal=cancel' ); PayPal_Digital_Goods_Configuration::notify_url( 'http://example.com/return.php?paypal=notify' );
PayPal_Digital_Goods_Configuration::currency( 'USD' ); // 3 char character code, must be one of the values here: https://developer.paypal.com/docs/classic/api/currency_codes/ ?>
Once the PayPal library is configured, you can create a Purchase or Subscription object, or a few of each if you prefer.
PayPal_Purchaseclass is used to create digital goods purchases. The class's constructor takes a multi-dimensional array of named parameters to customise the purchase to your needs. The individual parameters are explained in detail in the constructor's comments.
Below is a quick example which creates a purchase of two different goods with a total transaction value of $12.00.
$purchase_details = array( 'name' => 'Digital Good Purchase Example', 'description' => 'Example Digital Good Purchase', 'amount' => '14.50', // Total including tax 'tax_amount' => '2.50', // Just the total tax amount 'items' => array( array( // First item 'item_name' => 'First item name', 'item_description' => 'This is a description of the first item in the cart, it costs $9.00', 'item_amount' => '9.00', 'item_tax' => '1.00', 'item_quantity' => 1, 'item_number' => 'XF100', ), array( // Second item 'item_name' => 'Second Item', 'item_description' => 'This is a description of the SECOND item in the cart, it costs $1.00 but there are 3 of them.', 'item_amount' => '1.00', 'item_tax' => '0.50', 'item_quantity' => 3, 'item_number' => 'XJ100', ), ) );
$paypal_purchase = new PayPal_Purchase( $purchase_details ); ?>
These are the purchase details used in the PayPal Digital Goods PHP Examples repository.
PayPal_Subscriptionclass is used to create recurring payments for digital goods. Much like the
PayPal_Subscriptionclass's constructor takes a multi-dimensional array of named parameters to customise the subscription to your needs. The individual parameters are explained in detail in the constructor's comments.
Below is a quick example which creates a $2/week subscription for 4 weeks with a $10.00 sign-up fee.
$subscription_details = array( 'description' => 'Example Subscription: $10 sign-up fee then $2/week for the next four weeks.', 'initial_amount' => '10.00', 'amount' => '2.00', 'period' => 'Week', 'frequency' => '1', 'total_cycles' => '4', );
$paypal_subscription = new PayPal_Subscription( $subscription_details ); ?>
Note, it is highly recommend you include the subscription amounts and details in the
'description'parameter as PayPal does not display the subscription details on the confirmation page.
Once you have created a purchase or subscription object, the rest is simple.
Add the following line to your checkout or payment page. It will add all necessary scripts and set-up the transaction with PayPal.
When a user returns from PayPal, processing their payment or starting their subscription is also a one line operation.
To process a payment once a user has authorized the purchase with PayPal, call the
process_payment()operation on your
To start a subscription after a user has authorized the recurring payment plan with PayPal, call the
start_subscription()operation on your
By default, the library uses the PayPal Sandbox. Switching from the Sandbox to the live PayPal site is easy, set the
environmentconfiguration setting to
Supported PayPal API Operations:
get_transaction_details( $transaction_id )
get_profile_details( $profile_id )
To use the library as a submodule in your application's main git repository, use the following command:
# Add the PayPal Library as a submodule git submodule add git://github.com/thenbrent/paypal-digital-goods.git paypal-digital-goods
When cloning your application's Git repo, be sure to specify the --recursive option to include the contents of the PayPal submodule.
# Clone my application and all submodules git clone --recursive git://github.com/username/app-name.git
PayPal has hidden some excellent articles within the x.commerce dev zone, including:
Patches are welcome
To submit a patch:
The class is written to be friendly to humans, so place special emphasis on readability of your code. It is more important than cleverness and brevity. Your syntax should conform to the WordPress Coding Standards. Provide a brief explanation of each functions purpose in header comments, and comment inline only to explain why your code works. Let your code explain how.
Programs must be written for people to read, and only incidentally for machines to execute. — Structure and Interpretation of Computer Programs
PayPal Digital Goods is deprecated as of January 1, 2017. PayPal continues to support existing merchants using this method, but new features and enhancements will not be applied to these integrations. For new integrations, see the PayPal Checkout Integration Guide.
Also, recurring payments are not available for German PayPal accounts.