ineszetter / bbva-csharp

EcommerceBBVA: C#SHARP Library

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

Compatibility

• .Net Framework 4.5 or later

Dependencies

• Newtonsoft.Json

Quick Start

Installation

It is recommended that you use NuGet for install this library. Or you can fork the code and build it.

Configuration

Before use the library will be necessary to set up your Merchant ID and Private key. Use:

BbvaAPI bbvaAPI = new BbvaAPI(API_KEY, MERCHANT_ID);

Sandbox/Production 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, create BbvaAPI object like this:

Boolean production = true;
BbvaAPI bbvaAPI = new BbvaAPI(API_KEY, MERCHANT_ID, production);

or use Production property:

BbvaAPI bbvaAPI = new BbvaAPI(API_KEY, MERCHANT_ID);
bbvaAPI.Production = true;

API Services

Once configured the library, you can use it to interact with Bbva API services. All the API services are properties of the BbvaAPI class.

bbvaAPI.ChargeTokenService
bbvaAPI.TokenService

Each service has methods to create, get, update, delete or list resources according to the documetation described on http://docs.bbva.mx

Examples

Charges

Create a charge

BbvaAPI api = new BbvaAPI("sk_326c6d0443f6457aae29ffbd48f7d1be", "mptdggroasfcmqs8plpy");

ParameterContainer customer = new ParameterContainer("customer");
    customer.AddValue("name", "Juan");
    customer.AddValue("last_name", "Vazquez Juarez");
    customer.AddValue("email", "[email protected]");
    customer.AddValue("phone_number", "554-170-3567");

ParameterContainer request = new ParameterContainer("charge");
    request.AddValue("affiliation_bbva", "781500");
    request.AddValue("amount", "100.00");
    request.AddValue("description", "Cargo inicial a mi merchant");
    request.AddValue("currency", "MXN");
    request.AddValue("order_id", "oid-00051");
    request.AddValue("redirect_url", "https://sand-portal.ecommercebbva.com");
    request.AddMultiValue(customer):

Dictionary<String, Object> chargeDictionary = bbvaAPI.ChargeService.Create(request.ParameterValues);
ParameterContainer charge = new ParameterContainer("charge", chargeDictionary);