付款請求

使用輸入的付款訊息向LINE Pay伺服器請求付款。設定付款訊息中，顧客需付款的訂單訊息和付款方式。如果付款請求處理順利，顧客將被引導至LINE Pay認證畫面。

另外，回應該API會發出一個交易ID，可用於請求付款授權、取消授權和請款、退款。

POST /v3/payments/request

請將Read逾時設定為至少10秒以上。

Request

Response

Path

None

Query

None

Body

Name	Type	Length	Description
`amount`	number		付款金額。這是整個套裝產品的購買金額(`packages[].amount`)和手續費(`packages[].userFee`)的合計金額。
`currency`	string	3	付款貨幣代碼(ISO 4217)。支援貨幣代碼如下。 `"USD"` `"TWD"` `"THB"`
`options`	object		付款請求設定訊息
`orderId`	string	100	訂單號碼。輸入商家生成的用於管理訂單的ID。
`packages[]`	object array		以配送或商店區分的套裝產品訊息
`redirectUrls`	object		用於後處理付款請求的URL資訊

Headers

Content-Type
X-LINE-Authorization
X-LINE-Authorization-Nonce
X-LINE-ChannelId
X-LINE-MerchantDeviceProfileId

詳細內容請參閱請求標頭。

Request examples

一般付款請求

分開請款時的主體

預先授權付款時的主體

未提供confirmURL時的主體

curl -X POST \
     -H "Content-Type: application/json" \
     -H "X-LINE-ChannelId: YOUR_CHANNEL_ID" \
     -H "X-LINE-Authorization-Nonce: GENERATED_NONCE" \
     -H "X-LINE-Authorization: PROCESSED_SIGNATURE" \
     -H "X-LINE-MerchantDeviceProfileId: YOUR_DEVICE_PROFILE_ID" \
     -d '{
          "amount" : 100,
          "currency" : "TWD",
          "orderId" : "MKSI_S_20180904_1000001",
          "packages" : [
            {
              "id" : "1",
              "amount": 100,
              "products" : [
                {
                  "id" : "PEN-B-001",
                  "name" : "Pen Brown",
                  "imageUrl" : "https://pay-store.example.com/images/pen_brown.jpg",
                  "quantity" : 2,
                  "price" : 50
                }
              ]
            }
          ],
          "redirectUrls" : {
            "confirmUrl" : "https://pay-store.example.com/order/payment/authorize",
            "cancelUrl" : "https://pay-store.example.com/order/payment/cancel"
          }
        }'
     https://sandbox-api-pay.line.me/v3/payments/request

Name	Type	Description
`info`	Object	結果訊息
`returnCode`	String	結果程式碼。API呼叫成功時，傳回`0000`值。其他結果碼均為錯誤碼，更多訊息請參考結果程式碼。
`returnMessage`	String	結果訊息。結果訊息請參閱結果程式碼。