Mastercard Payment Gateway API Reference: Operations -

Version 79,

Protocol: paypalsdk

configure()

Configuration method for initializing the SDK.

This method should be called only once for the page load. After calling this method, the SDK will provide configuration values as member variables.

If not provided, apiVersion is defaulted to 60.

Usage

GatewayPaypal.configure(config, errorCallback, completeCallback, cancelCallback)

Example

function errorCallback(error) {
};
function completeCallback(response) {
};
function cancelCallback(response) {
};
GatewayPaypal.configure({
        merchantId: "TESTMERCHANT",
        sessionId: "SESSION0002899787259G30902270H6",
        orderId: "1234567890",
        transactionId: "Trans12345",
        currency: "USD",
        paymentConfirmation: "CONFIRM_AT_PROVIDER",
        operation: "PAY",
        apiVersion: 60,
        buttonElement: "PayPalButton",
        style: {
            color:   'blue',
            shape:   'rect',
            label:   'paypal',
            tagline: 'true'
        }
        },
    errorCallback,
    completeCallback,
    cancelCallback
);

Arguments

GatewaypaypalConfig Object COMPULSORY

Configuration values

merchantId String COMPULSORY

The unique identifier issued to you by your payment provider.

sessionId String COMPULSORY

The identifier of the payment session.

orderId String COMPULSORY

A unique identifier for this order to distinguish it from any other order you create.

transactionId String COMPULSORY

Unique identifier for this transaction to distinguish it from any other transaction on the order.

currency String COMPULSORY

The currency of the order expressed as an ISO 4217 alpha code, e.g. USD.

paymentConfirmation String

Indicates where in the checkout flow you want the payer to commit to the payment.

Set this to CONFIRM_AT_PROVIDER if you want the payer to commit to the payment on the PayPal website.

Set this to CONFIRM_AT_MERCHANT if you want the payer to commit to the payment on your website.

operation String COMPULSORY

The type of transaction you want to create for this payment. You can choose between an Authorization and a Payment transaction.

For a successful Authorization transaction, you must submit a CAPTURE request to move the funds from the payer's account to your account.

AUTHORIZE - The transaction created in the gateway is an AUTHORIZATION transaction.

PAY - The transaction created in the gateway is a PAYMENT transaction.

apiVersion Number

The API version that you used when submitting the API CREATE_SESSION and UPDATE_SESSION requests.

You must use version 60 or above.

If not provided, the value is defaulted to 60.

buttonElement String COMPULSORY

Identifier of the DOM element where the button will be rendered.

style Object Optional

Style options for customizing the PayPal Smart Button.

Attributes

color String OPTIONAL

Color options for the PayPal Smart Button. One of "gold" (Recommended by PayPal), "blue", "silver", "white", "black".

If not provided, the value is defaulted to "gold".

shape String COMPULSORY

Shape options for the PayPal Smart Button. One of "rect" (Default), "pill".

If not provided, the value is defaulted to "rect".

size Number COMPULSORY

Size of the PayPal Smart Button. If not provided, the value is defaulted to the size of its container element.

To customize the button width, alter the width of the container element.

To customize the button height, set the height option to a value from 25 to 55.

label String COMPULSORY

Label options for the button. One of "paypal" (Default), "checkout", "buynow", "pay".

If not provided, the value is defaulted to "paypal".

tagline String COMPULSORY

Option to display tagline. One of "true" (Default), "false".

If not provided, the value is defaulted to "true".

errorCallback Object COMPULSORY

error Object OPTIONAL

message String OPTIONAL

Error message received from either Gateway or PayPal.

response Object OPTIONAL

Error response received from either Gateway or PayPal.

completeCallback Object COMPULSORY

response Object OPTIONAL

Response after successful completion of the payment. The response will be same as that of CONFIRM_BROWSER_PAYMENT or UPDATE_BROWSER_PAYMENT operation.

cancelCallback Object COMPULSORY

response Object OPTIONAL

Response after cancellation of the payment.

Return Value

None