Last update 13/12/2018

3. Integration

Integration is performed in e-Commerce mode, as described in our Ingenico ePayments e-Commerce integration guide. The principle is to send additional fields specific to the 3XCB payment method. 

3.1 Preselection of payment method

The merchant has the option of preselecting the 3XCB payment method. To do so, he must send the value "3XCB" along with the "PM" parameter (PM=3XCB). Check our Payment method selection options page for more info)

3XCB is only available for a specific range of amounts. If 3XCB is preselected despite the amount being too high or too low, the buyer will see an error message. 

3.2 Additional fields

Cofinoga requires additional data for you to be able to process 3XCB transactions. Therefore, the following fields must be submitted along with the default e-Commerce fields.

Format: AN= Alphanumeric / N=Numeric, maximum allowed amount of characters

Field

Description

Format

CIVILITY

Civility

AN, 5

ECOM_BILLTO_POSTAL_NAME_LAST

Customer's surname

AN, 50

ECOM_BILLTO_POSTAL_NAME_FIRST

Customer's first name

AN, 35

ECOM_SHIPTO_DOB

Date of birth

dd/mm/yyyy

EMAIL

Email

AN, 50

OWNERADDRESS

Address 1

AN, 35

OWNERCTY

Country

AN, 2

OWNERTELNO

Telephone Number

AN, 30

OWNERTOWN

Town/city

AN, 25

OWNERZIP

Postcode

AN, 10

PM

Specifies the payment method to be shown to the customer.

Attention: 3XCB is only available for a specific range of amounts. If 3XCB is preselected despite the amount being too high or too low, the buyer will see an error message.

3XCB

3.2.1 Example

The coding block hereafter must be sent to us with the values correctly entered.

This form must be sent from the customer's browser.

<form method="post" action="https://secure.ogone.com/ncol/test/orderstandard.asp" id=form1
name=form1>
<input type="hidden" name="PSPID" value="MONPSPID3XCB">
<input type="hidden" name="ORDERID" value="MonPaiement3XCB">
<input type="hidden" name="AMOUNT" value="25000">
<input type="hidden" name="CURRENCY" value="EUR">
<input type="hidden" name="LANGUAGE" value="fr_FR">
<input type="hidden" name="CN" value="Bill Smith">
<input type="hidden" name="EMAIL" value="test@test.com">
<input type="hidden" name="OWNERZIP" value="75009">
<input type="hidden" name="OWNERADDRESS" value="5 rue de rochechouart">
<input type="hidden" name="ECOM_SHIPTO_DOB" value="15/04/1970">
<input type="hidden" name="OWNERCTY" value="FR">
<input type="hidden" name="OWNERTOWN" value="Paris">
<input type="hidden" name="OWNERTELNO" value="0102030405">
<input type="hidden" name="SHASIGN" value="59774695ed8335183166b8de962865f9d81136c5">
<input type="hidden" name="CIVILITY" value="Mr">
<input type="hidden" name="ECOM_BILLTO_POSTAL_NAME_LAST" value="SMITH">
<input type="hidden" name="ECOM_BILLTO_POSTAL_NAME_FIRST " value="BILL">

<input type="submit" value="" id=submit2 name=submit2>
</form>

3.3 3XCB behaviour management

3.3.1 Execution of the first payment at the time of the order

With 3XCB, the payment is always executed immediately following the authorisation. This sale process is called "direct sale".

The first payment corresponds to the first due date, including any merchant's fees.

The second and third due dates are scheduled for D+30 and D+60 in accordance with the 3XCB template. Thereafter, debits are issued automatically by the Ingenico ePayments platform.

3.3.2 Fees paid by the buyer / by the merchant

These fees are defined in the table of fee scales provided by Cofinoga Laser.

3.4 3XCB payment page

When we receive the redirection URL with the parameters correctly entered we display the 3XCB payment page for the customer.

This page consists of two screens. 

These two screens can be fully personalised using a dynamic template. See e-Commerce: Dynamic template for more information.

1st screen :

  1. Order summary
  2. Spreading of payment with the amounts and collection dates (defined between the merchant and Cofinoga)
  3. Non-modifiable information (provided in the HTML form)
  4. Modifiable information
  5. Display of payment mask. The customer must enter his or her card details.
  6. The customer must accept the GCU of Cofinoga and can sign up to the newsletter
  7. Payment validation
  8. Possibility of cancelling the order and returning to the site

2nd screen:

  1. Order summary
  2. Spreading of payment with the amounts and collection dates (defined between the merchant and Cofinoga)
  3. Summary of personal details
  4. Possibility of returning to the previous screen to amend information.
  5. Payment validation
  6. Possibility of cancelling the order and returning to the site

When the payment is validated, we ask to confirm the payment. Depending on the reply we redirect the customer to the redirection URLs specified in the HTML form.

If no URL is specified, we display a standard Ingenico ePayments page with the payment status.

3.5 Confirmation e-mail

Once the payment has been made, a confirmation email is sent to the customer. This email is defined by Cofinoga but is sent from our platform. It contains the details of the transaction as well as the contract set up between the customer and Cofinoga. 

As a leading global digital payment service provider, Ingenico Payment Services provides a seamless response to the complexity of payments, whatever the channel: online, mobile and point-of-sale. Offering innovative e-commerce, multi-channel, financial, and marketing solutions, it helps merchants to manage, collect and secure their payments, prevent fraud and increase their revenues through higher conversions. Ingenico Payment Services is part of the Ingenico Group, the global leader in seamless payment.

This website uses cookies to be able to give you the best user experience. If you don't want to accept these cookies, we allow you to change the cookie settings. Click 'Accept' to allow all cookies from this website.

Cookie settings

Introduction

Functional

Functional cookies are required for the website to operate correctly. These cookies cannot be disabled.

Optimized

Optimization cookies allow us to analyze site usage so we can measure and improve our website.
This is the default level.

Personalized

Personalization cookies are used for social media and advanced personalization. They allow us to show you information related to your company.


Example functionality allowed

  • Store country preference
  • Store language preference

Example functionality not allowed

  • Saving personal data
  • Anonymous tracking via Google Analytics
  • Tracking for remarketing purposes

Example functionality allowed

  • Store country preference
  • Store language preference
  • Anonymous tracking via Google Analytics

Example functionality not allowed

  • Saving personal data
  • Tracking for remarketing purposes

Example functionality allowed

  • Store country preference
  • Store language preference
  • Anonymous tracking via Google Analytics
  • Serve content relevant to your interests
  • Serve ads relevant to your interests
  • Tracking for remarketing purposes

Example functionality not allowed

  • Saving personal data