SOFORT Überweisung Omnipay gateway

, _(*1)

SOFORT Überweisung gateway for awesome Omnipay library., _(*2)

Important Note: Omnipay 1.x Users, _(*3)

If you are using Omnipay 1.x versions please use 1.x tree. For detailed information you can check Omnipay's 2.0 release notes., _(*4)

API Notes

This gateway only provides 2 methods to place a successful transaction. The first one is authorize which initializes an authorization and returns a redirect url., _(*5)

The second one is completeAuthorize. This method doesn't actually complete anything. Since SOFORT Überweisung doesn't have a capture functionality, the only way to know about a transaction is checking that transaction details. According to official docs, if there is no any successful or failed transactions, the API will return empty transactions XML object., _(*6)

Installation

To install, simply add it to your composer.json file:, _(*7)

{
    "require": {
        "asci/omnipay-sofort": "~2.0"
    }
}

and run composer update, _(*8)

Usage

For general usage instructions, please see the main Omnipay repository., _(*9)

1. Authorize, _(*10)

$gateway = Omnipay::create('Sofort');
$gateway->initialize(array(
    'username' => 'your_account_id',
    'password' => 'password',
    'projectId' => 'sofort_project_id',
    'testMode' => true
));

$response = $gateway->authorize(array(
    'amount' => 199.00,
    'description' => 'Google Nexus 4',
))->send();

$transactionReference = $response->getTransactionReference();

if ($response->isRedirect()) {
    // redirect to offsite payment gateway
    $response->redirect();
} else {
    // payment failed: display message to customer
    echo $response->getMessage();
}

2. Complete Authorize, _(*11)

$gateway = Omnipay::create('Sofort');
$gateway->initialize(array(
    'username' => 'your_account_id',
    'password' => 'password',
    'projectId' => 'sofort_project_id',
    'testMode' => true
));

$response = $gateway->completeAuthorize(array(
    'transactionId' => $transactionReference,
))->send();

if ($response->isSuccessful()) {
    // payment was successful
    print_r($response);
} else {
    // payment failed: display message to customer
    echo $response->getMessage();
}