Introduction
Worldline 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 Worldline 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 Worldline Sips solution, we advise you to consult the following documents:
- Functional presentation
- Functionality set-up guide
Understanding Oney gift card payments with Worldline 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 request).
![Image for entering the required information with choice of amount](../../resources/images/en/WLSIPS.127-PM-Oney-gift-card-integration/Saisie-informations-ONEY.png)
![Image for entering the required information without choice of amount](../../resources/images/en/WLSIPS.127-PM-Oney-gift-card-integration/Entree-des-informations-ONEY.png)
The payment ticket is displayed, then the customer returns to your website:
![Payment ticket image](../../resources/images/en/WLSIPS.127-PM-Oney-gift-card-integration/Ticket-ONEY.png)
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
Worldline 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](../../resources/images/en/WLSIPS.127-PM-Oney-gift-card-integration/ProcessPayment-ONEY-KDO-EN.png)
Making an Oney gift card payment with Sips Paypage
The payment process for Sips Paypage is described below:
![diagram showing the payment kinematics via Paypage](../../resources/images/en/WLSIPS.127-PM-Oney-gift-card-integration/ProcessPaypage-ONEY-KDO-EN.png)
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.bypassReceiptPage | 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
acquirerResponseIdentifier =
Oney identifieracquirerResponseMessage =
Oney ticketauthorisationId = (cf. the
Data Dictionary).paymentMeanData.acccordkdo.additionalAuthorisationNumber
= Oney additional authorisation numberpaymentMeanBrand =
ACCORD_KDOpaymentMeanType =
CARDpaymentMeanTradingName = card
name with reference to the trading name.responseCode =
00 |
You can deliver the order. |
Acquirer refusal | acquirerResponseCode = (cf.
the Data Dictionary).responseCode =
05 |
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.
Making an Oney gift card payment with Sips Office
The payment process for Sips Office is described below:
![diagram showing the payment kinematics via Office](../../resources/images/en/WLSIPS.127-PM-Oney-gift-card-integration/ProcessOffice-ONEY-KDO-EN.png)
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 | Must be populated withACCORD_KDO. |
Analysing the response
The following table summarises the different response cases to be processed:
Status | Response fields | Action to take |
---|---|---|
Payment accepted | acquirerResponseCode = 00
acquirerResponseIdentifier =
Oney identifieracquirerResponseMessage =
Oney ticketauthorisationId = (cf. the
Data Dictionary).cardScheme =
ACCORDpaymentMeanData.accordkdo.additionalAuthorisationNumber
= additional authorisation number.paymentMeanBrand =
ACCORD_KDOpaymentMeanType =
CARDpaymentMeanTradingName = card
name with reference to the trading name.responseCode =
00 |
You can deliver the order. |
Acquirer refusal | acquirerResponseCode = (cf.
the Data Dictionary).responseCode =
05 |
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.
Managing your Oney gift card transactions
Available cash operations
The following operations are available on Oney gift card transactions:
Cash management | ||
---|---|---|
Cancellation | X | |
Validation | X | |
Refund | V | |
Duplication | V | |
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](../../resources/images/en/WLSIPS.127-PM-Oney-gift-card-integration/ProcessCashManagement-ONEY-KDO-EN.png)
Viewing your Oney gift card transactions
Reports
The reports provided by Worldline 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 |
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: