2017 © Pedro Peláez
 

library tbc

TBC Payment System

image

zgabievi/tbc

TBC Payment System

  • Friday, April 20, 2018
  • by zgabievi
  • Repository
  • 2 Watchers
  • 10 Stars
  • 407 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 4 Forks
  • 0 Open issues
  • 10 Versions
  • 2 % Grown

The README.md

laravel-tbcpay

Some great updates are comming soon..., (*1)

Latest Stable Version Total Downloads License StyleCI Codacy Badge, (*2)

TBC Payment
TBC Payment "TBC" payment integration for Laravel 5.*, created for Georgian developers. :bulb: Inspired by tbcpay-php from Sandro Dzneladze :tada: Pull requests are welcome.

Table of Contents

Installation

Composer

Run composer command in your terminal., (*3)

composer require zgabievi/tbc

Laravel

Open config/app.php and find the providers key. Add TBCServiceProvider to the array., (*4)

Gabievi\TBC\TBCServiceProvider::class

Find the aliases key and add Facade to the array., (*5)

'TBC' => Gabievi\TBC\TBCFacade::class

Documentation

There are two types of transaction within this system:, (*6)

  1. SMS is direct payment, where money is charged in 1 event.
  2. DMS is delayed payment, requires 2 events:
    • First event blocks money on the card
    • Second event takes money (It can be carried out when product is shipped to the customer, for example)

In every 24 hour the merchant must send the close the business day request to bank server, (*7)

Usage

There are several methods you need to know:, (*8)

  • SMSTransaction($amount, $currency = 981, $description = '', $language = 'GE')
  • DMSAuthorization($amount, $currency = 981, $description = '', $language = 'GE')
  • DMSTransaction($txn_id, $amount, $currency = 981, $description = '', $language = 'GE')
  • getTransactionResult($txn_id)
  • reverseTransaction($txn_id, $amount = '', $suspected_fraud = '')
  • refundTransaction($txn_id)
  • creditTransaction($txn_id, $amount = '')
  • closeDay()

Examples

In your routes.php create route:, (*9)

Route::get('payment/{status}', function($status) {
    if ($status == 'success') {
        return TBC::getTransactionResult(request('trans_id'));
    }

    return 'FAIL!';
})->where('status', 'success|fail');

Route::get('pay', function() {
    return view('payment.tbc', [
        'start' => TBC::SMSTransaction(1)
    ]);
});

Create payment/tbc.blade.php. It should look like:, (*10)

<!doctype html>
<html>
<head>
    <title>TBC</title>
</head>
<body>

@if(isset($start['error']))



Error:



    <h1>{{ $start['error'] }}</h1>
@elseif(isset($start['TRANSACTION_ID']))
<script> window.onload = document.forms.Pay.submit; </script> @endif </body> </html>

Codes

