README

Gateway Setup

Basic Gateway Creation Code

$gateway = Omnipay::create('NetPay_Api');

On gateway you can set the following options:

Allows you to test your code in test environment:

$gateway->setTestMode(TRUE);

If your endpoint varies from default you can set it using these functions:

$gateway->setLiveEndpoint($liveUrl);
$gateway->setTestEndpoint($testUrl);

You can set your merchant credentials using functions:

$gateway->setMerchantId($merchant_id);
$gateway->setUsername($username);
$gateway->setPassword($password);

You can set SSL authentication for connection using functions:

$gateway->setCertificatePath($path_to_cert);
$gateway->setCertificateKeyPath($path_to_key);
$gateway->setCertificatePassword($cert_password);

Implemented Gateway Functionalities

Transactions using card data can be done following way:

$response = $gateway->purchase(array('amount' => '10.00', 'currency' => 'GBP', 'card' => $card))->send();
$response = $gateway->authorize(array('amount' => '10.00', 'currency' => 'GBP', 'card' => $card))->send();

You can use following function on any of previous requests to get order id of the payment:

$orderId = $response->getOrderId();
$response = $gateway->capture(array('amount' => '10.00', 'currency' => 'GBP', 'orderId' => $orderId))->send();
$response = $gateway->refund(array('amount' => '10.00', 'currency' => 'GBP', 'orderId' => $orderId))->send();

You can use following function on any of previous requests to get transaction id of the payment:

$transactionId = $response->getTransactionId();

$response = $gateway->retrieveTransaction(array('transactionId' => $transactionId, 'orderId' => $orderId))->send();
$response = $gateway->void(array('voidTransactionId' => $transactionId, 'orderId' => $orderId))->send();

Transaction id can also be retrieved from capture, refund and void requests.

For token transactions following can be used:

When saving card, permanent token expires when card expires and temporary one expires one hour after creation

$response = $gateway->createCard(array('card' => $card, 'tokenPermanent' => TRUE))->send();

You can retrieve created token from previous request the following way:

$token = $response->getToken();

Deletion of saved card

$response = $gateway->deleteCard(array('token' => $token))->send();

Retrieve info about stored card

$response = $gateway->retrieveCard(array('token' => $token))->send();

Making transactions using saved tokens

$response = $gateway->purchase(array('amount' => '10.00', 'currency' => 'GBP', 'token' => $token, 'cvv' => $cvv))->send();
$response = $gateway->authorize(array('amount' => '10.00', 'currency' => 'GBP', 'token' => $token, 'cvv' => $cvv))->send();

Following methods can be used on all requests:

Returns TRUE on successful transaction and FALSE on error

$response->isSuccessful();

Returns human readable message if there is one or NULL if not

$response->getMessage();

Following functions apply to purchase, authorize, capture, refund, void and retrieveTransaction methods, if data is unavailable they return NULL:

Value as generated by the acquirer that summarizes the success or otherwise of the proposed operation.

$response->getCode();

Value generated by the issuing bank in response to a proposal to transfer funds.

$response->getAuthorizationCode();

The Reference Retrieval Number (RRN) is a unique number generated by the acquirer for a specific merchant transaction. The RRN can be used to retrieve the transaction data from the acquirer.

$response->getReceipt();

Unique Order ID of the successful transaction.

$response->getOrderId();

The amount that has been successfully authorized for this order.

$response->getTotalAuthorizedAmount();

The amount that has been successfully captured for this order.

$response->getTotalCapturedAmount();

The amount that has been successfully refunded for this order.

$response->getRefundedAmount();

Summary of the success or otherwise of the proposed operation. List of codes at https://developer.netpay.co.uk/api/transaction/v1#collapseThree?retrieve_transaction_response under response.gateway_code

$response->getGatewayCode();

The acquirer CSC response code generated by the card issuing institution

$response->getCSCCode();

The card security code result generated to indicate whether the data supplied matches the data held by the cardholder's issuing bank. List of codes at https://developer.netpay.co.uk/api/transaction/v1#collapseThree?retrieve_transaction_response under response.cardsecurity.gateway_code

$response->getCSCGatewayCode();

The acquirer AVS response code generated by the card issuing institution.

$response->getAVSCode();

The address verification result generated to indicate whether the address data supplied matches the data held by the cardholder's issuing bank. List of codes at https://developer.netpay.co.uk/api/transaction/v1#collapseThree?retrieve_transaction_response under response.cardholder_verification.avs_gateway_code

$response->getAVSGatewayCode();