Ultimo aggiornamento 19/11/2015

3. Request a new order

3.1 Request URL

  • The request URL in the TEST environment is https://ogone.test.v-psp.com/ncol/test/orderdirect.asp.
  • The request URL in the PRODUCTION environment is https://secure.ogone.com/ncol/prod/orderdirect.asp.

Change "test" to "prod"

Replace “test” with “prod” in the request URL when you switch to your production account. If you forget to change the request URL, once you start in production with real orders, your transactions will be sent to the test environment and will not be processed by the acquirers/banks.

3.2 Request parameters

The following table contains the request parameters for sending a new order request:

Format: AN= Alphanumeric / N=Numeric, maximum allowed amount of characters
Field Description Format Mandatory
PSPID
Your affiliation name in our system.
AN, 30
Yes
ORDERID
Your unique order number (merchant reference).
AN, 40
Yes
USERID
Name of your application (API) user. Please refer to the User Manager documentation for information on how to create an API user.
AN, 20 (min 2)
Yes
PSWD
Password of the API user (USERID).
AN
Yes
AMOUNT
Amount to be paid, MULTIPLIED BY 100 as the format of the amount must not contain any decimals or other separators.
N, 15 Yes
CURRENCY
ISO alpha order currency code, for example: EUR, USD, GBP, CHF, etc.
AN, 3 Yes
CARDNO
Card/account number.
AN, 21
Yes
ED
Expiry date.
MM/YY or MMYY
Yes
COM
Order description.
AN, 100
No
CN
Customer name.
AN, 35
No
EMAIL
Customer’s email address.
AN, 50
No
SHASIGN
Signature (hashed string) to authenticate the data (see SHA-IN Signature).
AN, 128
Yes
CVC
Card Verification Code. Depending on the card brand, the verification code will be a 3- or 4-digit code on the front or rear of the card, an issue number, a start date or a date of birth.
N, 5
Yes
ECOM_PAYMENT_
CARD_VERIFICATION
Alternative to CVC: date of birth / issue number / etc. (depending on country/bank)
N, 5
No
OWNERADDRESS
Customer’s street name and number.
AN, 50
No
OWNERZIP
Customer’s postcode.
AN, 10
No
OWNERTOWN
Customer’s town/city name.
AN, 40
No
OWNERCTY
Customer’s country, e.g. BE, NL, FR, etc.
AN, 2 No
OWNERTELNO
Customer’s telephone number.
AN, 30
No
OPERATION

Defines the type of requested transaction.

You can configure a default operation (payment procedure) in the "Global transaction parameters" tab, "Default operation code" section of the Technical Information page. When you send an operation value in the request, this will overwrite the default value.

Possible values:
  • RES: request for authorisation
  • SAL: request for direct sale
  • RFD: refund, not linked to a previous payment, so not a maintenance operation on an existing transaction (you can not use this operation without specific permission from your acquirer).

Optional:

  • PAU: Request for pre-authorisation:
      In agreement with your acquirer you can use this operation code to temporarily reserve funds on a customer's card. This is a common practice in the travel and rental industry.
      PAU/pre-authorisation can currently only be used on MasterCard transactions and is supported by selected acquirers. This operation code cannot be set as the default in your Ingenico ePayments account.
      Should you use PAU on transactions via acquirers or with card brands that don't support pre-authorisation, these transactions will not be blocked but processed as normal (RES) authorisations.
A, 3
Yes
WITHROOT
Adds a root element to our XML response. Possible values: ‘Y’ or empty.
Y or <empty>
No
REMOTE_ADDR
Customer's IP address (for Fraud Detection Module only). If a country check does not need to be performed on the IP address, send 'NONE'.
AN
No
RTIMEOUT

Request timeout for the transaction (in seconds, value between 30 and 90)

Important: The value you set here must be smaller than the time out value in your system (!)

 

N, 2
No
ECI

Electronic Commerce Indicator.

You can configure a default ECI value in your account's Technical information page, "Global transaction parameters" tab, "Default ECI value" section. When you send an ECI value in the request, this will override the default ECI value.

Possible (numeric) values:
0 - Swiped
1 - Manually keyed (MOTO) (card not present)
2 - Recurring (from MOTO)
3 - Instalment payments
4 - Manually keyed, card present
7 - E-commerce with SSL encryption
9 - Recurring (from e-commerce)
N, 2
No
COF_INITIATOR           Credential-on-file initiator
Possible values:
  • CIT: A transaction initiated by a cardholder
  • MIT: A transaction initiated by a merchant                                                                                                                  
AN          No             
COF_SCHEDULE  Credential-on-files scheduled (or unscheduled)
Possible values:
  • SCHED: A scheduled transaction
  • UNSCHED: An unscheduled transaction
AN No
COF_TRANSACTION Credential-on-file transaction
Possible values:
  • FIRST: A scheduled transaction
  • SUBEQ: Subsequent series of transaction 
AN No
The list of possible parameters to send can be longer for merchants who have activated certain options/functionalities in their accounts. Please refer to the respective option documentation for more information on extra parameters linked to the option.

The following request parameters are mandatory in new orders:

  • PSPID and USERID
  • PSWD
  • ORDERID
  • AMOUNT (x 100)
  • CURRENCY
  • CARDNO
  • ED
  • CVC
  • OPERATION 

3.3 Test page

Our test page to send order requests in DirectLink can be found here: https://ogone.test.v-psp.com/ncol/test/testodl.asp.

3.4 Excluding specific payment methods

If there are payment methods you don't want a customer to be able to pay with, you can use a parameter to do so.
This is particularly useful for sub-brands, when you want to accept a brand (e.g. MasterCard) but not one of its sub-brands (e.g. Maestro).

The parameter is the following:

Field Usage
EXCLPMLIST
List of payment methods and/or credit card brands that should NOT be used.
Values must be separated by a “;” (semicolon).

If a customer tries paying with a card linked to a payment method and/or (sub)brand thT you've excluded BY using the EXCLPMLIST parameter, the error message “Card number incorrect or incompatible” will be returned with the NCERRORPLUS return field.

3.5 Order request using 3-D Secure

Our system supports the usage of 3-D Secure with DirectLink.

Important

  • If you wish to use 3-D Secure with DirectLink, you need to have the D3D option activated in your account.
  • Some acquiring banks require the use of 3-D Secure. Please check with your acquirer if this is the case for you.

3.6 Split credit/debit cards

The functionality to split VISA and MasterCard into a debit and a credit payment method allows you to offer them to your customers as two different payment methods (e.g. VISA Debit and VISA Credit), or you can decide only to accept one of both split brands.

To use the split of credit and debit cards via DirectLink, you need to include the CREDITDEBIT parameter in the fields that you send to the orderdirect.asp page (and therefore also include in the SHA-IN calculation!).

Field Format
CREDITDEBIT "C": credit card
"D": debit card

Related error: When the buyer selects the debit card method but next enters a credit card number, an error code will be returned: ‘Wrong brand/Payment method was chosen’.

If the payment is successfully processed with the CREDITDEBIT parameter, the same parameter will also be returned in the XML response, and/or can be requested with a Direct Query. However, whereas the submitted values are C or D, the return values are "CREDIT" or "DEBIT".

You will also find these return values in transaction overview via "View transactions" and "Financial history", and in reports you may download afterwards.

Configuration in your account

The "split" functionality can also be activated and configured per payment method, in your Ingenico ePayments account. Go to Split Credit/Debit Cards for more information.

3.7 Elaborazione di transazioni con credenziali memorizzate

La transazione credential-on-file (COF) utilizza i dettagli della carta già salvati dai commercianti per elaborare il pagamento. Prima di avviare una transazione credential-on-file (COF), il titolare della carta di credito deve autorizzare il commerciante a memorizzarne i dettagli. La transazione credential-on-file (COF) viene utilizzata principalmente con i pagamenti ricorrenti e indica se il pagamento è stato avviato da un titolare di carta di credito o da un commerciante.

Esistono due tipi di transazione credential-on-file (COF): transazione avviata dal titolare di carta di credito (CIT) e transazione avviata dal commerciante (MIT). La transazione avviata dal titolare di carta di credito (CIT) dovrà sempre essere effettuata prima della transazione avviata dal commerciante (MIT).

Una transazione avviata dal titolare di carta di credito (CIT) è una transazione in cui il titolare della carta effettua e convalida personalmente la transazione, tramite firma, dispositivo 3D-Secure o documento d’identità.

Esempio di transazione avviata dal titolare di carta di credito (CIT):

