Create a Payment. When a user selects a payment method managed by Thunes, you must ask for a payment order to be created. We provide the PaymentOrder/Create web service for this purpose.

CALL Information / Examples

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

Request Example

{
  "PaymentOrder": {
    "MerchantId": "sandbox-merchantorpsp-fr",
    "PaymentPageId": "creditcard",
    "Amount": 100.0,
    "Currency": "EUR",
    "MerchantUrls": {
      "ReturnUrl": "http://www.citronrose.com/Payment_Return.aspx",
      "AbortedUrl": "http://www.citronrose.com/Payment_Cancelled.aspx",
      "ErrorUrl": "http://www.citronrose.com/Payment_Error.aspx",
      "ServerNotificationUrl": "http://www.citronrose.com/Payment_Notification.aspx"
    },
    "MerchantOrder": {
      "Id": "1257981",
      "Customer": {
        "Email": "[email protected]"
      }
    }
  }
}
<Request>
    <PaymentOrder>
        <MerchantId>sandbox-merchantorpsp-frr</MerchantId>
        <PaymentPageId>creditcard</PaymentPageId>
        <Amount>100.00</Amount>
        <Currency>EUR</Currency>
        <MerchantUrls>
            <ReturnUrl>http://www.citronrose.com/Payment_Return.aspx</ReturnUrl>
            <AbortedUrl>http://www.citronrose.com/Payment_Aborted.aspx</AbortedUrl>
            <ErrorUrl>http://www.citronrose.com/Payment_Error.aspx</ErrorUrl>
            <ServerNotificationUrl>http://www.citronrose.com/Payment_Notification.aspx</ServerNotificationUrl>
                </MerchantUrls>
        <MerchantOrder>
            <Id>1257981</Id>
            <Customer>
                <Email>[email protected]</Email>
            </Customer>
        </MerchantOrder>
    </PaymentOrder>
</Request>

Response Example

{
  "ReturnCode": 1000,
  "ReturnMessage": "Success",
  "RequestId": "1b07e7c6-0d92-4cc8-b500-75510acb49bf",
  "PaymentOrderId": 99972422011,
  "PaymentPageUrl": "https://payment.limonetikqualif.com/checkout?PaymentOrderid=99972422011"
}
<Response>
    <ReturnCode>1000</ReturnCode>
    <ReturnMessage>Success</ReturnMessage>
    <RequestId>1b07e7c6-0d92-4cc8-b500-75510acb49bf</RequestId>
    <PaymentOrderId>99972422011<PaymentOrderId>      
    <PaymentPageUrl>
        https://payment.limonetikqualif.com/checkout?PaymentOrderid=99972422011
    </PaymentPageUrl>
</Response>

Parameters in the request

🚧

Not to overload this first part, only the main fields have been shown here

... but there are others. Although they are not all required, we recommend filling in as many as possible. This ensures compatibility with as many payment methods as possible without further integration work. Please contact your Thunes specialist for further information on the fields required for each payment method.

To see other possible fields refer to this link

Parameter

Description

Comments

MerchantId

Your retailer identifier

Provided by Thunes

PaymentPageId

Payment method identifier

Provided by Thunes

Amount

Payment order amount

Use a decimal point and two decimal places, e.g. 100.00

Currency

Payment order currency

Codified as specified in ISO 4217.

ReturnUrl

URL to which our platform should redirect users if the authorisation request is confirmed

If you have not yet received server-to-server notification (or if you don't use it), you must check the status of the payment order via the PaymentOrder/Detail web service (WS) before confirming the order. This is for security reasons and because the order status may be Authorized or Authorizing, accordingly.

AbortedUrl

URL to which our platform should redirect users if they cancel their payment

We recommend using the payment method selection page to allow users to finalize their order using a different payment method.

ErrorUrl

URL to which our platform should redirect users if an error occurs in the payment flow

We recommend using the payment method selection page to allow users to finalize their order using a different payment method.

MerchantOrder

Object containing order information

Id

Your order identifier

We strongly recommend that you provide us with this identifier, which will then be visible in our BackOffice and may be used as search criteria.

Email

Customer's email address

This address may be used:

  • to pre-complete the corresponding field on the payment page (if appropriate).
  • to send further payment information to the customer.

RawCustom1

Free text field

May be used during the integration phase to simulate behaviour.

Response

Parameter

Description

Comments

PaymentOrderId

Unique payment order identifier on our platform

Make note of this identifier for performing other operations on the payment order.

PaymentPageUrl

URL of the payment page

Redirect the user to this page (HTTP 302) to make his or her payment.