README.md

wollito

Wollito Payment Gateway

Wollito Payment Gateway

To install the payment gateway we can use composer.
composer require wollito/wollito:dev-main

After package installation, you need to include the autoload file in your project.
require_once "vendor/autoload.php"; \

Ensure your composer.json includes the following;

    "autoload": {
        "psr-4": {
            "WollitoPackage\\": "vendor/wollito/wollito"
        }
    }
                

Introduction:

To get start you must instantiate the class, you pass the API Key, API Secret & Currency

Currency options include; GBP, USD, EUR \

$wollito = new \WollitoPackage\Wollito("YOUR KEY HERE", "YOUR SECRET KEY HERE", "CURRENCY (GBP)");
\

Once you have instantiated the class, you can call function using the $wollito variable.

Set Address Details

$wollito->set_address_info($_POST['line1'], $_POST['line2'], $_POST['city'], $_POST['state'], $_POST['postal_code'], $_POST['country']);

Processing Payments:

The process payment functions, takes the parameters below and can be called like so: Generate random string as part of the from, so there are no duplicate payments.

$data = $wollito->process_payment("AMOUNT", "CARD NUMBER", "EXPIRY MONTH", "EXPIRY YEAR", "SECURITY CODE", "ORDER ID", "RANDOM STRING");
\

Response:

The call will return a JSON object containing the status and date or error message

if($data){
    $data = json_decode($data);

    //STORE ORDER IN DB FOR WEBHOOK CALLS ETC

    if(isset($data->status)){
        switch ($data->status){
            case 'success':
                //Payment success. Charge id $data->data
                break;

            case 'failed':
                //Payment failed, further info $data->message
                break;

            case 'pending':
                //Payment Pending. Notification update in webhook.php
                break;

            default:
                //Unknown status
                break;
        }
    }
}

            

Webhook:

Sometimes payments are returned as pending and therefore will need updating via a webhook.

Webhook calls are posted to webhook.php, to the originating site URL which made the charge request.

Webhooks can be authenticated with the following call, just pass the $_POST data variable

$wollito->validate_webhook_call($_POST);

Examples can be found Here