Un titolare di carta di credito acquista un biglietto del treno online ed effettua il pagamento. Lui/lei effettua il pagamento con la propria carta e gli/le viene chiesto di autenticare e autorizzare il pagamento. Nello stesso momento, al titolare viene chiesto se desidera salvare i dettagli della carta di credito relativi al pagamento. Se il titolare acconsente, l’informazione può essere riutilizzata per transazioni future avviate dal commerciante.

Una transazione avviata dal commerciante (MIT) viene avviata da un commerciante successivamente a una transazione avviata dal titolare di carta di credito (CIT) e a un ordine permanente prestabilito di beni e servizi acquistati dal titolare della carta. Il titolare della carta di credito non è coinvolto nella transazione.

Esempio di transazione avviata dal commerciante (MIT):

Un commerciante può avviare automaticamente una transazione per il pagamento da parte del titolare della carta di un abbonamento mensile a una rivista.

In conformità ai regolamenti stabiliti da Visa e MasterCard per la transazione credential-on-file (COF), è necessario inviare nuovi parametri per determinare la transazione COF. 

Ne sono interessati coloro che:

  • utilizzano un alias.
  • prevedono di avviare transazioni ricorrenti (programmate o meno) dopo l’avvio di una transazione avviata dal titolare di carta di credito (CIT) per la prima volta.

Azione necessaria

Per impostazione predefinita, in una transazione online vengono utilizzati i seguenti parametri:

Parametri

Descrizione

CIT-FIRST- UNSCHEDULED
Quando viene creato o utilizzato un alias
CIT-FIRST- SCHEDULED

Per il primo pagamento o abbonamento programmato

MIT-SUBSEQUENT-UNSCHEDULED
Se ricorrente
MIT-SUBSEQUENT-SCHEDULED
Per ogni rata

Se non si aggiungono parametri, i valori predefiniti vengono segnalati. Tuttavia, se si desidera modificarli, è possibile sovrascrivere questi valori predefiniti inviando i nuovi parametri. Occorre, inoltre, ricalcolare la firma digitale SHA (fai clic qui per maggiori informazioni sulla firma digitale SHA)

Parametri

Valori

Descrizione

COF_INITIATOR CIT Una transazione avviata dal titolare di carta di credito
  MIT Una transazione avviata dal commerciante
COF_SCHEDULE
SCHED Una transazione programmata
  UNSCHED Una transazione non programmata
COF_TRANSACTION
FIRST La prima di una serie di transazioni

SUBEQ

Serie di transazioni successiva

Questo sito web utilizza i cookie per essere in grado di darvi la migliore esperienza utente. Se non si desidera accettare i cookie, è possibile modificare le impostazioni dei cookie. Cliccate su 'Accetta' per consentire tutti i cookie di questo sito.

Impostazioni dei cookie

Introduzione

Funzionale

I cookies funzionali sono necessari per il funzionamento corretto del sito web. Non è possibile disattivare questi cookie.

Ottimizzato

I cookies per l’ottimizzazione ci permettono di analizzare l'utilizzo del sito in modo che possiamo monitorare e migliorare il nostro sito.
Questo รจ il livello predefinito.

Personalizzata

Cookies di personalizzazione vengono utilizzati per i social media e per personalizzazione avanzata, permettendoci di mostrarvi le informazioni collegate alla vostra azienda.


Esempio delle funzionalità consentite

  • Salvare le preferenze riguardanti il paese
  • Salvare le preferenze riguardanti la lingua

Esempio delle funzionalità non consentite

  • Salvataggio dei dati personali
  • Tracciamento per scopi di remarketing
  • Tracciamento anonimo tramite Google Analytics

Esempio delle funzionalità consentite

  • Salvare le preferenze riguardanti il paese
  • Salvare le preferenze riguardanti la lingua
  • Tracciamento anonimo tramite Google Analytics
  • Tracciamento per scopi di remarketing

Esempio delle funzionalità non consentite

  • Salvataggio dei dati personali
  • Tracciamento per scopi di remarketing

Esempio delle funzionalità consentite

  • Salvare le preferenze riguardanti il paese
  • Salvare le preferenze riguardanti la lingua
  • Tracciamento anonimo tramite Google Analytics
  • Mostrare contenuto in linea con i vostri interessi
  • Mostrare pubblicità in linea con i vostri interessi
  • Tracciamento per scopi di remarketing

Esempio delle funzionalità non consentite

  • Salvataggio dei dati personali