PayPal

PayPal Integration with KontoCloud

Introduction

PayPal is a globally recognized payment platform that enables customers to make secure transactions using their PayPal accounts. Integrating PayPal with KontoCloud allows merchants to offer a trusted, convenient, and widely used payment method. This integration supports various transaction types, including authorizations, captures, refunds, and cancellations, providing flexibility for merchants to manage payments efficiently. By using KontoCloud’s APIs and SDKs, merchants can easily integrate PayPal into their checkout flows and enhance the customer experience.

Workflows and Transaction Types

Integration Flow for Merchants

To integrate PayPal as a payment option within KontoCloud, merchants follow these steps:

• Initiate Storing of New Payment Option: The merchant calls the API method Init Add Stored Payment Option to start the process of storing a new PayPal payment option. This generates an authorizationToken, a key identifier for the payment option.
• Collect Payment Option Details via SDK: Merchants use KontoCloud's Web SDK to render a customizable PayPal button on their website, facilitating the collection of payment details securely.
• Customer Login and Approval: Customers log in to PayPal, review the transaction or billing agreement, and authorize it.
• Finalize Storing of Payment Option: Once the customer approves the transaction or billing agreement, the payment option is securely stored for future use.

For detailed guidance, refer to the PayPal Payment Option Management Guide.

Authorization and Capture Process

After storing the payment option, merchants can process payments through two main steps:

• Authorization: The merchant initiates a request to authorize a specific amount on the customer’s PayPal account. Authorization ensures that funds are available but does not transfer them immediately.
• Capture: Once authorized, the merchant captures the funds, transferring the authorized amount to the merchant’s account. Captures can be immediate or delayed, depending on business needs.

The capture process includes sending an API capture request, processing the payment through PayPal, and receiving an API capture response with the status of the transaction. Detailed instructions are provided in the PayPal Capture Guide.

Refunds and Cancellations

Merchants can issue full or partial refunds through KontoCloud’s API. Additionally, authorized transactions can be canceled before capture, offering flexibility for managing customer requests or errors.

SDK Integration

To integrate PayPal using KontoCloud's Web SDK:

• Include the JavaScript Library: Add the KontoCloud JavaScript library to your website for SDK functionalities.
• Define a Container: Create a <div> element where the PayPal button will be rendered.
• Render the Button: Configure the SDK with necessary parameters such as authorizationToken, paymentOptionCodes, and paymentProviderMode, and render the PayPal button dynamically.

Detailed setup instructions are provided in the Web SDK Setup Guide.

PayPal Test Data

In order to test PayPal you need to create PayPal Sandbox Account following the PayPal Sandbox Testing Guide.