Some great updates are comming soon...
| TBC Payment | |
|---|---|
 |
"TBC" payment integration for Laravel 5.*, created for Georgian developers. 💡 Inspired by tbcpay-php from Sandro Dzneladze 🎉 Pull requests are welcome. |
Run composer command in your terminal.
composer require zgabievi/tbc
Open config/app.php and find the providers key. Add TBCServiceProvider to the array.
Gabievi\TBC\TBCServiceProvider::classFind the aliases key and add Facade to the array.
'TBC' => Gabievi\TBC\TBCFacade::classThere are two types of transaction within this system:
- SMS is direct payment, where money is charged in 1 event.
- 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
There are several methods you need to know:
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()
In your routes.php create route:
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:
<!doctype html>
<html>
<head>
<title>TBC</title>
</head>
<body>
@if(isset($start['error']))
<h2>Error:</h2>
<h1>{{ $start['error'] }}</h1>
@elseif(isset($start['TRANSACTION_ID']))
<form name="returnform" id="Pay" action="https://securepay.ufc.ge/ecomm2/ClientHandler" method="POST">
<input type="hidden" name="trans_id" value="{{ $start['TRANSACTION_ID'] }}">
<noscript>
<center>Please click the submit button below.<br>
<input type="submit" name="submit" value="Submit"></center>
</noscript>
</form>
<script>
window.onload = document.forms.Pay.submit;
</script>
@endif
</body>
</html>| 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 |
Publish TBC config file using command:
php artisan vendor:publish
Created file config\tbc.php. Inside you can change configuration as you wish.
laravel-tbcpay is licensed under a MIT License.
- 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