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.

Parameter

Description

Comments

PaymentOrderId

Thunes payment order identifier

Corresponds to the PaymentOrderId parameter returned when the payment order was created.

ChargeAmount

Amount to be charged

This 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

Currency

Payment order currency

Codified as specified in ISO 4217.

Response

Parameter

Description

Comments

OperationId

Operation 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

Parameter

Description

Comments

Id

Identifier of the fee configured in Thunes Collections BackOffice

This identifier enables us to locate the Marketplace account to credit with fee (amount field below).

Amount

Amount 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.