Amounts charged can be refunded using the PaymentOrder/Refund web service. Enter the refund amount as a parameter. To refund the entire payment, enter the full amount.

CALL Information / Examples

API Call
POST https://api.limonetikqualif.com/Rest/V40/PaymentOrder/Refund

Request Example

{
  "PaymentOrderId": "99972422011",
  "RefundAmount": 70.00,
  "Currency": "EUR"
}
{
  "PaymentOrderId": "99972422011",
  "RefundAmount": 70.00,
  "Currency": "EUR",
  "Fees": [
    {
      "Id":"Marketplace-Fees",
      "Amount":7.00
    }
  ]
}
<Request>
  <PaymentOrderId>99972422011</PaymentOrderId>
  <RefundAmount>70.00</RefundAmount>
  <Currency>EUR</Currency>
</Request>
<Request>
  <PaymentOrderId>99972422011</PaymentOrderId>
  <RefundAmount>70.00</RefundAmount>
  <Currency>EUR</Currency>
  <Fees>
    <Fee>
      <Id>Marketplace-Fees</Id>
      <Amount>7.00</Amount>
    </Fee>
  </Fees>
</Request>

Response Example

{
  "OperationId": 651913651532,
  "RequestId": "9543fd33-b78a-4a05-98e6-58000f80bcae",
  "ReturnCode": 1000,
  "ReturnMessage": "Success"
}
<Response>
    <OperationId>651913651532</OperationId>  
    <RequestId>9543fd33-b78a-4a05-98e6-58000f80bcae</RequestId>
    <ReturnCode>1000</ReturnCode>
    <ReturnMessage>Success</ReturnMessage>  
</Response>

Parameters in the request

ParameterDescriptionComments
PaymentOrderIdThunes payment order identifierCorresponds to the PaymentOrderId parameter returned when the payment order was created.
RefundAmountAmount to be refundedThis amount must be less than or equal to the total order amount (minus any amounts that may already have been refunded).
Use a decimal point and two decimal places, e.g. 70.00
CurrencyPayment order currencyCodified as specified in ISO 4217.

Response

ParameterDescriptionComments
OperationIdOperation identifier

Marketplace - Specific parameters for fees

If you are a merchant or Marketplace affiliate, you can set a fee amount to refund. This amount needs to be added into the PaymentOrder/Refund request.

❗️

Available depending on the configuration

Specific parameters for fees

ParameterDescriptionComments
IdIdentifier of the fee configured in Thunes Collections BackOffice. (same fee used for the charge)This identifier enables us to locate the right Marketplace accounts (amount field below).
AmountAmount of fee. Currency is the same as in the charge request.The amount have to be lower than the fee amount on the charge