When you want to make a payment for a user that have already given his credentials before, you have the PaymentOrder/Pay webservice. For example, it's used in the context of card registration or in the recurring payment.
CALL Information / Examples
API Call
POST https://api.limonetikqualif.com/Rest/V40/PaymentOrder/Pay
Request Example
{
"PaymentOrder": {
"MerchantId": "sandbox-mktpl-vendor1-fr",
"Amount": 100.0,
"Currency": "EUR",
"PaymentPageId": "creditcard",
"MerchantUrls": {
"ServerNotificationUrl": "http://www.citronrose.com/Payment_Notification.aspx"
},
"MerchantOrder": {
"Id": "1257981",
"Customer": {
"Email": "[email protected]"
}
}
},
"Credentials": [
{
"name": "technicalTransactionId",
"credential": "99972422011"
}
]
}
{
"PaymentOrder": {
"MerchantId": "sandbox-cashregisterorpos-fr",
"Amount": 100.0,
"Currency": "EUR",
"PaymentPageId": "QRCode",
"MerchantUrls": {
"ServerNotificationUrl": "http://www.citronrose.com/Payment_Notification.aspx"
},
"MerchantOrder": {
"Id": "1257981",
"Customer": {
"Email": "[email protected]"
}
}
},
"Credentials": [
{
"name": "qrcode",
"credential": "288888888888888888888888"
}
]
}
{
"PaymentOrder": {
"MerchantId": "sandbox-merchantorpsp-fr",
"Amount": 100.0,
"Currency": "EUR",
"PaymentPageId": "creditcard",
"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]"
}
}
},
"Credentials": [
{
"name": "CardNumber",
"credential": "5017670000001800"
},
{
"name": "Cvv",
"credential": "123"
},
{
"name": "Exp",
"credential": "202012"
}
]
}
<Request>
<PaymentOrder>
<MerchantId>sandbox-mktpl-vendor1-fr</MerchantId>
<Amount>100.00</Amount>
<Currency>EUR</Currency>
<PaymentPageId>creditcard</PaymentPageId>
<MerchantUrls>
<ServerNotificationUrl>https://www.citronrose.com/Payment_Notification.aspx</ ServerNotificationUrl>
</MerchantUrls>
<MerchantOrder>
<Id>1257981</Id>
<Customer>
<Email>[email protected]</Email>
</Customer>
</MerchantOrder>
</PaymentOrder>
<Credentials>
<Credential name="technicalTransactionId">99972422011</Credential>
</Credentials>
</Request>
<Request>
<PaymentOrder>
<MerchantId>sandbox-cashregisterorpos-fr</MerchantId>
<Amount>100.00</Amount>
<Currency>EUR</Currency>
<PaymentPageId>creditcard</PaymentPageId>
<MerchantUrls>
<ServerNotificationUrl>https://www.citronrose.com/Payment_Notification.aspx</ ServerNotificationUrl>
</MerchantUrls>
<MerchantOrder>
<Id>1257981</Id>
<Customer>
<Email>[email protected]</Email>
</Customer>
</MerchantOrder>
</PaymentOrder>
<Credentials>
<Credential name="qrcode">288888888888888888888888</Credential>
</Credentials>
</Request>
<Request>
<PaymentOrder>
<MerchantId>sandbox-merchantorpsp-fr</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_Cancelled.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>
<Credentials>
<Credential name="CardNumber">5017670000001800</Credential>
<Credential name="Cvv">123</Credential>
<Credential name="Exp">202012</Credential>
</Credentials>
</Request>
Response Example
{
"PaymentOrderId": 58964166312,
"Status": "Authorized",
"RequestId": "db1507a2-425e-43e9-9ba0-18e87bccf750",
"ReturnCode": 1000,
"ReturnMessage": "Success"
}
<Response>
<ReturnCode>1000</ReturnCode>
<ReturnMessage>Success</ReturnMessage>
<RequestId>db1507a2-425e-43e9-9ba0-18e87bccf750</RequestId>
<PaymentOrderId>58964166312<PaymentOrderId>
<Status>Authorized</Status>
</Response>
Parameters in the request
| Parameters | Description | Comments |
|---|---|---|
| Credentials | List of object related to the buyer payment information | Several information can be necessary. It's important to use unique names. |
| Credential.name | Name of the payment information | Defined depending the payment method |
| Credential | Value of the payment information |
Other fields of this example have already been described before in the Create webservice. There are lot of other fields available (like in the Create webservice)
Response
| Parameters | Description | Comments |
|---|---|---|
| PaymentOrderId | Identifier of the payment order | You need to keep yhis id to do other operations on the payment order |