Once a payment order is Authorized, you may charge all or part of the payment order. To do this, enter the amount you wish to charge as a parameter in the PaymentOrder/Charge web service. To charge for the entire order, enter the full amount.

CALL Information / Examples

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

Request Example

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

Response Example

{
  "OperationId": 875213654782,
  "RequestId": "1b07e7c6-0d92-4cc8-b500-75510acb49bf",
  "ReturnCode": 1000,
  "ReturnMessage": "Success"
}
<Response>
    <OperationId>875213654782</OperationId> 
    <RequestId>1b07e7c6-0d92-4cc8-b500-75510acb49bf</RequestId>
    <ReturnCode>1000</ReturnCode>
    <ReturnMessage>Success</ReturnMessage>   
</Response>

Parameters in the request

🚧

As specified above, charges can only be guaranteed within a certain period, which varies depending on the payment method. Before shipping the order, check that PaymentOrder/Charge returns a code indicating a successful result.

ParameterDescriptionComments
PaymentOrderIdThunes payment order identifierCorresponds to the PaymentOrderId parameter returned when the payment order was created.
ChargeAmountAmount to be chargedThis amount must be less than or equal to the total order amount (minus any amounts that may already have been charged or cancelled).
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 accordingly. This amount needs to be added into the PaymentOrder/Charge request.

Specific parameters for fees

ParameterDescriptionComments
IdIdentifier of the fee configured in Thunes Collections BackOfficeThis identifier enables us to locate the Marketplace account to credit with fee (amount field below).
AmountAmount of fee. Currency is the same as charge request.This amount could be more as charge amount if the total amount captured permit it. In the reverse case, charge request could be refused.