PHP download

Download the PHP package hds-solutions/bancard-sdk without Composer

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

Table of contents
Download hds-solutions/bancard-sdk
More information about hds-solutions/bancard-sdk
Files in hds-solutions/bancard-sdk

Vendor hds-solutions
Package bancard-sdk
Short Description Bancard SDK library
License GPL-3.0

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?

Example code of hds-solutions/bancard-sdk

Informations about the package bancard-sdk

Bancard SDK

A comprehensive PHP SDK for integrating Bancard vPOS and Bancard VentasQR payment solutions into your applications.

Installation
Configuration
vPOS Integration
- Features
- Usage Examples
- Error Handling
VentasQR Integration
- Features
- Usage Examples
Advanced Usage
API Reference
Contributing
License

Installation

Requirements

PHP >= 8.0

Via composer

Configuration

Setting up Credentials

Environment Configuration

The SDK uses the staging environment by default for vPOS. Switch to production when ready:

vPOS Integration

vPOS Features

Single payments
Single payments through Zimple
Card management
Charge payments to registered cards
Pre-authorization
Transaction management (get confirmation and rollback payments)

vPOS Usage Examples

Single Payment Flow

Endpoint used to generate a process ID to call the Bancard <iframe> for a one-time payment.

Single Payment Flow through Zimple

Same as above, but for Zimple payments.

Card Management

Register a New Card
List User's Cards
Charge a Registered Card
Get the confirmation of a Payment

Endpoint to get the confirmation of a payment. Example, in case the above charge request stayed as a pending of confirmation payment.

Rollback a Payment
Remove a Registered Card

Error Handling

The SDK provides comprehensive error handling for various scenarios:

1. Basic Error Handling

2. Transaction Response Handling

3. Debug Information

VentasQR Integration

VentasQR Credentials

⚠ Important: VentasQR is not scoped by Bancard::useProduction(), since your assigned domain will define your testing/production environment.

VentasQR Features

Generate QR codes for payments
Revert QR payments

VentasQR Usage Examples

Generate QR Code
Revert QR Payment

Advanced Usage

Request/Response Inspection

Access request and response details for debugging:

Customizable requests

If you need, you can create a pending request and change the values on runtime. This applies to all available requests.

API Reference

vPOS Methods

Bancard::single_buy() - Process a one-time payment
Bancard::single_buy_zimple() - Process a Zimple payment
Bancard::card_new() - Register a new card
Bancard::users_cards() - List user's registered cards
Bancard::card_delete() - Remove a registered card
Bancard::charge() - Charge a registered card
Bancard::confirmation() - Check payment status
Bancard::preauthorizationConfirm() - Confirm a pre-authorized payment
Bancard::rollback() - Cancel a pending transaction

VentasQR Methods

Bancard::qr_generate() - Generate a QR code for payment
Bancard::qr_revert() - Cancel a QR payment

Currency Support

The SDK supports multiple currencies through the Currency class:

Currency::Guarani - Paraguayan Guarani (PYG)
Currency::Dollar - US Dollar (USD)

For detailed API documentation, visit:

Contributing

Contributions are welcome! If you find any issues or would like to add new features or improvements, please feel free to submit a pull request.

Contributors

Hermann D. Schimpf

Security Vulnerabilities

If you encounter any security-related issues, please feel free to raise a ticket on the issue tracker.

License

This library is open-source software licensed under the MIT License. Please see the License File for more information.

All versions of bancard-sdk with dependencies

PHP Build Version

Package Version

Version v1.1.3 Release 09. Jan 2025
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of bancard-sdk from vendor hds-solutions

Requires php Version >=8.0
guzzlehttp/guzzle Version ^7.5
guzzlehttp/psr7 Version ^2.4

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 hds-solutions/bancard-sdk contains the following files

Loading the files please wait ....