chargeio-php
============

ChargeIO PHP Client Library

## Installation

Download the PHP client library by doing the following:

    git clone git://github.com/charge-io/chargeio-php.git

To use the library in your application, add the following to your PHP script:

    require_once '/path/to/chargeio-php/lib/ChargeIO.php';

The library's APIs require credentials to access your merchant data on the
ChargeIO servers. You can provide credentials as arguments to the APIs used to
retrieve objects, or you can configure the library with default credentials to
use when necessary. To set the default credentials, substitute your ChargeIO
public key and test or live-mode secret key in a call to setCredentials:

    ChargeIO::setCredentials(new ChargeIO_Credentials('<public_key>', '<secret_key>'));

Once your credentials are set, running a basic credit card charge looks like:

    $card = new ChargeIO_Card(array('number' => '4242424242424242', 'exp_month' => 10, 'exp_year' => '2019'));
    $charge = ChargeIO_Charge::create($card, 1200);

Using the ChargeIO.js library for payment tokenization support on your payment page
simplifies the process even more. Just configure the token callback on your page to
POST the token ID you receive to your PHP script and then perform the charge:

    $amount = $_POST['amount'];
    $token_id = $_POST['token_id'];
    $charge = ChargeIO_Charge::create(new ChargeIO_PaymentMethodReference(array('id' => $token_id)), $amount);

## Documentation

The latest ChargeIO API documentation is available at https://developers.affinipay.com/reference/api.html#PaymentGatewayAPI.