Download the PHP package jlkaufman/cakephp-paypal-rest-client without Composer

CakePHP Paypal REST Client (PaypalSource)

Introduction

This plugin is a full REST client for Paypal's API. It implements all of the functions available through the Paypal REST API.

Instead of using CURL, CakePHP's HTTPSocket class is used.

Disclaimer

Alpha Version... Probably a good idea not to use this in production yet...

Documentation: Table of Contents

1. Installation
2. Configuration
3. Usage
   • Including the Paypal Model in your controller
   • Notes about response returned
   • Credit Card Payment
   • Capture an Authorization
   • Void an Authorization
   • Refund a sale

Installation

1) Clone the repository into the app/Plugins/PaypalSource directory

2) Install with composer

Configuration

In database.php add the following block and fill it out accordingly:

Usage

Including the Paypal Model in your controller

• Add PaypalSource.Paypal to your $uses array.
  E.g.: public $uses = array('PaypalSource.Paypal');

  You can now call the model with $this->Paypal->method(); from your controller.

Notes about response returned

All the methods in the Paypal class will return an instance of StdClass. In the documentation we show the object in JSON form, simply for readability. You can access each member of the object using arrow notation.

Credit Card Payment

Credit card payments are easy to create. We can do one of two things; we can create a sale (a final payment), or we can authorize an amount that we will capture later.

• $data will contain all the information we're going to send to Paypal

Credit Card:

Credit Card Token:

• $type can either be authorization or sale
sale: A final sale, and will complete the transaction
  authorization: Authorize the card for the amount specified. We will have to capture the payment later.

Example response

Capture an Authorization

To capture an authorization one must create the Authorization (Credit Card Payment with $type set to authorization) and get the Authorization ID from the response.

Here's an example of capturing an authorization:

• authorization_id is stored in the response object returned by Paypal::creditCardPayment() in $response->transaction->authorization->id

Example Capture Response

Void an Authorization

There are all sorts of reasons one would void an authorization (client canceled the transaction, some other reason that would mean you shoudln't be charging them, whatever).

To void an authorization one must create the Authorization (Credit Card Payment with $type set to authorization) and get the Authorization ID from the response.

Here's an example of voiding an authorization:

• authorization_id is stored in the response object returned by Paypal::creditCardPayment() in $response->transaction->authorization->id

Example Response

Refund a sale

Sometimes it's necessary to refund a transaction. To refund a sale one must first create the Sale (Credit Card Payment with $type set to sale) and get the Sale ID from the response.

• payment_id is stored in the response object returned by Paypal::creditCardPayment() in $response->transaction->sale->id

Example Response