Introduction

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 .

Who does this document target?

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

Understanding Oney gift card payments with WL Sips

General principles

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.

Acceptance rules

Available functionalities

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

Payment pages

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 reques t).

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

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

Signing your Oney gift card acceptance contract

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

Making an Oney gift card payment

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:

Making an Oney gift card payment with Sips Paypage

The payment process for Sips Paypage is described below:

Setting the payment request

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.

Analysing the response

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

Status Response fields Action to take
Payment accepted acquirerResponseCode = 00
authorisationId = (cf. the Data Dictionary).
additionalAuthorisationNumber = Oney additional authorisation number
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 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 .

Making an Oney gift card payment with Sips Office

The payment process for Sips Office is described below:

Setting the payment request

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 Mandatory (ACCORD_KDO)

Analysing the response

The following specific fields are populated in the case of an Oney gift card payment.

Field name Remarks/rules
paymentMeanData.accordkdo.additionalAuthorizationNumber Additional authorisation number
cardScheme ACCORD

Managing your Oney gift card transactions

Viewing your Oney gift card transactions

Reports

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.

Sips Office Extranet

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: