PHPackages                             ebethus/bbvasdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. ebethus/bbvasdk

ActiveLibrary[Payment Processing](/categories/payments)

ebethus/bbvasdk
===============

This is a client implementing the payment services for Bbva at bbva.com

0195PHP

Since Oct 13Pushed 5y agoCompare

[ Source](https://github.com/EBethus/BBVALibPHP)[ Packagist](https://packagist.org/packages/ebethus/bbvasdk)[ RSS](/packages/ebethus-bbvasdk/feed)WikiDiscussions master Synced 6d ago

READMEChangelogDependenciesVersions (1)Used By (0)

Bbva PHP

PHP client for Bbva API services (version 1.0.0)

This is a client implementing the payment services for Bbva at bbva.mx

What's new?
-----------

[](#whats-new)

Compatibility
-------------

[](#compatibility)

PHP 5.2 or later

Requirements
------------

[](#requirements)

PHP 5.2 or later cURL extension for PHP JSON extension for PHP Multibyte String extension for PHP

Installation
------------

[](#installation)

### Composer

[](#composer)

The preferred method is via [composer](https://getcomposer.org). Follow the [installation instructions](https://getcomposer.org/doc/00-intro.md) if you do not already have composer installed.

Once composer is installed, execute the following command in your project root to install this library:

```
composer require bbva/sdk dev-master
```

Finally, be sure to include the autoloader:

```
require_once '/path/to/your-project/vendor/autoload.php';
```

### Manual installation

[](#manual-installation)

To install, just:

- Clone the repository or download the library and copy/create a folder named **'Bbva'** inside your project folder structure. If you downloaded the client library as a compressed file, uncompress it and create the proper folder structure.
- At the top of the PHP script in which the client library will be used (or in the section you include other libraries), add the client's library main script:

```
require(dirname(__FILE__) . '/Bbva/Bbva.php');
```

> NOTE: In the example above, the library is located in the directory named Bbva, located inside the same directory that the PHP file which is including the cliente. Make sure to adjust the paths inside your project, otherwise the library will not work.

Implementation
--------------

[](#implementation)

#### Configuration

[](#configuration)

Before use the library will be necessary to set up your Merchant ID and Private key. There are three options:

- Use the methods **Bbva::setId()** and **Bbva::setApiKey()**. Just pass the proper parameters to each function:

```
Bbva::setId('moiep6umtcnanql3jrxp');
Bbva::setApiKey('sk_3433941e467c4875b178ce26348b0fac');
```

- Pass Merchant ID and Private Key as parameters to the method **Bbva::getInstance()**, which is the instance generator:

```
$bbva = Bbva::getInstance('moiep6umtcnanql3jrxp', 'sk_3433941e467c4875b178ce26348b0fac');
```

- Configure the Marchant ID and the Private Key as well, as environment variables. This method has its own advantages as this sensitive data is not exposed directly in any script.

> NOTE: please, refer to PHP documentation for further information about this method.

##### Sandbox/Production Mode

[](#sandboxproduction-mode)

By convenience and security, the sandbox mode is activated by default in the client library. This allows you to test your own code when implementing Bbva, before charging any credit card in production environment. Once you have finished your integration, use the method **Bbva::setProductionMode(FLAG)** which will allow you to active/inactivate the sandbox mode.

```
Bbva::setProductionMode(true);
```

Also you can use environment variables for this purpose:

```
SetEnv BBVA_PRODUCTION_MODE true

```

If its necessary, you can use the method **Bbva::getProductionMode()** to determine anytime, which is the sandbox mode status:

```
// will return TRUE/FALSE, depending on if sandbox mode is activated or not.
Bbva::getProductionMode();
```

#### PHP client library intro

[](#php-client-library-intro)

Once configured the library, you can use it to interact with Bbva API services. The first step is get an instance with the generator:

```
$bbva = Bbva::getInstance('mptdggroasfcmqs8plpy', 'sk_326c6d0443f6457aae29ffbd48f7d1be');
```

In this example **$bbva** will be an instance of a merchant (root), wich will be used to call any derived child resource. According to the current version of the Bbva API, these resources are:

- charges
- tokens

You can access all of these resources as public variables of the root instance, so, if you want to add a new customer you will be able to do it as follows:

```
$bbva->tokens->add(PARAMETERS);
```

Every call to any resource will return an instance of that resource. In the example above, calling the method **add()** in the resource **tokens** will return an instance of Token, calling the method **add()** in the resource **tokens**will return an instance of Card, and so on. The only exception occurs when you retrieve a list of resources using the method **getList()**, in which case an array of instances will be returned:

```
// a SINGLE instance of Customer will be returned
$charge = $bbva->charges->add(PARAMETERS);

// an ARRAY of instances of Customers will be returned
chargersList = $bbva->charges->getList(PARAMETERS);

```

On the other hand, the resources derived from Charge, according to Bbva API documentation, are:

- charges
- tokens

#### Parameters

[](#parameters)

Those methods which receive more than one parameter (for example, when trying to add a new customer or a new customer's card), must be passed as associatives arrays:

```
array('PARAMETER_INTEGER' => VALUE,
      'PARAMETER_STRING'  => 'VALUE');
      'PARAMETER_DERIVED' => array('PARAMETER_INTEGER' => VALUE),
                                   'PARAMETER_STRING'  => 'VALUE'));
```

> NOTE: Please refer to Bbva API docuemntation to determine wich parameters are accepted, wich required and which of those are optional, in every case.

#### Error handling

[](#error-handling)

The Bbva API generates several types of errors depending on the situation, to handle this, the PHP client has implemented five type of exceptions:

- **BbvaApiTransactionError**. This category includes those errors ocurred when the transaction does not complete successfully: declined card, insufficient funds, inactive destination account, etc.
- **BbvaApiRequestError**. It refers to errors generated when a request to the API fail. Examples: invalid format in data request, incorrect parameters in the request, Bbva internal servers errors, etc.
- **BbvaApiConnectionError**. These exceptions are generated when the library try to connect to the API but fails in the attempt. For example: timeouts, domain name servers, etc.
- **BbvaApiAuthError**. Errors which are generated when the authentication data are specified in an invalid format or, if are not fully validated on the Bbva server (Merchant ID or Private Key).
- **BbvaApiError**. This category includes all generic errors when processing with the client library.

All these error exceptions make available all the information returned by the Bbva API, with the following methods:

- **getDescription()**: Error description generated by Bbva server.
- **getErrorCode()**: Error code generated by Bbva server. When the error is generated before the request, this value is equal to zero.
- **getCategory()**: Error category generated and determined by Bbva server. When the error is generated before or during the request, this value is an empty string.
- **getHttpCode()**: HTTP error code generated when request the Bbva server. When the error is generated before or during the request, this value is equal to zero.
- **getRequestId()**: ID generated by the Bbva server when process a request. When the error is generated before the request, this value is an empty string.

The following is an more complete example of error catching:

```
try {
	Bbva::setProductionMode(true);

	// the following line will generate an error because the
	// private key is empty. The exception generated will be
	// a BbvaApiAuthError
	$bbva = Bbva::getInstance('mptdggroasfcmqs8plpy', '');

	$customer = $bbva->customers->get('a9ualumwnrcxkl42l6mh');
 	$customer->name = 'Juan';
 	$customer->last_name = 'Godinez';
 	$customer->save();

} catch (BbvaApiTransactionError $e) {
	error_log('ERROR on the transaction: ' . $e->getMessage() .
	      ' [error code: ' . $e->getErrorCode() .
	      ', error category: ' . $e->getCategory() .
	      ', HTTP code: '. $e->getHttpCode() .
	      ', request ID: ' . $e->getRequestId() . ']', 0);

} catch (BbvaApiRequestError $e) {
	error_log('ERROR on the request: ' . $e->getMessage(), 0);

} catch (BbvaApiConnectionError $e) {
	error_log('ERROR while connecting to the API: ' . $e->getMessage(), 0);

} catch (BbvaApiAuthError $e) {
	error_log('ERROR on the authentication: ' . $e->getMessage(), 0);

} catch (BbvaApiError $e) {
	error_log('ERROR on the API: ' . $e->getMessage(), 0);

} catch (Exception $e) {
	error_log('Error on the script: ' . $e->getMessage(), 0);
}
```

Examples
--------

[](#examples)

#### Customers

[](#customers)

Add a new customer to a merchant:

```
$bbva = Bbva::getInstance('mptdggroasfcmqs8plpy', 'sk_326c6d0443f6457aae29ffbd48f7d1be');

$customerData = array(
	'name' => 'Teofilo',
	'last_name' => 'Velazco',
	'email' => 'teofilo@payments.com',
	'phone_number' => '4421112233',
	'address' => array(
			'line1' => 'Privada Rio No. 12',
			'line2' => 'Co. El Tintero',
			'line3' => '',
			'postal_code' => '76920',
			'state' => 'Querétaro',
			'city' => 'Querétaro.',
			'country_code' => 'MX'));
```

#### Tokens

[](#tokens)

**On a merchant:**

Add a token:

```
$bbva = Bbva::getInstance('mptdggroasfcmqs8plpy', 'sk_326c6d0443f6457aae29ffbd48f7d1be');

$tokenData = array(
	'holder_name' => 'Luis Pérez',
	'card_number' => '4111111111111111',
	'cvv2' => '123',
	'expiration_month' => '12',
	'expiration_year' => '15',
	'address' => array(
		'line1' => 'Av. 5 de Febrero No. 1',
		'line2' => 'Col. Felipe Carrillo Puerto',
		'line3' => 'Zona industrial Carrillo Puerto',
		'postal_code' => '76920',
		'state' => 'Querétaro',
		'city' => 'Querétaro',
		'country_code' => 'MX'));

$token = $bbva->tokens->add($tokenData);
```

Get a token:

```
$bbva = Bbva::getInstance('mptdggroasfcmqs8plpy', 'sk_326c6d0443f6457aae29ffbd48f7d1be');

$token = $bbva->tokens->get('k9pn8qtsvr7k7gxoq1r5');
```

#### Charges

[](#charges)

**On a Merchant:**

Make a charge on a merchant:

```
$bbva = Bbva::getInstance('mptdggroasfcmqs8plpy', 'sk_326c6d0443f6457aae29ffbd48f7d1be');

$chargeData = array(
	'affiliation_bbva' => '781500',
	'amount' => 100,
	'currency' => 'MXN',
	'order_id' => 'ORDEN-00071',
	'customer' => array(
		'name' => 'Teofilo',
		'last_name' => 'Velazco',
		'email' => 'teofilo@payments.com',
		'phone_number' => '4421112233',
		'address' => array(
			'line1' => 'Privada Rio No. 12',
			'line2' => 'Co. El Tintero',
			'line3' => '',
			'postal_code' => '76920',
			'state' => 'Querétaro',
			'city' => 'Querétaro.',
			'country_code' => 'MX')),
	'description' => 'Cargo inicial a mi merchant'
	'redirect_url' => 'https://sand-portal.ecommercebbva.com/'
	);

$charge = $bbva->charges->create($chargeData);
```

Get a charge:

```
$bbva = Bbva::getInstance('mptdggroasfcmqs8plpy', 'sk_326c6d0443f6457aae29ffbd48f7d1be');

$charge = $bbva->charges->get('tvyfwyfooqsmfnaprsuk');
```

Make a capture:

```
$bbva = Bbva::getInstance('mptdggroasfcmqs8plpy', 'sk_326c6d0443f6457aae29ffbd48f7d1be');

$captureData = array('amount' => 150.00 );

$charge = $bbva->charges->get('tvyfwyfooqsmfnaprsuk');
$charge->capture($captureData);
```

Make a refund:

```
$bbva = Bbva::getInstance('mptdggroasfcmqs8plpy', 'sk_326c6d0443f6457aae29ffbd48f7d1be');

$refundData = array('description' => 'Devolución' );

$charge = $bbva->charges->get('tvyfwyfooqsmfnaprsuk');
$charge->refund($refundData);
```

###  Health Score

19

—

LowBetter than 10% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity32

Early-stage or recently created project

 Bus Factor1

Top contributor holds 90.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/25f561a3fd260935cc3ea5dc049b4ff598c37408dfdbbc129d091221de6c2954?d=identicon)[alb\_be](/maintainers/alb_be)

---

Top Contributors

[![mguevara-openpay](https://avatars.githubusercontent.com/u/41696276?v=4)](https://github.com/mguevara-openpay "mguevara-openpay (10 commits)")[![bethuxs](https://avatars.githubusercontent.com/u/191869?v=4)](https://github.com/bethuxs "bethuxs (1 commits)")

### Embed Badge

![Health badge](/badges/ebethus-bbvasdk/health.svg)

```
[![Health](https://phpackages.com/badges/ebethus-bbvasdk/health.svg)](https://phpackages.com/packages/ebethus-bbvasdk)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)