Download the PHP package solution25/bluesnap without Composer

On this page you can find all versions of the php package solution25/bluesnap. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package bluesnap

426098293-01d94c75-9354-489e-b1d6-9c3502d4a427

Bluesnap Payment

Introduction

The Bluesnap Shopware 6 Plugin is a reliable payment solution that connects Bluesnap’s gateway with your Shopware store. It supports a variety of payment methods such as credit cards, Apple Pay, Google Pay, hosted checkout, and pay-by-link. Merchants can manage full or partial refunds, enable 3D Secure for added safety, and offer customers the option to save, update, or delete their card details. With a clear setup process and secure transactions, the plugin helps businesses offer a smooth and flexible payment experience.

Key Features

Compatibility

Get Started

Installation & Activation

  1. Download
  1. Install the Plugin in Shopware 6
  1. Activate the Plugin
  1. Verify Installation

Plugin Configuration

  1. Access Plugin Settings
  1. General Settings
    Before using the plugin, configure the API keys and payment settings:
    • API Key for Live: Required for live transactions.
    • API Public Key Live: Public key for authentication in the live environment.
      426098746-42aed29b-9907-4943-ad3e-041509de8b2c
  1. Save Configuration

Features & Usage

1. Credit Card Capture

This feature allows customers to complete transactions via Bluesnap’s PCI-compliant payment gateway using their credit card.

How It Works:
Customers enter their credit card details in a secure form.
The payment is processed via Bluesnap’s gateway.

Steps:

  1. Select "Bluesnap Credit Card" as the payment method.
  2. Enter the customer’s credit card details into the Bluesnap form.
  3. Submit payment. 426099916-a14f0c80-bdfe-4643-b02b-fa6d962176a3

2. Hosted Checkout

Bluesnap’s Hosted Checkout provides a secure checkout page hosted by Bluesnap, removing the need for merchants to handle sensitive payment information directly.

How It Works:
Customers are redirected to a secure hosted checkout page.
Payments are securely processed through Bluesnap.

Steps:

  1. Select "Bluesnap Hosted Checkout" as the payment method.
  2. The customer is redirected to the hosted checkout page.
  3. The customer completes the transaction on the hosted page. BlueSnap Payment SC5

3. Apple Pay Integration

Bluesnap supports Apple Pay, enabling customers to pay using their Apple devices with a single tap.

How It Works:
Customers use their Apple device to authenticate the transaction via Face ID, Touch ID, or Apple Watch.

Steps:

  1. Select "Apple Pay" as the payment method.
  2. Confirm payment through Face ID, Touch ID, or an Apple Watch. 426100163-e1fa5fd4-d397-407f-a0a2-3c1a0d55d890

4. Google Pay Integration

Customers can use Google Pay to complete transactions securely and quickly.

How It Works:
Customers authenticate the payment using their Google Pay account.

Steps:

  1. Select "Google Pay" as the payment method.
  2. Authenticate the payment via the customer’s Google Pay account. 426100221-04de736b-cb0f-4241-a7f1-c822ef3f29c5

5. Refunds (Full & Partial)

The Bluesnap plugin supports both full and partial refunds for transactions.

How It Works:

Steps for Full Refund:

  1. Navigate to the Orders section.
  2. Select the order to be refunded.
  3. Click "Create Refund."
  4. Change the status to "In Progress." 426100313-dea74cff-6d10-44b0-aa27-c2e1945f1515 426100367-4a5684b4-edba-4c69-88e3-e6a0891ee864 426100476-8b664858-a523-4e7e-8d7a-f04179868d9a 426100516-cbc954e6-1e28-4294-8d7a-b63d4f412a0e

Steps for Partial Refund:

  1. Navigate to the Orders section.
  2. Select the order to be partially refunded.
  3. Specify the refund amount.
  4. Click "Create Refund."
  5. Change the status to "In Progress." 426101045-e4f5af35-8a30-48c9-a960-adae028e3817 426101118-acd8ca06-76f6-420e-ae36-92c0da240a48

6. Save Card Feature

This feature allows customers to securely save their card details for future transactions.

How It Works:
A Vaulted ID is created to store the customer’s payment details securely.
Customers can select saved cards for future transactions.

Steps:

  1. During checkout, select "Save my card for future use."
  2. The card is securely stored and available for future use.

7. Update Card Feature

Allows customers to update their saved card details securely for future transactions.

How It Works:
Customers can modify their saved card information directly within the payment gateway.

Steps:

  1. Navigate to checkout.
  2. Update the saved card details.
  3. Save the updated card information.

8. Delete Card Feature

This feature allows customers to delete their stored card details when they no longer wish to use them.

