rohitsubedi / line-pay by rohitsubedi

Line Payment Package for Laravel
149
4
2
Package Data
Maintainer Username: rohitsubedi
Maintainer Contact: rohitsubedi@gmail.com (Rohit Subedi)
Package Create Date: 2017-06-13
Package Last Update: 2020-07-16
Language: PHP
License: MIT
Last Refreshed: 2024-03-26 03:11:28
Package Statistics
Total Downloads: 149
Monthly Downloads: 1
Daily Downloads: 0
Total Stars: 4
Total Watchers: 2
Total Forks: 3
Total Open Issues: 0

Line Payment

Very easy and light package for Line Payment.

Installation

Composer

Add Line Pay to your composer.json file

"rohit/line-pay": "^3.0"

Run composer install to get the latest version of package

Or you can directly run the composer require command

composer require rohit/line-pay

Configuration

After the package install is completed you need to configure config/app.php and add Providers and Aliases

    'providers` => [
        .......
        .......
        Rohit\LinePay\LinePayServiceProvider::class
    ]
    'aliases' => [
        ......
        ......
        'LinePay' => Rohit\LinePay\Facades\LinePay::class
    ]

Vendor Publish

After the above steps, you need to publish vendor for this packge. It will create line-pay.php file under config folder. This folder contains the configuration for your locales.

php artisan vendor:publish --provider="Rohit\LinePay\LinePayServiceProvider"

The file line-pay.php will contain the following structure

    return [
        'channel-id' => 'Line Pay Channel Id',
        'channel-secret' => 'Line Pay Channel Secret',
        'reservation-url' => 'https://sandbox-api-pay.line.me/v1/payments/request',
        'detail-url' => 'https://sandbox-api-pay.line.me/v1/payments',
    ];

Functions

  • Process Payment

    You can process your payment with the function process Payment which accepts array as an arguments with following

    LinePay::processPayment($params);
    

    The array params for processPayment is described below:

    | Items | Datatype | Required | Description | Remarks | |---|---|:---:|---|---| | productName | string (4000byte) | Y | Name of Product you want user to pay for | | amount | numeric | Y | Amount of the product | | currency | string (3byte) | Y | Payment Currency | supported Currencies are (USD, JPY, TWD, THB) | | orderId | string (100byte) | Y | Order Number corresponding to payment request | Must be unique for each order | | confirmUrl | string (500byte) | Y | Url to which Line will redirect after successful of payment | | cancelUrl | string (500byte) | N | Url to which Line will redirect when user cancel the payment | Default redirect to request URL. No additional parameters is sent by LINE | productImageUrl | string (500byte) | N | Url to Product Image | | mid | string (50byte) | N | Line member ID | | oneTimeKey | string (12byte) | N | Scanning and reading QR/Bar code information given by LINE pay app is used as LINE pay users's mid. Valid time is 5 minutes and it will be deleted with reserve at the same time | | confirmUrlType | string | N | Type of URL that the buyer is redirected to after selecting payment method and entering the payment password in LINE pay | CLIENT: A user based URL (DEFAULT). SERVER: A server based URL | | checkConfirmUrlBrowser | Boolean | N | When moved to confirmUrl. check a browser | true: When a browser calling a payment and browser directing to confirmUrl are different LINE pay provides a guide page directing to a previous browser. false: Redirecting to confirmUrl without checking a browser (DEFAULT) | | packageName | string (4000byte) | N | Information to avoid phishing during transition between apps in Android | | deliveryPlacePhone | string (100byte) | N | Receipent Contact Number | | payType | string (12byte) | N | Payment Types | NORMAL: Single Payment (DEFAULT)PREAPPROVED: Preapproved Payment | | langCd | string | N | Language code on the payment waiting screen | Supported Languages are: - ja (Japanese) - ko (Korean) - en (English) (DEFAULT) - zh-Hans (Chinese Simplified) - zh-Hant (Chinese Traditional) - th (Thai) | | capture | Boolean | N | Whether to capture or not | - true: Payment authorization and capture are handled at once when the confirm payment API is called (DEFAULT) - false: A payment is compleed only after it is authorized and then separately captured by calling Capture API when confirm payment API is called |

    The response from the process payment will be as below

    [
        'status' => 'success' or 'failed',
        'data' => [
            'request' => 'Params you send while calling the function (You may need to save it to log for future)',
            'response' => 'Array response (You may need to save it to log for future)',
        ],
    ]
    
    The response will be empty [] or as follows:
    [
        'returnCode' => '0000' (if success) or other code,
        'returnMessage' -> 'OK',
        'info' => [
            'transactionId' => 'Transaction Id eg: 12345678',
            'paymentUrl' => [
                'web' => 'Payment url for web.' (Need to redirect to this for payment),
                'app' => 'Payment url for app',
            ],
            'paymentAccessToken' => 'Access Token for Payment'
        ],
    ]
    
  • Verify Payment

    After Successful payment from line, it redirects to the confirmUrl. Now we need to verify the payment from line before updating our order. Its a 3 way handshake for security. This function takes 2 arguments. TransactionId and the array of parameters.

    LinePay::verifyPayment($transactionId, $params);
    

    The array param for verifyPayment is described below:

    | Items | Datatype | Required | Description | Remarks | |---|---|:---:|---|---| | amount | numeric | Y | Payment Amount | Should match with the amount on Process Payment for the given transaction Id. | | currency| string (3byte) | Y | Payment Currency | Should match with Currency on Process Payment for the given transaction Id. Supported Languages are: - ja (Japanese) - ko (Korean) - en (English) (DEFAULT) - zh-Hans (Chinese Simplified) - zh-Hant (Chinese Traditional) - th (Thai)

    The response from the verify payment will be as below

    [
        'status' => 'success' or 'failed',
        'data' => [
            'request' => 'Params you send while calling the function (You may need to save it to log for future)',
            'response' => 'Array response (You may need to save it to log for future)',
        ],
    ]
    

    The response will be empty [] or as follows:

    If payment Type is NORMAL the response will be as follow:
    [
        'returnCode' => '0000' (if success) or other code,
        'returnMessage' -> 'OK',
        'info' => [
            'orderId' => 'OrderID of the payment',
            'transactionId' => 'Transaction Id',
            'payInfo' => [
                [
                    'method' => 'BALANCE',
                    'amount' => '10',
                ],
                [
                    'method' => 'DISCOUNT',
                    'amount' => '10',
                ],
            ],
        ],
    ]
    
    If payment Type is PREAPPROVED the response will be as follow:
    [
        'returnCode' => '0000' (if success) or other code,
        'returnMessage' -> 'OK',
        'info' => [
            'orderId' => 'OrderID of the payment',
            'transactionId' => 'Transaction Id',
            'payInfo' => [
                [
                    'method' => 'CREDIT_CARD',
                    'amount' => '10',
                    'creditCardNickName' => 'test',
                    'creditCardBrand' => 'VISA',
                ],
                'regKey' => 'Random reg Key',
            ],
        ],
    ]
    
  • Capture Payment

    If capture is false while processing payment by processPayment function, then the payment is completed only after the Catpute API is called. This function completes the payment that was only authorized by processPayment. This function takes 2 arguments. TransactionId and the array of parameters.

    LinePay::verifyPayment($transactionId, $params);
    

    The array param for verifyPayment is described below:

    | Items | Datatype | Required | Description | Remarks | |---|---|:---:|---|---| | amount | numeric | Y | Payment Amount | Should match with the amount on Process Payment for the given transaction Id. | | currency| string (3byte) | Y | Payment Currency | Should match with Currency on Process Payment for the given transaction Id. Supported Languages are: - ja (Japanese) - ko (Korean) - en (English) (DEFAULT) - zh-Hans (Chinese Simplified) - zh-Hant (Chinese Traditional) - th (Thai)

    The response from the verify payment will be as below

    [
        'status' => 'success' or 'failed',
        'data' => [
            'request' => 'Params you send while calling the function (You may need to save it to log for future)',
            'response' => 'Array response (You may need to save it to log for future)',
        ],
    ]
    
    The response will be empty [] or as follows:
    [
        'returnCode' => '0000' (if success) or other code,
        'returnMessage' -> 'OK',
        'info' => [
            'orderId' => 'The order id',
            'transactionId' => 'Transaction Id eg: 12345678',
            'info' => [
                [
                    'method' => 'BALANCE',
                    'amount' => 10,
                ],
                [
                    'method' => 'DISCOUNT',
                    'amount' => 10,
                ],
            ],
        ],
    ]
    
  • Void Payment

    Voids a previously authorized payment. A payment that has been already captured can be refunded by this API

    LinePay::voidPayment($transactionId);
    

    The response from the void payment will be as below

    [
        'status' => 'success' or 'failed',
        'data' => [
            'request' => [],
            'response' => 'Array response (You may need to save it to log for future)',
        ],
    ]
    
    The response will be empty [] or as follows:
    [
        'statusCode' => '0000' (if success) or other code,
        'returnMessage' => 'OK',
    ]