取消授權

取消已授權的付款。呼叫該API時，可透過分開付款授權和請款請求付款，取消已授權付款。請款後，完成付款，則無法透過端點取消，需進行退款處理。

POST /v2/payments/orders/{orderId}/void

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

Request

Response

Path

Name	Length	Description	Required
`orderId`	100	訂單號碼。輸入商家生成的用於管理訂單的ID。輸入時套用URL編碼。

Query

None

Body

None

Headers

Content-Type
X-LINE-ChannelId
X-LINE-ChannelSecret
X-LINE-MerchantDeviceProfileId
X-LINE-MerchantDeviceType

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

Request examples

bash

curl -X POST \
     -H "Content-Type: application/json" \
     -H "X-LINE-ChannelId: YOUR_CHANNEL_ID" \
     -H "X-LINE-ChannelSecret: YOUR_CHANNEL_SECRET" \
     -H "X-LINE-MerchantDeviceProfileId: YOUR_DEVICE_PROFILE_ID" \
     https://sandbox-api-pay.line.me/v2/payments/orders/merchant_test_order_1/void

Name	Type	Description	Included
`returnCode`	String	結果程式碼。API呼叫成功時，傳回`0000`值。其他結果碼均為錯誤碼，詳細內容請參閱結果程式碼。
`returnMessage`	String	結果訊息。結果訊息請參閱結果程式碼。