進行退款交易

POST

/v2/invoices/{invoice_no}/refund

使用時機為成功向用戶請款後，要求麻吉雲將款項退給用戶。麻吉雲收到退款要求後會盡快將款項退回用戶原付款通路，但每日 21:00 後進行的退款可能會延遲到隔天才處理；超過 2 個月的款項將無法退款。

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

退款請求已受理（原文件標示 Status 201 / Meaning「OK」，維持原文標示）

Bodyapplication/json

🟠422

🟠4XX

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/invoices//refund' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "refund_reason": "string"
}'

Response Example

201 - Example 1

{
    "id": "string",
    "state": "waiting",
    "payment_state": "pending",
    "plate_number": "string",
    "invoice_no": "string",
    "transaction_type": "string",
    "item_amount": "string",
    "request_description": "string",
    "discount_amount": "string",
    "amount": "string",
    "paid_at": "2019-08-24T14:15:22.123Z",
    "expires_in": 0,
    "refund_state": "no_refund",
    "refund_reason": "string",
    "refunded_at": "2019-08-24T14:15:22.123Z",
    "callback_url": "http://example.com",
    "payment_url": "http://example.com",
    "payment_method": "credit_card"
}

Modified at 2026-09-10 01:52:45

取消請款交易

確認服務狀態