Linepay on Quietbo

[Python] LinePay串接Online APIs – 問題 (5/5)

Mon, 14 Mar 2022 05:44:59 +0000

linepay v2 的Payment-check api 在LINE Pay: Overview這邊找到的,僅供測試用。
建議開發使用新的版本，目前v3。

[Python] LinePay串接Online APIs – 串接v3(含code) (4/5)

Mon, 14 Mar 2022 05:38:31 +0000

以下測試環境及工具使用:

windows 10
Sandbox
linePay文檔
python 3.7

以下使用Request API-> Check Payment Status API -> Confirm API。

操作流程如下:

channel_id 填入自己的channel id
channel_secret 填入自己的channel secret
開啟瀏覽器貼上付款web_url
付款成功後將最下方的transaction_id填上
重新運行

import time
import json
import requests
import hashlib
import hmac
import base64


def get_auth_signature (secret, uri, body, nonce):
 """
 用於製作密鑰
 :param secret: your channel secret
 :param uri: uri
 :param body: request body
 :param nonce: uuid or timestamp(時間戳)
 :return:
 """
 str_sign = secret + uri + body + nonce
 return base64.b64encode(hmac.new(str.encode(secret), str.encode(str_sign), digestmod=hashlib.sha256).digest()).decode("utf-8")

channel_id = "your channel id"
channel_secret = "your channel secret"
uri = "/v3/payments/request"
nonce = str(round(time.time() * 1000)) # nonce = str(uuid.uuid4())
transaction_id = ''

headers = {
 'Content-Type': 'application/json',
 'X-LINE-ChannelId': channel_id,
 'X-LINE-Authorization-Nonce': nonce,
}

def do_request_payment():
 '''此api僅使用文檔中必填的資料'''
 request_options = {
 "amount": 2000,
 "currency": 'TWD',
 "orderId": nonce,
 "packages": [{
 "id": '20220314I001',
 "amount": 2000,
 "name": '鬼滅之刃公仔',
 "products": [{
 "name": '竈門禰豆子',
 "quantity": 1,
 "price": 1000
 },{
 "name": '我妻善逸',
 "quantity": 1,
 "price": 1000
 }]
 }],
 "redirectUrls": {
 "confirmUrl": 'https://quietbo.com/2022/03/14/python-linepay%e4%b8%b2%e6%8e%a5online-apis-%e5%95%8f%e9%a1%8c-5-5/',
 "cancelUrl": 'https://fastapi.tiangolo.com/zh/tutorial/bigger-applications/'
 }
 }
 json_body = json.dumps(request_options)


 headers['X-LINE-Authorization-Nonce'] = nonce
 headers['X-LINE-Authorization'] = get_auth_signature(channel_secret, uri, json_body, nonce)
 response = requests.post("https://sandbox-api-pay.line.me"+uri, headers=headers, data=json_body)
 print(response.text)
 dict_response = json.loads(response.text)

 if dict_response.get('returnCode') == "0000":
 info = dict_response.get('info')
 web_url = info.get('paymentUrl').get('web')
 transaction_id = str(info.get('transactionId'))
 print(f"付款web_url:{web_url}")
 print(f"交易序號:{transaction_id}")

def do_checkout(transaction_id):
 print("transaction_id={}".format(transaction_id))

 conf_data = """{"amount": 2000, "currency": "TWD"}"""
 checkout_url = f"/v3/payments/requests/{transaction_id}/check"
 headers['X-LINE-Authorization'] = get_auth_signature(channel_secret, checkout_url, conf_data, nonce)
 response = requests.get("https://sandbox-api-pay.line.me"+checkout_url, headers=headers, data=conf_data)
 print(response.text)
 response = json.loads(response.text)
 if str(response.get('returnCode')) == "0110":
 return True
 return False

