meteor-paypal-rest-api

Meteor package for PayPal REST API.

• Basic payments
• Credit card payments
• Adapted forms & templates

Usage

meteor add smaltcreation:paypal-rest-api

Configuration

If you haven't already, sign up for a developer account at: https://developer.paypal.com/ and create a sandbox application.

In your project, create a file server/lib/paypal.js with your application configuration including:

Smalt.PayPal.configure({
  host: 'api.sandbox.paypal.com',
  client_id: 'YOUR_CLIENT_ID',
  client_secret: 'YOUR_SECRET_KEY'
});

Create a payment

With a credit card

Proceed a payment with a credit card is a two steps work:

Client side

First, you should display the form template like this:

{{> smaltPayPalCreditCardForm totalAmount=42 currency="€" tax="TTC"}}

You can provide several parameters for the template. Those three are required.

• totalAmount show the total price of your transaction
• currency €, $, £, wathever you want to display
• tax indicate if it's tax free or not
• id the #id of your form. Usefull if you have several form in the same page
• noButton true if you don't want to display the submit button

Then, you need to look for the event which validate the form like a click on a button or when the form is submited:

Template.smaltPayPalCreditCardForm.events({
    'submit form': function (event) {
      Meteor.call('youServerSideMethod', PaymentForm.getCreditCard(), function (error, result) {
        // Do wathever you want to do client side
        // like open a sweet alert with the result or the error
      });
    }
});

All transactions must be validated server side with your methods ! That's why: Meteor.call('youServerSideMethod'...

Note that PaymentForm.getCreditCard() returns an object with card's informations exported from our form.

Server side

Create a server/methods/paypal.js file when you are going to place all you logic.

It's a good practice to follow those steps:

• Validations: check if all your informations other than the credit card are good, like if the user is log in
• Set up the amount: if you need to do operation like apply taxes...
• Call the package and create the payment with the card and amount objects
• Transmit errors or the result client side if you need to

youServerSideMethod: function (card) {
  /**
   * Before calling the package, you need to make sure that your inputs are well submitted.
   * Remember : never trust user input.
   * That's why validations.
   */
  if (!Meteor.userId()) {
      throw new Meteor.Error('not-authorized');
  }

  // Then, set up the amount with your values.
  var transactions = [];
  transactions.push({
      amount: {
          total: 42,
          currency: EUR
      }
  });

  // Call the package to create the Payment
  try {
      var payment = Smalt.PayPal.createCardPayment(card, transactions);

      // Error are catched, so
      // YOUR PAYMENT SUCCEED
      // Do whatever you want like loging the payment
      // You can also return it to the client
      
      return payment;
  } catch (e) {
      console.log(e);
      throw new Meteor.Error('paypal');
  }
}

var transactions = [] is an array of amount objects who require a total and a currency

The package is gonna implement a function who automaticly treats those objects with user data.*

And that's all you need to do for a complete credit card payment.