How It Works:
Customers can remove their stored card information from the system.

Steps:

  1. Navigate to checkout.
  2. Select the card to be deleted.
  3. Click "Delete" to remove the card from the system.

9. 3D Secure Authentication

Enabling 3D Secure adds an extra layer of authentication to credit card transactions, reducing fraud.

How It Works:
After the customer enters their credit card details, they will be redirected to their bank’s authentication page to complete the transaction.

Steps:

  1. Enable 3D Secure in the plugin configuration.
  2. Customers will automatically be prompted for 3D Secure authentication during checkout.

10. Payment Surcharge

Merchants can add a configurable surcharge to credit card payments. The surcharge is calculated dynamically through Bluesnap and shown to the customer for confirmation before the order is placed.

How It Works: Once enabled, entering credit card details on the checkout confirmation page shows a "Calculate surcharge and proceed to payment" button instead of submitting immediately. Calculating the surcharge shows the customer the additional amount, which is added to the order as a separate line item. This works both for a newly entered card and for a customer's saved/vaulted card, including when switching cards mid-checkout.

Steps:

  1. Enable Surcharge in the plugin configuration.
  2. During checkout, the customer enters their credit card details (or uses a saved card).
  3. The customer clicks "Calculate surcharge and proceed to payment" to see the surcharge amount.
  4. The customer confirms and completes the order with the surcharge included.

BlueSnap Plugin - API Documentation

This document provides detailed information about the API endpoints available in the BlueSnap Plugin for Shopware 6. These endpoints allow secure integration with BlueSnap’s payment services, enabling the generation of payment tokens and facilitating hosted payment field rendering within your Shopware storefront.


Generate Payment Field Token

Endpoint:
POST /services/2/payment-fields-tokens

Description:
This endpoint is used to generate a payment field token, which is required to securely render BlueSnap's hosted payment fields on the frontend.

Request Headers:

Successful Response:

Example Error Response:


Capture Transaction

Endpoint:
POST /services/2/transactions/

Description:
This endpoint is used to capture a payment (authorize and capture funds) for a transaction using BlueSnap. It is typically called after the tokenization of payment data via BlueSnap's hosted fields.

Request Headers:

Example Request Body:

Successful Response:

Example Error Response:


Apple Pay Wallet

Endpoint:
POST /services/2/wallets/

Description:
This endpoint is used to create or update an Apple Wallet entry associated with a customer. It typically requires authorization and a JSON payload describing the wallet data. The request sends payment or pass-related information to BlueSnap's Apple Wallet service.

Request Headers:

Example Request Body:

Successful Response:

Example Error Response:


Retrieve Vaulted Shopper

Endpoint:
GET /services/2/vaulted-shoppers/{vaultedShopperId}

Description:
This endpoint retrieves the details of a vaulted shopper from BlueSnap using their unique ID. Vaulted shoppers store payment details and personal data for future transactions (e.g. subscriptions or saved payment methods). This is typically used to manage or reuse stored shopper data securely.

Request Headers:

Example Request:
GET /services/2/vaulted-shoppers/123456789

Successful Response:

Example Error Response:


Hosted Checkout

Endpoint:
POST /services/2/bn3-services/jwt

Description:
This endpoint is used to generate a JWT (JSON Web Token) for initiating a BlueSnap Hosted Checkout session.

Request Headers:

Successful Response:

Example Error Response:


Update Vaulted Shopper

Endpoint:
PUT /services/2/vaulted-shoppers/

Description:
Updates an existing vaulted shopper's payment or personal information.

Request Headers:

Example Request Body:

Successful Response:

Example Error Response:


Refund Transaction

Endpoint:
POST /services/2/transactions/refund/

Description:
Processes a refund for a transaction. Can include metadata and options to cancel subscriptions.

Request Headers:

Example Request Body:

Successful Response:

Example Error Response:


Best Practices

Troubleshooting

Issue: Payment method not appearing at checkout

Issue: 3D Secure not triggering

Issue: Saved cards are not displaying

Issue: Refund fails or doesn’t reflect in order status

FAQ

What payment methods does the Bluesnap Shopware 6 Plugin support?

Can customers save their card details for future use?

How do I enable 3D Secure?

Is sandbox testing supported?

Can I issue partial refunds?

Can I add a surcharge to credit card payments?

Wiki Documentation

Read more about the plugin configuration on our [Wiki]().


All versions of bluesnap with dependencies

PHP Build Version
Package Version
Requires shopware/core Version ~6.7.0
shopware/storefront Version ~6.7.0
guzzlehttp/guzzle Version ^7.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package solution25/bluesnap contains the following files

Loading the files please wait ...