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