預先授權付款請求

使用已簽發預先授權付款密鑰向LINE Pay伺服器請求預先授權付款。

POST /v3/payments/preapprovedPay/{regKey}/payment

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

Request

Response

Path

Name	Description	Required
`regKey`	已簽發的預先授權付款密鑰

Query

None

Body

Name	Type	Length	Description
`amount`	number		付款金額
`capture`	boolean		是否自動請款。處理預先授權付款時，決定同時處理或分開處理。預設值為`true`。 `true`: 同時處理。 `false`: 分開處理。
`currency`	string	3	付款貨幣代碼(ISO 4217)。支援貨幣代碼如下。 `"USD"` `"TWD"` `"THB"`
`orderId`	string	100	訂單號碼。輸入商家生成的用於管理訂單的ID。
`productName`	string	4000	產品名稱

Headers

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

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

Request examples

bash

curl -X POST \
     -H "Content-Type: application/json" \
     -H "X-LINE-ChannelId: YOUR_CHANNEL_ID" \
     -H "X-LINE-Authorize-Nonce: 6120489b-53f3-4c51-9d6f-b80be93e509a"\
     -H "X-LINE-Authorization: PROCESSED_SIGNATURE" \
     -H "X-LINE-MerchantDeviceProfileId: YOUR_DEVICE_PROFILE_ID" \
     -d '{
          "productName": "Brown pen",
          "amount": 1000,
          "currency": "TWD",
          "orderId": "Ord2018123100000001"
        }' \
     https://sandbox-api-pay.line.me/v3/payments/preapprovedPay/RK123asd213/payment

Name	Type	Length	Description
`info`	Object		結果訊息
`returnCode`	String	4	結果程式碼。API呼叫成功時，傳回`0000`代碼。其他結果碼為錯誤碼，如果回傳`1141`, `1282`-`1287`, `1290`-`1295`代碼，逾期處理預先授權付款密鑰。詳細內容請參閱結果程式碼。
`returnMessage`	String		結果訊息。結果訊息請參閱結果程式碼。