RefundMoneyIn
The general rules are:
- The refund can only be performed on the card or bank account that did the initial payment
- Lemonway keeps the payment fee
- If no amount is specified, the total amount of the payment is refunded
- The wallet of the client on which the initial payment was done is debited of the refund amount. If there is not enough money on the Client Wallet, the missing amount of money to refund will be debited from your SC Wallet. In this case, a ON-US payment is automatically performed from your SC Wallet to the Client Wallet, prior to refund the card.
- With version 1.1, it is possible to cumulate refunds and ask for many refunds until the total amount of the payment is refunded.
Card Payments:
- RefundMoneyIn for a card payment with Atos is not available from 10 PM to 3 AM (CET)
- Refund is only available/possible for 12 months after the initial payment
- Please be aware of controls performed by Visa and Mastercard on the percentage of refunds. Refunds should never be greater than 10%. If you think you will have more than 10% of refunds, please contact us and our management will find a solution for you. The solution may be to refund using a fund transfer on the IBAN of the owner, not on his card.
Version | Description |
|---|---|
1.0 | |
1.1 | Add one entry variable to indicate the amount to refund, smaller or equal to the amount paid with the card. |
1.2 | Output: Returns the refund operation amount and not the initial payment operation |
| 1.3 | Output: Return a status for the refund. (Pending, Success, Error) |
How it works
RefundMoneyIn allows you to refund money-in operations made using:
- Card (Citelis, Atos, Payxpert)
- iDeal
- Sofort
- PayTrail
- Trustly
Request
XML
<RefundMoneyIn xmlns="Service_mb">
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<transactionId>string</transactionId>
<amountToRefund>string</amountToRefund> <!-- since version 1.1 -->
<comment>string</comment>
</RefundMoneyIn>
JSON
{
"wlLogin":"string",
"wlPass":"string",
"language":"string",
"version":"string",
"walletIp":"string",
"walletUa":"string",
"transactionId":"string",
"amountToRefund":"string",
"comment":"string"
}
Version | Item | Description | Mandatory | Format | Example |
|---|---|---|---|---|---|
>= 1.0 | transactionId | Money-in ID to refund | Yes | [0 : 10] char | 176 |
>= 1.0 | comment | Comment regarding the refund. Please explain why you refund | No | [0 :140] char | Total Refund of last payment and stop rebill after the refund and closed account and wallet. |
>= 1.1 | amountToRefund | Amount to refund. If empty, the total amount of the payment will be refunded. | No | 2 decimals | 15.00 |
Answer
XML
<?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<STATUS> string</STATUS>
</HPAY>
</TRANS>
JSON
{
"TRANS":{
"HPAY":{
"ID":"string",
"DATE":" string ",
"SEN":" string ",
"REC":" string ",
"DEB":" string ",
"CRED":" string ",
"COM":" string ",
"STATUS":" string"
}
}
}
Until version 1.1
Item | Description | Example |
|---|---|---|
ID | Refund ID | 255 |
DATE | Date of canceled money-in | 10/09/2011 18:09:27 |
SEN | Empty in this case | |
REC | Wallet credited initially | Pizza56 |
DEB | 0 in this case | 0.00 |
CRED | The amount credited to the wallet when initializing the payment | 15.00 |
COM | Partners' fees. | 0.00 |
STATUS | Not used by your kit |
From version 1.2
Item | Description | Example |
|---|---|---|
ID | Refund ID | 255 |
DATE | Refund transaction Date | 10/09/2011 18:09:27 |
SEN | A wallet that was debited | Pizza56 |
REC | Empty in this case | |
DEB | Refund amount | 15.00 |
CRED | 0 in this case | 0.00 |
COM | Your fee. | 0.00 |
| STATUS | 3: money-in successful 4: error 0: waiting for finalization | 3 |
INT_STATUS | 0: Success 4: Pending 6: PSP Error | 0 |