README

You can sign up for a SrPago account at https://www.srpago.com.

Requirements

PHP 5.3.3 and later.

Composer - Installation

You can install the bindings via Composer. Run the following command:

composer require srpago/srpago-php

To use the bindings, use Composer's autoload:

require_once('vendor/autoload.php');

Manual - Installation

If you do not wish to use Composer, you can download the latest release. Then, to use the bindings, include the init.php file.

//Required
include_once '/vendor/php-restclient-master/restclient.php';
include_once '/vendor/srpago-php/init.php';

Dependencies

The bindings require the following extension in order to work properly:

• curl, although you can use your own non-cURL client if you prefer
• json
• mbstring (Multibyte String)

If you use Composer, these dependencies should be handled automatically. If you install manually, you'll want to make sure that these extensions are available.

Getting Started

Simple usage looks like:

SrPago::setLiveMode(false);
SrPago::setApiKey('999999seere4-6e52-449d-83d0-898294843222');
SrPago::setApiSecret('Absjrj432002$$.4322');

/// Parámetros de cobro
$chargeParams = array(
     "amount"=>9.0,
     "description" => "demo de cargo directo con token", //OPTIONAL DESCRIPTION
     "reference"=> "AB98XXCVBD",//OPTIONAL REFERENCE ID
     "ip"=> "189.203.45.58",//OPTIONAL REMOTE IP
     //"latitude"=> "-9.11111111",//OPTIONAL LATITUDE
     //"longitude"=> "9.999999",//OPTIONAL LONGITUDE
     //"installments"=>3,    //OPTIONAL Montly installments 3,6,9,12
     "source"=>"tok_5966f0cdd3697"
   );

   //Include Metadata
   $metadata = array(
     "items"=>array(
        "item" => array(
            array(
              "itemNumber"=> "193487654",
              "itemDescription"=> "iPhone 6 32gb",
              "itemPrice"=> "599.00",
              "itemQuantity"=> "1",
              "itemMeasurementUnit"=> "Pza",
              "itemBrandName"=> "Apple",
              "itemCategory"=> "Electronics",
              "itemTax"=> "12.95"
          ),
        )
      )
   );
   $chargeParams['metadata'] = $metadata;


$chargesService = new \SrPago\Charges();

$charge = $chargesService->create($chargeParams);


echo $charge;

Documentation

Please see https://srpago.com/docs/api for up-to-date documentation.

Legacy Version Support

If you are using PHP 5.2, you can download v1.18.0 (zip, tar.gz) from our releases page. This version will continue to work with new versions of the SrPago API for all common uses.

This legacy version may be included via require_once("/path/to/srpago-php/lib/SrPago.php");, and used like:

Development

Install dependencies:

composer install

SSL / TLS configuration option

See the "SSL / TLS compatibility issues" paragraph above for full context. If you want to ensure that your plugin can be used on all systems, you should add a configuration option to let your users choose between different values for CURLOPT_SSLVERSION: none (default), CURL_SSLVERSION_TLSv1 and CURL_SSLVERSION_TLSv1_2.