Key Value Description
000 Approved Approved
001 Approved with ID Approved, honour with identification
002 Approved Approved for partial amount
003 Approved Approved for VIP
004 Approved Approved, update track 3
005 Approved Approved, account type specified by card issuer
006 Approved Approved for partial amount, account type specified by card issuer
007 Approved Approved, update ICC
100 Decline Decline (general, no comments)
101 Decline Decline, expired card
102 Decline Decline, suspected fraud
103 Decline Decline, card acceptor contact acquirer
104 Decline Decline, restricted card
105 Decline Decline, card acceptor call acquirer's security department
106 Decline Decline, allowable PIN tries exceeded
107 Decline Decline, refer to card issuer
108 Decline Decline, refer to card issuer's special conditions
109 Decline Decline, invalid merchant
110 Decline Decline, invalid amount
111 Decline Decline, invalid card number
112 Decline Decline, PIN data required
113 Decline Decline, unacceptable fee
114 Decline Decline, no account of type requested
115 Decline Decline, requested function not supported
116 Decline, no funds Decline, not sufficient funds
117 Decline Decline, incorrect PIN
118 Decline Decline, no card record
119 Decline Decline, transaction not permitted to cardholder
120 Decline Decline, transaction not permitted to terminal
121 Decline Decline, exceeds withdrawal amount limit
122 Decline Decline, security violation
123 Decline Decline, exceeds withdrawal frequency limit
124 Decline Decline, violation of law
125 Decline Decline, card not effective
126 Decline Decline, invalid PIN block
127 Decline Decline, PIN length error
128 Decline Decline, PIN kay synch error
129 Decline Decline, suspected counterfeit card
180 Decline Decline, by cardholders wish
200 Pick-up Pick-up (general, no comments)
201 Pick-up Pick-up, expired card
202 Pick-up Pick-up, suspected fraud
203 Pick-up Pick-up, card acceptor contact card acquirer
204 Pick-up Pick-up, restricted card
205 Pick-up Pick-up, card acceptor call acquirer's security department
206 Pick-up Pick-up, allowable PIN tries exceeded
207 Pick-up Pick-up, special conditions
208 Pick-up Pick-up, lost card
209 Pick-up Pick-up, stolen card
210 Pick-up Pick-up, suspected counterfeit card
300 Call acquirer Status message: file action successful
301 Call acquirer Status message: file action not supported by receiver
302 Call acquirer Status message: unable to locate record on file
303 Call acquirer Status message: duplicate record, old record replaced
304 Call acquirer Status message: file record field edit error
305 Call acquirer Status message: file locked out
306 Call acquirer Status message: file action not successful
307 Call acquirer Status message: file data format error
308 Call acquirer Status message: duplicate record, new record rejected
309 Call acquirer Status message: unknown file
400 Accepted Accepted (for reversal)
499 Approved Approved, no original message data
500 Call acquirer Status message: reconciled, in balance
501 Call acquirer Status message: reconciled, out of balance
502 Call acquirer Status message: amount not reconciled, totals provided
503 Call acquirer Status message: totals for reconciliation not available
504 Call acquirer Status message: not reconciled, totals provided
600 Accepted Accepted (for administrative info)
601 Call acquirer Status message: impossible to trace back original transaction
602 Call acquirer Status message: invalid transaction reference number
603 Call acquirer Status message: reference number/PAN incompatible
604 Call acquirer Status message: POS photograph is not available
605 Call acquirer Status message: requested item supplied
606 Call acquirer Status message: request cannot be fulfilled - required documentation is not available
680 List ready List ready
681 List not ready List not ready
700 Accepted Accepted (for fee collection)
800 Accepted Accepted (for network management)
900 Accepted Advice acknowledged, no financial liability accepted
901 Accepted Advice acknowledged, finansial liability accepted
902 Call acquirer Decline reason message: invalid transaction
903 Call acquirer Status message: re-enter transaction
904 Call acquirer Decline reason message: format error
905 Call acquirer Decline reason message: acqiurer not supported by switch
906 Call acquirer Decline reason message: cutover in process
907 Call acquirer Decline reason message: card issuer or switch inoperative
908 Call acquirer Decline reason message: transaction destination cannot be found for routing
909 Call acquirer Decline reason message: system malfunction
910 Call acquirer Decline reason message: card issuer signed off
911 Call acquirer Decline reason message: card issuer timed out
912 Call acquirer Decline reason message: card issuer unavailable
913 Call acquirer Decline reason message: duplicate transmission
914 Call acquirer Decline reason message: not able to trace back to original transaction
915 Call acquirer Decline reason message: reconciliation cutover or checkpoint error
916 Call acquirer Decline reason message: MAC incorrect
917 Call acquirer Decline reason message: MAC key sync error
918 Call acquirer Decline reason message: no communication keys available for use
919 Call acquirer Decline reason message: encryption key sync error
920 Call acquirer Decline reason message: security software/hardware error - try again
921 Call acquirer Decline reason message: security software/hardware error - no action
922 Call acquirer Decline reason message: message number out of sequence
923 Call acquirer Status message: request in progress
950 Not accepted Decline reason message: violation of business arrangement
XXX Undefined Code to be replaced by card status code or stoplist insertion reason code

Config

Publish TBC config file using command:, (*11)

php artisan vendor:publish

Created file config\tbc.php. Inside you can change configuration as you wish., (*12)

License

laravel-tbcpay is licensed under a MIT License., (*13)

TODO

  • [ ] Take response codes from README and put somewhere else
  • [ ] Create some tests to check full functionality
  • [ ] Make TBC facade more Model like
  • [ ] Create payment view in vendor, so that developer won't have to do it manually

The Versions

20/04 2018

dev-master

9999999-dev https://github.com/zgabievi/tbc

TBC Payment System

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar zgabievi

payment tbc zgabievi

20/04 2018

0.2.1

0.2.1.0 https://github.com/zgabievi/tbc

TBC Payment System

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar zgabievi

payment tbc zgabievi

02/06 2017

dev-dependenci7949

dev-dependenci7949 https://github.com/zgabievi/tbc

TBC Payment System

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar zgabievi

payment tbc zgabievi

08/02 2017

0.1.1

0.1.1.0 https://github.com/zgabievi/tbc

TBC Payment System

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar zgabievi

payment tbc zgabievi

04/01 2017

dev-analysis-zRmjB9

dev-analysis-zRmjB9 https://github.com/zgabievi/tbc

TBC Payment System

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar zgabievi

payment tbc zgabievi

04/01 2017

dev-analysis-qxjeya

dev-analysis-qxjeya https://github.com/zgabievi/tbc

TBC Payment System

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar zgabievi

payment tbc zgabievi

04/01 2017

dev-analysis-q1W3BN

dev-analysis-q1W3BN https://github.com/zgabievi/tbc

TBC Payment System

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar zgabievi

payment tbc zgabievi

04/01 2017

0.2.0

0.2.0.0 https://github.com/zgabievi/tbc

TBC Payment System

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar zgabievi

payment tbc zgabievi

04/01 2017

dev-analysis-8m193Y

dev-analysis-8m193Y https://github.com/zgabievi/tbc

TBC Payment System

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar zgabievi

payment tbc zgabievi

14/01 2016

0.1.0

0.1.0.0 https://github.com/zgabievi/tbc

TBC Payment System

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar zgabievi

payment tbc zgabievi