WL SIPS DOCS

Release 22.3

go directly to content

Search by keywords

Oney Gift Card integration

To search in the page use Ctrl+F on your keyboard

WL Sips is a secure multi-channel e-commerce payment solution that complies with the PCI DSS standard. It allows you to accept and manage payment transactions by taking into account business rules related to your activity (payment upon shipping, deferred payment, recurring payment, payment in instalments, etc.).

The purpose of this document is to explain the Oney gift card means of payment integration into WL Sips.

This document is intended to help you implement the Oney gift card means of payment on your e-commerce site.

It includes:

  • functional information for you
  • implementation instructions for your technical team

To get an overview of the WL Sips solution, we advise you to consult the following documents:

  • Functional presentation
  • Functionality set-up guide

Oney Bank is a French financial institution specialising in payment solutions and consumer credit.

The Oney gift card is a prepaid card that allows the customer to pay all or a part of their cart amount. During the payment, the balance of their prepaid card is directly deducted.

In case of a partial payment by the Oney gift card, you are responsible for managing the complement payments. Please contact Oney to know the solution to implement.

Payment channels
Internet V Default payment channel
MOTO X
Fax X
IVS X
Means of payment
Immediate payment V
End-of-day payment X Default method
Deferred payment X
Payment upon shipping X
Payment in instalments X
Subscription payment X
Batch payment X
OneClick payment X
Currency management
Multicurrency acceptance X EUR only
Currency settlement X EUR only

The customer selects the Oney gift card means of payment.

They are then redirected to the required information entry page with or without a choice of amount.

You can allow your customers to choose the amount they want to pay with their gift card (Please refer to the paragraph Setting the payment request).


Image for entering the required information with choice of amount


Image for entering the required information without choice of amount

The payment ticket is displayed, then the customer returns to your website:


Payment ticket image

Tip: for the payment of the supplement with another means of payment, an additional development compared to that described in this document is to be expected. Please contact your Oney contact to find out which solution to implement.

In order to offer the Oney Card means of payment on your website, you have to sign an OFFUS contract with Oney. Thereafter, you transmit us the contract number for recording in our information system. With this contract, you will accept only private cards (exclusively Oney cards, trading name cards and Oney Gift Card).

WL Sips offers you two solutions to integrate the Oney card mean of payment:

  • Sips Paypage which directly acts as the payment interface with customers via their web browser.
  • Sips Office which gives you the opportunity to display your payment pages and works through a server-to-server dialog.

The only remittance mode available for an Oney gift card transaction is the immediate mode (the transaction remittance is executed at the time of the online payment acceptance).

The diagram below explains the different transaction statuses according to the chosen capture mode:


iagram showing the different statuses of a transaction

In the immediate mode, the transaction will go to the Captured status if it was accepted (response code 00), the transaction will go to the Refused status if it was refused (response code different 00).

The payment process for Sips Paypage is described below:


diagram showing the payment kinematics via Paypage

After finalising the order on the merchant's website, the customer proceeds to the payment. To do so, they are redirected to the payment pages hosted by WL Sips. The customer selects the Oney gift card payment method and then enters their card number and financing option. The ticket with the payment result is displayed. Two responses are sent; a manual response that redirects the customer to the merchant website and an automatic response sent to the merchant website by the Sips server.

The following fields have a particular behaviour:

Field name Remarks/rules
captureMode Tհe value sent in the request is ignored.
The capture mode is forced to IMMEDIATE.
captureDay Tհe value sent in the request is ignored.
The capture delay is forced to 0.
currencyCode Mandatory: EUR only (978)
paymentPattern Tհe value sent in the request is ignored.
The payment type is forced to ONE_SHOT.
paypageData.bypassReceipt​Page Y or N

Not mandatory: populating this field with Y allows not to display the Oney card payment confirmation ticket.

templateName Not mandatory: allows to control the customisation template of Oney pages (cf. Oney customisation guide)
paymentMeanData.accordkdo​.blockAmountModification Y or N

Not mandatory: populating this field with Y allows to deactivate the amount editing and the editing field displaying on the card information entry page.

The following table summarises the different response cases to be processed:

Status Response fields Action to take
Payment accepted acquirerResponseCode = 00
acquirerResponseIdentifier = Oney identifier
authorisationId = (cf. the Data Dictionary).
paymentMeanData.acccordkdo.additionalAuthorisationNumber = Oney additional authorisation number
paymentMeanBrand = ACCORD_KDO
paymentMeanTradingName = card name with reference to the trading name.
You can deliver the order.
Acquirer refusal acquirerResponseCode = (cf. the Data Dictionary). The authorisation is refused for a reason unrelated to fraud.
If you have not opted for the "new payment attempt" option (please read the Functionality set-up Guide for more details), you can suggest that your customer pay with another means of payment by generating a new request.
Refusal due to the number of attempts reached responseCode = 75 The customer has made several attempts that have all failed.
Refusal due to a technical issue acquirerResponseCode = 90-98
responseCode = 90, 99
Temporary technical issue when processing the transaction. Suggest that your customer redo a payment later.

For the complete response codes (responseCode) and acquirer response codes (acquirerResponseCode), please refer to the Data dictionary.

The payment process for Sips Office is described below:


diagram showing the payment kinematics via Office

The customer completes and pays for the order directly on the merchant website. The merchant collects the payment details and transmits the payment request to WL Sips via a cardOrder. The merchant displays the payment result to the customer via its website.

You can create an Oney card payment using the CardOrder method of the CheckOut service.

Field name Remarks/rules
captureDay Mandatory (0)
captureMode Tհe value sent in the request is ignored.
The capture mode is forced to IMMEDIATE.
cardExpiryDate Mandatory (format: YYYYMM)
cardNumber Mandatory
currencyCode Mandatory: EUR only (978)
orderChannel Mandatory (INTERNET)
paymentMeanBrand Must be populated withACCORD_KDO.

The following table summarises the different response cases to be processed:

Status Response fields Action to take
Payment accepted acquirerResponseCode = 00
acquirerResponseIdentifier = Oney identifier
authorisationId = (cf. the Data Dictionary).
cardScheme = ACCORD
paymentMeanBrand = ACCORD_KDO
paymentMeanTradingName = card name with reference to the trading name.
You can deliver the order.
Acquirer refusal acquirerResponseCode = (cf. the Data Dictionary). The authorisation is refused for a reason unrelated to fraud, you can suggest that your customer pay with another means of payment by generating a new request.
Refusal due to a technical issue acquirerResponseCode = 90-98
responseCode = 90, 99
Temporary technical issue when processing the transaction. Suggest that your customer redo a payment later.

For the complete response codes (responseCode) and acquirer response codes (acquirerResponseCode), please refer to the Data dictionary.

The following operations are available on Oney gift card transactions:

Cash management
Cancellation X
Validation X
Refund V
Duplication V
Recycling X
Credit X

The diagram below informs you which cash management operation is available when a transaction is in a given state:


diagram showing the different statuses of a transaction

The transaction will go from the Captured status to the Credited status once it is full refund.

The reports provided by WL Sips allow you to have a comprehensive and consolidated view of your transactions, cash operations, accounts and chargebacks. You can use this information to improve your information system.

The availability of Oney gift card transactions for each type of report is summarised in the table below:

Reports availability
Transactions report V
Operations report V
Reconciliations report V
Chargebacks report X
Note: for Oney gift card transactions, the paymentMeanBrand field is populated with the value ACCORD_KDO.

You can view your Oney gift card transactions and perform various cash management operations with Sips Office Extranet.

Here are the details of an Oney gift card transaction:



This site uses trackers to improve your experience, perform analysis and researches on your use of WL Sips documentation website.
You have several options:
Closing this banner you refuse the use of trackers on your device.

Configuration