Skip to main content
Partner logo
Oney Cb4x
At Oney, we have a different, unique vision of financial services and payment solutions: more modern, more responsible and more human. As a partner in the transformation of commerce, with our thousands of retail partners, we give everyone the power to improve their daily lives and consume better.
Source: https://www.oney.com/

Features

Integration type

Redirection
Tokenization

Yes

Payment Flow

1-step payment flow : Capture (direct debit)
2-step payment flow : Authorization + Capture
3-step payment flow : Pending Authorization + Authorization + Capture

How to test?

info

Oney finances only French customers. Your Create Session call must contains an order.customer node valued with French customer data.

Test Cards

CredentialsSUCCESSPENDINGREFUSED
Amountbetween 100€ to 1000€between 1000€ to 1500€up to 2000€
Card number4970 1056 7426 00004970 1056 7426 00004970 1056 7426 0000
Expiry dateany future month and yearany future month and yearany future month and year
CVCany 3 random numbersany 3 random numbersany 3 random numbers
info

As you can see on the table below, order.amount can be used to test different behaviours.

Data Mapping & Mandatory Fields

Below is the mapping between your Create Session request and the fields expected by this payment method.

Purse Session fieldMandatory
amountYes
order.redirectionYes
order.referenceYes
order.amountYes
order.currency_codeYes
customer.referenceYes
customer.type_codeNo
customer.company_nameNo
customer.gender_codeNo
customer.first_nameYes
customer.last_nameYes
customer.birthdateNo
customer.locale_codeYes
customer.billing_address.delivery_point_nameNo
customer.billing_address.address_linesYes
customer.billing_address.cityYes
customer.billing_address.postal_codeYes
customer.billing_address.country_codeYes
customer.billing_address.emailYes
customer.billing_address.phoneYes
customer.billing_address.mobile_phoneYes
customer.additional_attributes.national_identifierNo
shipments.amountYes
shipments.delivery_type_codeYes
shipments.delivery_quickness_codeYes
shipments.estimated_delivery_date_timeYes
shipments.shipping_address.delivery_point_nameYes
shipments.shipping_address.gender_codeYes
shipments.shipping_address.first_nameYes
shipments.shipping_address.last_nameYes
shipments.shipping_address.address_linesYes
shipments.shipping_address.cityYes
shipments.shipping_address.postal_codeYes
shipments.shipping_address.country_codeYes
shipments.shipping_address.emailYes
shipments.shipping_address.phoneYes
shipments.seller_nameYes
shipments.seller_referenceYes
shipments.item_lines.type_codeNo
shipments.item_lines.sku_referenceYes
shipments.item_lines.nameYes
shipments.item_lines.quantityYes
shipments.item_lines.amountYes
shipments.item_lines.priceYes

Payment Labels

LabelMethodPayment type
oneycb4xprimary (payment by installments)

Actions

ActionMandatory fieldsOptional fields
APPLY
amount
0
currency_code
EUR
customer
{"gender_code":"unknown","locale_code":"und","billing_address":{"address_lines":["line1","line2"]}}
shipments
[{"delivery_type_code":"user_delivery","delivery_quickness_code":"regular","shipping_address":{"address_lines":["line1","line2"]},"item_lines":[{"price":10,"quantity":1}]}]
-

Status

PSP statusStateCodeDescription
11ERRORBAD_REQUESTFailed to Cancel – the service is not available
14ERRORBAD_REQUESTTechnical error – the Order data could not be retrieved.
ERRORERRORFAILEDThe partner returned an error
ERR_01ERRORBAD_REQUESTField is required: Identify and correct the field then retry the call to the service.
ERR_02ERRORBAD_REQUESTField size is incorrect: Identify and correct the field then retry the call to the service.
ERR_03ERRORBAD_REQUESTField format is not valid: Identify and correct the field then retry the call to the service.
ERR_04
ERR_05
ERR_06
ERR_07ERRORBAD_REQUESTAn unexpected error occurred when trying to process the request. Please retry the call to the service.
ERR_09
ERR_10ERRORBAD_REQUESTThe order associated with the reference does not exist: The field purchase/external_reference
ERR_13ERRORBAD_REQUESTThe amount must be lower than or equal to amount initially saved. (Can occur for partial capture where Oney makes internally a refund au adjust the Authorized amount and match it to the requested capture amount. ie: if Authorized amount= 30€, capture amount= 29.10€ Oney will try refund of 0.90€ and it will fail.)
ERR_17ERRORBAD_REQUESTThe order status does not allow to process a cancellation request.
ERR_18ERRORBAD_REQUESTService is not available
ERR_19ERRORBAD_REQUESTAn error occurred when trying to process the request: Please retry the call to the service.
ERR_20ERRORBAD_REQUESTThe payment status does not allow cancellation.
ERR_23ERRORBAD_REQUESTField type is not compatible with parameter entries: Identify and correct the field then retry the call to the service.
ERR_25ERRORBAD_REQUESTThe required field “Code barre de fidélité” is not filled in. Only if the merchant is configured to use loyalty.
ERR_26ERRORBAD_REQUESTAn order already exists with the same references and creation date: The field purchase/external_reference.
ERR_29ERRORBAD_REQUESTinvalid business transaction code: Review the payment request and change the business transaction code by a valid one
ERR_30ERRORBAD_REQUESTThe order is canceled or is being canceled.
FUNDEDSUCCESSSUCCEEDEDFUNDED : Transaction is completed
ABORTEDERROREXPIRED_AUTHORIZATIONABORTED : Payment in timeout
PENDINGWAITINGWAITING_PARTNER_RESPONSEPENDING : Waiting for Oney acceptance
REFUSEDERRORREJECTED_BANKREFUSED : Payment was refused
SUCCESSSUCCESSSUCCEEDEDSuccessfully
CANCELLEDSUCCESSSUCCEEDEDCANCELLED : Payment has been cancelled
FAVORABLESUCCESSSUCCEEDEDFAVORABLE : Oney accepts the payment
TO_BE_FUNDEDWAITINGWAITING_PARTNER_RESPONSETO_BE_FUNDED : Payment in progress and merchant is sending the items