def do_confirm(transaction_id):

 con_url = f"/v3/payments/{transaction_id}/confirm"
 conf_data = """{"amount": 2000, "currency": "TWD"}"""
 headers['X-LINE-Authorization'] = get_auth_signature(channel_secret, con_url, conf_data, nonce)
 response = requests.post("https://sandbox-api-pay.line.me"+con_url, headers=headers, data=conf_data)
 print(response.text)
 response = json.loads(response.text)

 return response.get('returnMessage')

if __name__ == "__main__":
 do_request_payment() # 向linepay請求付款

 # 填入已付款後的交易序號後下方註解拿掉
 # transaction_id = "your transaction_id" # ex: transaction_id = 2022031400707390210
 # status = do_checkout(transaction_id) # 檢查訂單狀態
 # if status == True:
 # print(do_confirm(transaction_id)) # 確認訂單

[Python] LinePay串接Online APIs – 後台查看 (3/5)

Sun, 13 Mar 2022 17:23:22 +0000

linepay測試用後台

登入後找右上角的「測試環境」

右上角可將語言轉成繁體中文

左方管理交易->交易紀錄，可以查看到之前的交易紀錄:

[Python] LinePay串接Online APIs – 初步了解流程及使用postman測試api v2 (2/5)

Sun, 13 Mar 2022 17:22:34 +0000

因有些人只想了解linepay的運作方式, 提供一些簡單可使用的方式。

以下測試環境及工具使用:

Sandbox
postman
linePay文檔
Online APIs 文檔:網址
按下此處查看以前的API文件(v2)

本次postman的簡易流程
簡易流程圖網址

Table of Contents

<span class="ez-toc-title-toggle"><a href="#" class="ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle" aria-label="顯示/隱藏內容目錄"><span class="ez-toc-js-icon-con"><span class=""><span class="eztoc-hide" style="display:none;">Toggle</span><span class="ez-toc-icon-toggle-span"><svg style="fill: #999;color:#999" xmlns="http://www.w3.org/2000/svg" class="list-377408" width="20px" height="20px" viewBox="0 0 24 24" fill="none"><path d="M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z" fill="currentColor"></path></svg><svg style="fill: #999;color:#999" class="arrow-unsorted-368013" xmlns="http://www.w3.org/2000/svg" width="10px" height="10px" viewBox="0 0 24 24" version="1.2" baseProfile="tiny"><path d="M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z"/></svg></span></span></span></a></span>

基本設定

請先下載postman

domain(v2測試用)

https://sandbox-api-pay.line.me/v2/payments

在現有的Headers添加

Content-Type:application/json
X-LINE-ChannelId:商戶的Channel ID
X-LINE-ChannelSecret:商戶的Channel Secret

request 請求訂單

API:

POST {domain}/request

Request Body:

{
 "amount": 1,
 "currency": "TWD", 
 "productName": "MyProd",
 "productImageUrl": "https://cimg.cnyes.cool/prod/news/4556115/l/79b7b76238dcaa28d626ec007bff576f.jpg",
 "confirmUrl": "http://127.0.0.1:3000",
 "orderId": "Order202203110011"
}

Payment Reserve Response:

{
 "returnCode": "0000",
 "returnMessage": "Success.",
 "info": {
 "paymentUrl": {
 "web": "https://sandbox-web-pay.line.me/web/payment/wait?transactionReserveId=WVZub2tRakxRbzk0NWVsa1VMZ1pyTzhOSk00QXJqNXgvbTZIeXZ2NklpL2ZiMHlBUGN4SnJrTG4xVWh6bFA1cg",
 "app": "line://pay/payment/WVZub2tRakxRbzk0NWVsa1VMZ1pyTzhOSk00QXJqNXgvbTZIeXZ2NklpL2ZiMHlBUGN4SnJrTG4xVWh6bFA1cg"
 },
 "transactionId": 2022031100707222710,
 "paymentAccessToken": "785453599850"
 }
}

取得info.paymentUrl.web後, 使用瀏覽器打開如下:

點擊付款:

付款成功如下:

補充:
為什麼結帳後會原本的網頁會出現下圖?

文檔內的說明如下

Merchant's URL that the buyer is redirected to after selecting a payment method and entering the payment password in LINE Pay.
On the redirected URL, Merchant can call Confirm Payment API and complete the payment
LINE Pay passes an additional parameter, "transactionId"

Reference Detailed Explanation and Exceptional Case of ConfirmUrl

簡單來說就是:想讓結帳完的顧客看到什麼畫面。

confirm 確認

API:

POST {domain}/{transactionId}/confirm

範例:

https://sandbox-api-pay.line.me/v2/payments/2022031400707322810/confirm

Headers添加

X-LINE-MerchantDeviceType: POS
X-LINE-MerchantDeviceProfileId: DUMMY

Request Body:

{
 "amount": 1,
 "currency": "TWD"
}

Response成功的Json如下:
(補充:此次訂單是重新發起的新的訂單,所以transactionId與orderId會與上面請求訂單時的資料不一樣, 主要目的是呈現成功的結果)

{
 "returnCode": "0000",
 "returnMessage": "Success.",
 "info": {
 "transactionId": 2022031400707322810,
 "orderId": "dev202203140002",
 "payInfo": [
 {
 "method": "CREDIT_CARD",
 "amount": 1,
 "maskedCreditCardNumber": "************1111"
 }
 ]
 }
}

若失敗或是orderId有重複, 則會告知錯誤。

Check Payment Status 查看訂單狀態

API

GET {domain}?transactionId={transactionId}

範例:

https://sandbox-api-pay.line.me/v2/payments?transactionId=2022031400707322810

Response成功的Json如下:

{
 "returnCode": "0000",
 "returnMessage": "Success.",
 "info": [
 {
 "transactionId": 2022031400707322810,
 "transactionDate": "2022-03-13T16:11:08Z",
 "transactionType": "PAYMENT",
 "productName": "MyProd",
 "currency": "TWD",
 "payInfo": [
 {
 "method": "CREDIT_CARD",
 "amount": 1
 }
 ],
 "orderId": "dev202203140002"
 }
 ]
}

注意:
正常來說是要先檢查是否付款後才執行confirm這支API，但因為v2是需要先進行confirm這支API才有辦法使用，否則會出現:

{
 "returnCode": "1150",
 "returnMessage": "Transaction record not found."
}

若是使用v3則可正常先進行Check Payment Status 後再進行確認。

refurnd 退款

取消已付款的交易。

API:

POST {dimain}/{transactionId}/refund

Headers添加

X-LINE-MerchantDeviceType: POS
X-LINE-MerchantDeviceProfileId: DUMMY

refundAmount: 退款金額

{
 "refundAmount": 1
}

Response:

{
 "returnCode": "0000",
 "returnMessage": "Success.",
 "info": {
 "refundTransactionId": 2022031400707327211,
 "refundTransactionDate": "2022-03-13T17:05:50Z"
 }
}

[Python] LinePay串接Online APIs – 申請測試帳號 (1/5)

Sun, 13 Mar 2022 17:17:51 +0000

以下測試環境使用:

Sandbox

一、創建Sandbox帳號

測試流程文件網址

LinePay建立Sandbox:Sandbox網址
正式LinePay商戶請使用:網址

填入下方訊息, 及使用中的信箱, 此處我是使用與line相同的信箱，若是以有相同信箱會跳出:此email已註冊過Sandbox ID。請輸入其他email以註冊Sandbox。

創建成功如下圖(有興趣可自行點擊後查看)

二、收信並登入商家

到信箱收信如下:

使用剛才收到的來登入Merchant Center:網址

使用收到的測試帳號及密碼登入

三、取得Channel ID及Channel Secret Key

紅框內的要保留好, 不要外流。

補充:

Sandbox: 指測試帳號的url及後台等等環境
v2/v3指的是在串接api時的linepay版本