---
title: "Refund a Money-In"
method: PUT
path: "/v2/refund/{transactionid}"
tags: ["Refunds"]
---

# Refund a Money-In

`PUT /v2/refund/{transactionid}`

## Request

- Base URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest`
- URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest/v2/refund/{transactionid}`
- Auth: none declared. Required headers: `Authorization`, `PSU-IP-Address`

**General Rules:**  

- A refund can **only** be made to the card holder's original used card, or the bank that made the initial payment.
- Lemonway reserves the right to retain the payment fee.
- If no refund amount is specified, the total amount is refunded.
- The original Client payment account is debited the refund. If insufficient funds are in the **Client Wallet**,
the outstanding refund amount will be debited from your **SC Wallet**. An ON-US payment is automatically performed from your **SC Wallet** to the **Client Wallet**, prior to the card refund.
- It is possible to cumulate refunds until the total amount is refunded.

**Card Payments:**

- Card payment refunds are not available from 22:00 and 03:00 (Central European Time - UTC/GMT+1 ).
- Refunds can only be made upto 12 months after the initial payment. 
 
**iDEAL:** Refunds are only available upto **99 days** after the initial payment.

## Path parameters

- `transactionid` integer, required

## Headers

- `Authorization` string, required
- `PSU-Accept-Language` string
- `PSU-IP-Address` string, required
- `PSU-User-Agent` string

## Request body

- RefundMoneyInInput
  - `amountToRefund` integer: Refund Amount. If empty, the total amount of the payment will be refunded.
  - `comment` string: Comment on the refund. **Explain the reason for the refunded amount** **Note:** In the API Response displayed before the comment will appear the refund transaction id. Example: comment": "Refund 2763789 Items not wanted"

## Response `200`

OK

- RefundMoneyInOutput
  - `transaction` TransactionRefund
    - `status` integer: 0: Success 4: Pending 6: PSP Error
    - `senderAccountId` string: Debited Account
    - `debitAmount` integer: Debited Amount Amounts are represented in cents (Euros)
    - `IbanId` integer: IBAN ID
    - `maskedLabel` string
    - `bankStatus` string
    - `PSP` PSP
      - `message` string: Get the Error Message from PSP
    - `originId` integer: Money-In - ID responsible for the chargeback
    - `buyNowPayLaterInfo` BnplInfo
      - `paymentPlanId` integer: Payment Plan ID
      - `type` string: Payment plan type.
      - `secondInstallmentPaymentDate` string: Second installment payment date. Format: yyyy-MM-dd
      - `deferredPaymentDate` string: Deferred payment date. Format: yyyy-MM-dd
    - `id` integer: Transaction ID
    - `method` integer: Payment Method 0 Card 1 Bank transfer (MoneyIn) 3 Bank transfer (MoneyOut) 4 P2P 13 iDEAL 14 SEPA DirectDebit 15 Cheque 19 Multibanco 21 MBWAY 30 BNPL 35 PayPal --- **Important:** The following services have been discontinued. 16 Neosurf 17 Sofort 18 PFS Physical Card 20 Payshop 22 Polish Instant Transfer 23 Pagare 24 MobilePay 25 Paytrail 26 WeChat 27 P24 28 MoneyIn by TPE 29 Trustly
    - `methodDetails` 0 | 1: Payment Method Details 0 Standard 1 Pay By Bank<br/>0 = STANDARD.<br/>1 = PAY_BY_BANK.<br/>
    - `date` integer: Transaction initialization date, UTC Unix timestamp
    - `commissionAmount` integer: Your fee Amounts are given as integer numbers in cents
    - `comment` string: Comment
    - `executionDate` integer: Transaction execution date
    - `lemonWayCommission` LemonWayCommission
      - `idp2p` string
      - `amount` integer: Amounts are represented as integer in cents (Euro) Represented as an integer in cents (Euro)
    - `reference` string: Unique ID generated by your server
  - `error` Error
    - `code` integer
    - `message` string
    - `psp` PSP
      - `message` string: Get the Error Message from PSP

## Other responses

- `401`: Unauthorized
- `500`: InternalServerError

---

[API](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0.md) - [All operations](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/revisions/82551a0a77b8?raw)