PayPal

paypal Allows you to securely process payments via PayPal. This component only renders the button and hands the secure transaction via the PayPal API. You will have to add summary information around this component so the user knows what they are paying for.

This element in an implementation of vue-paypal-checkout

When clicked, the payment workflow is initiated.

KeyValue(s)TypeDescription

type

paypal

string

model

object

data model key name that will contain results of payment transactions

amountKey

string

model key that holds the amount.

onEvent_actions

[]

array

If supplied, these actions will run when there is a paypal event. The default onUtilityHook will not execute.

currency

string

model key that holds the amount

invoiceNumber

'USD'

string

currency for the payment

dev

false

boolean

if true, use sandbox credentials

itemsKey

'myItems'

array

optional - model key that holds an array of items

credentials

{}

object

credential object,

style

{}

object

PayPal defined styling of the button

Reference

// sample credential object
credentials: {
    sandbox: '<sandbox client id>',
    production: '<production client id>'
}

Specifying Items

Optionally, according to the PayPal Payments API documents, you can list out any items along with your transaction.

For more information, PayPal Item List

// Sample Items Object
myItems: [
    {
      "name": "hat",
      "description": "Brown hat.",
      "quantity": "1",
      "price": "5",
      "currency": "USD"
      },
      {
      "name": "handbag",
      "description": "Black handbag.",
      "quantity": "1",
      "price": "5",
      "currency": "USD"
      }
  ]

Button Style

You can change the style of the button via a style object like so:

{
    label: 'checkout',
    size:  'responsive',    // small | medium | large | responsive
    shape: 'pill',         // pill | rect
    color: 'gold'         // gold | blue | silver | black
}

Complete Example Object

{
  "label": "Paypal",
  "model": "files",
  "styleClasses": "col-md-8",
  "type": "paypal",
  "currency": "CAD",
  "locale": "ca",
  "dev": true,
  "amount": "1.00",
  "credentials": {
    "sandbox": "AfGtki3XCbYBRxGWWY6YQlqRio82v5Jp6oPC7FJ9_0BLOlT3Z5KXLgPVmVGoCtZQTDuaYhrCM7ez3P9g",
    "production": "AcWg3pjwEtxVCX_UNrmb8GDvh3ntnP7zeDbIfVKRvDVWHr2UkkYUM9ze0r4-H4HkhzGtBEXE21iFsmg2"
  },
  "style": {
    "label": "checkout",
    "size": "responsive",
    "shape": "pill",
    "color": "gold"
  }
}

Last updated