walletManagementInit
To search in the page use Ctrl+F on your keyboard
Allows to initialize a wallet management kinematic with “Sogenactif Walletpage.”
Recommended interfaceVersion:
- POST : HP_3.0
- JSON/SOAP : WMR_WS_3.0
Endpoints
-
- PROD
-
https://payment-webinit.sogenactif.com/rs-services/v2/walletManagementInit
- method
- POST
-
- SIMU
-
https://payment-webinit.simu.sogenactif.com/rs-services/v2/walletManagementInit
- method
- POST
-
- PROD
-
https://payment-webinit.sogenactif.com/walletManagementInit
- method
- POST
-
- SIMU
-
https://payment-webinit.simu.sogenactif.com/walletManagementInit
- method
- POST
-
- PROD
-
https://payment-webinit.sogenactif.com/services/v2/walletManagementInit
- method
- POST
-
- SIMU
-
https://payment-webinit.simu.sogenactif.com/services/v2/walletManagementInit
- method
- POST
Request
Required
-
interfaceVersion
- presence
- Required
- Interface version
- 2.0
Version of the interface used. It is composed of a prefix that varies according to the function used and a version number (e.g. IR_WS_2.47).
Please refer to the function page for the value to use. Use the latest interface version number.
List of values
WMR_WS_2.
- Sogenactif Walletpage interface (SOAP/JSON).
HP_x.x
- Sogenactif Paypage and Sogenactif Walletpage (POST) interface.
-
keyVersion
- presence
- Required
- Interface version
- 2.2
Version of the merchant’s secret key used to calculate the imprint of the message (key stored by the merchant to verify the imprint of the automatic and manual notifications).
-
merchantId
- presence
- Required
- Interface version
- 2.0
Identifier of the shop, this value is provided to the merchant by Sogenactif during the shop registration.
-
merchantWalletId
- presence
- Required
- Interface version
- 2.0
Customer’s Wallet identifier.
-
normalReturnUrl
- presence
- Required
- Interface version
- 2.0
Merchant’s URL for the return to the shop.
-
requestDateTime
- presence
- Required
- Interface version
- 2.0
Date and Time (UTC) at which the merchant has submitted the request to the Sogenactif server.
-
seal
- presence
- Required
- Interface version
- 2.2
Message seal used to ensure the integrity of the request and the authentication of sender / receiver of the message.
Optional
-
automaticResponseUrl
- presence
- Optional
- Interface version
- 2.0
URL provided by the merchant and used by the payment server to automatically notify the merchant of the result of the transaction online.
-
billingAddress
- presence
- Optional
- Interface version
- 2.0
Contains the billing address information for the buyer.
Contains
-
addressAdditional3
- presence
- Optional
- Interface version
- 2.0
Addition 3 to the address.
-
addressAdditional1
- presence
- Optional
- Interface version
- 2.0
Addition 1 to the address.
-
addressAdditional2
- presence
- Optional
- Interface version
- 2.0
Addition 2 to the address.
-
businessName
- presence
- Optional
- Interface version
- 2.4
Business name.
-
city
- presence
- Optional
- Interface version
- 2.0
City of the address.
-
company
- presence
- Optional
- Interface version
- 2.0
Company for the address.
-
country
- presence
- Optional
- Interface version
- 2.0
Country code for the address.
List of values
ABW
- ARUBA
AFG
- AFGHANISTAN
AGO
- ANGOLA
AIA
- ANGUILLA
ALA
- ÅLAND ISLANDS
ALB
- ALBANIA
AND
- ANDORRA
ARE
- UNITED ARAB EMIRATES
ARG
- ARGENTINA
ARM
- ARMENIA
ASM
- AMERICAN SAMOA
ATA
- ANTARCTICA
ATF
- FRENCH SOUTHERN TERRITORIES
ATG
- ANTIGUA AND BARBUDA
AUS
- AUSTRALIA
AUT
- AUSTRIA
AZE
- AZERBAIJAN
BDI
- BURUNDI
BEL
- BELGIUM
BEN
- BENIN
BES
- BONAIRE, SINT EUSTATIUS AND SABA
BFA
- BURKINA FASO
BGD
- BANGLADESH
BGR
- BULGARIA
BHR
- BAHRAIN
BHS
- BAHAMAS
BIH
- BOSNIA AND HERZEGOVINA
BLM
- SAINT KITTS AND NEVIS
BLR
- BELARUS
BLZ
- BELIZE
BMU
- BERMUDA
BOL
- BOLIVIA, PLURINATIONAL STATE OF
BRA
- BRAZIL
BRB
- BARBADOS
BRN
- BRUNEI DARUSSALAM
BTN
- BHUTAN
BVT
- BOUVET ISLAND
BWA
- BOTSWANA
CAF
- CENTRAL AFRICAN REPUBLIC
CAN
- CANADA
CCK
- COCOS (KEELING) ISLANDS
CHE
- SWITZERLAND
CHL
- CHILE
CHN
- CHINA
CIV
- CÔTE D’IVOIRE
CMR
- CAMEROON
COD
- CONGO, THE DEMOCRATIC REPUBLIC OF THE
COG
- CONGO
COK
- COOK ISLANDS
COL
- COLOMBIA
COM
- COMOROS
CPV
- CAPE VERDE
CRI
- COSTA RICA
CUB
- CUBA
CUW
- CURAÇAO
CXR
- CHRISTMAS ISLAND
CYM
- CAYMAN ISLANDS
CYP
- CYPRUS
CZE
- CZECH REPUBLIC
DEU
- GERMANY
DJI
- DJIBOUTI
DMA
- DOMINICA
DNK
- DENMARK
DOM
- DOMINICAN REPUBLIC
DZA
- ALGERIA
ECU
- ECUADOR
EGY
- EGYPT
ERI
- ERITREA
ESH
- WESTERN SAHARA
ESP
- SPAIN
EST
- ESTONIA
ETH
- ETHIOPIA
FIN
- FINLAND
FJI
- FIJI
FLK
- FALKLAND ISLANDS (MALVINAS)
FRA
- FRANCE
FRO
- FAROE ISLANDS
FSM
- MICRONESIA, FEDERATED STATES OF
GAB
- GABON
GBR
- UNITED KINGDOM
GEO
- GEORGIA
GGY
- GUERNSEY
GHA
- GHANA
GIB
- GIBRALTAR
GIN
- GUINEA
GLP
- GUADELOUPE
GMB
- GAMBIA
GNB
- GUINEA-BISSAU
GNQ
- EQUATORIAL GUINEA
GRC
- GREECE
GRD
- GRENADA
GRL
- GREENLAND
GTM
- GUATEMALA
GUF
- FRENCH GUIANA
GUM
- GUAM
GUY
- GUYANA
HKG
- HONG KONG
HMD
- HEARD ISLAND AND MCDONALD ISLANDS
HND
- HONDURAS
HRV
- CROATIA
HTI
- HAITI
HUN
- HUNGARY
IDN
- INDONESIA
IMN
- ISLE OF MAN
IND
- INDIA
IOT
- BRITISH INDIAN OCEAN TERRITORY
IRL
- IRELAND
IRN
- IRAN, ISLAMIC REPUBLIC OF
IRQ
- IRAQ
ISL
- ICELAND
ISR
- ISRAEL
ITA
- ITALY
JAM
- JAMAICA
JEY
- JERSEY
JOR
- JORDAN
JPN
- JAPAN
KAZ
- KAZAKHSTAN
KEN
- KENYA
KGZ
- KYRGYZSTAN
KHM
- CAMBODIA
KIR
- KIRIBATI
KNA
- SAINT BARTHÉLEMY
KOR
- KOREA, REPUBLIC OF
KWT
- KUWAIT
LAO
- LAO PEOPLE’S DEMOCRATIC REPUBLIC
LBN
- LEBANON
LBR
- LIBERIA
LBY
- LIBYA
LCA
- SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
LIE
- LIECHTENSTEIN
LKA
- SRI LANKA
LSO
- LESOTHO
LTU
- LITHUANIA
LUX
- LUXEMBOURG
LVA
- LATVIA
MAC
- MACAO
MAF
- SAINT MARTIN (FRENCH PART)
MAR
- MOROCCO
MCO
- MONACO
MDA
- MOLDOVA, REPUBLIC OF
MDG
- MADAGASCAR
MDV
- MALDIVES
MEX
- MEXICO
MHL
- MARSHALL ISLANDS
MKD
- MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
MLI
- MALI
MLT
- MALTA
MMR
- MYANMAR
MNE
- MONTENEGRO
MNG
- MONGOLIA
MNP
- NORTHERN MARIANA ISLANDS
MOZ
- MOZAMBIQUE
MRT
- MAURITANIA
MSR
- MONTSERRAT
MTQ
- MARTINIQUE
MUS
- MAURITIUS
MWI
- MALAWI
MYS
- MALAYSIA
MYT
- MAYOTTE
NAM
- NAMIBIA
NCL
- NEW CALEDONIA
NER
- NIGER
NFK
- NORFOLK ISLAND
NGA
- NIGERIA
NIC
- NICARAGUA
NIU
- NIUE
NLD
- NETHERLANDS
NOR
- NORWAY
NPL
- NEPAL
NRU
- NAURU
NZL
- NEW ZEALAND
OMN
- OMAN
PAK
- PAKISTAN
PAN
- PANAMA
PCN
- PITCAIRN
PER
- PERU
PHL
- PHILIPPINES
PLW
- PALAU
PNG
- PAPUA NEW GUINEA
POL
- POLAND
PRI
- PUERTO RICO
PRK
- KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OF
PRT
- PORTUGAL
PRY
- PARAGUAY
PSE
- PALESTINIAN TERRITORY, OCCUPIED
PYF
- FRENCH POLYNESIA
QAT
- QATAR
REU
- RÉUNION
ROU
- ROMANIA
RUS
- RUSSIAN FEDERATION
RWA
- RWANDA
SAU
- SAUDI ARABIA
SDN
- SUDAN
SEN
- SENEGAL
SGP
- SINGAPORE
SGS
- SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
SHN
- SAN MARINO
SJM
- SVALBARD AND JAN MAYEN
SLB
- SOLOMON ISLANDS
SLE
- SIERRA LEONE
SLV
- EL SALVADOR
SMR
- SINT MAARTEN (DUTCH PART)
SOM
- SOMALIA
SPM
- HOLY SEE (VATICAN CITY STATE)
SRB
- SERBIA
SSD
- SOUTH SUDAN
STP
- SAO TOME AND PRINCIPE
SUR
- SURINAME
SVK
- SLOVAKIA
SVN
- SLOVENIA
SWE
- SWEDEN
SWZ
- SWAZILAND
SXM
- SAINT PIERRE AND MIQUELON
SYC
- SEYCHELLES
SYR
- SYRIAN ARAB REPUBLIC
TCA
- TURKS AND CAICOS ISLANDS
TCD
- CHAD
TGO
- TOGO
THA
- THAILAND
TJK
- TAJIKISTAN
TKL
- TOKELAU
TKM
- TURKMENISTAN
TLS
- TIMOR-LESTE
TON
- TONGA
TTO
- TRINIDAD AND TOBAGO
TUN
- TUNISIA
TUR
- TURKEY
TUV
- TUVALU
TWN
- TAIWAN, PROVINCE OF CHINA
TZA
- TANZANIA, UNITED REPUBLIC OF
UGA
- UGANDA
UKR
- UKRAINE
UMI
- UNITED STATES MINOR OUTLYING ISLANDS
URY
- URUGUAY
USA
- UNITED STATES
UZB
- UZBEKISTAN
VAT
- SAINT VINCENT AND THE GRENADINES
VCT
- SAINT LUCIA
VEN
- VENEZUELA, BOLIVARIAN REPUBLIC OF
VGB
- VIRGIN ISLANDS, BRITISH
VIR
- VIRGIN ISLANDS, U.S.
VNM
- VIET NAM
VUT
- VANUATU
WLF
- WALLIS AND FUTUNA
WSM
- SAMOA
YEM
- YEMEN
ZAF
- SOUTH AFRICA
ZMB
- ZAMBIA
ZWE
- ZIMBABWE
-
postBox
- presence
- Optional
- Interface version
- 2.0
Post box for the address.
-
state
- presence
- Optional
- Interface version
- 2.0
Address state/department. To be completed in accordance with ISO 3166-2. The first two letters designate the country and the letters following the hyphen designate the subdivision, e.g. FR-ARA for the French region Auvergne-Rhône-Alpes.
-
street
- presence
- Optional
- Interface version
- 2.0
Name of the street of the address.
-
streetNumber
- presence
- Optional
- Interface version
- 2.0
Number of the street of the address.
-
zipCode
- presence
- Optional
- Interface version
- 2.0
Postal code for the address.
-
billingContact
- presence
- Optional
- Interface version
- 2.0
Contains the billing contact’s information.
Contains
-
email
- presence
- Optional
- Interface version
- 2.0
Contact’s email address.
-
firstname
- presence
- Optional
- Interface version
- 2.0
First name of the contact.
-
gender
- presence
- Optional
- Interface version
- 2.0
Gender of the contact, male (=M) or female (=F).
-
initials
- presence
- Optional
- Interface version
- 2.2
contact initals
-
lastname
- presence
- Optional
- Interface version
- 2.0
Last name of the contact.
-
legalId
- presence
- Optional
- Interface version
- 2.4
Legal business identifier (SIRET in France). This field is applicable for merchant or customer (please see fields Contact).
-
mobile
- presence
- Optional
- Interface version
- 2.0
Mobile phone number for the contact.
-
phone
- presence
- Optional
- Interface version
- 2.0
Telephone number for the contact.
-
positionOccupied
- presence
- Optional
- Interface version
- 2.4
Position occupied.
-
title
- presence
- Optional
- Interface version
- 2.0
Title of the contact.
-
customerAddress
- presence
- Optional
- Interface version
- 2.0
Contains the customer’s address information.
Contains
-
addressAdditional3
- presence
- Optional
- Interface version
- 2.0
Addition 3 to the address.
-
businessName
- presence
- Optional
- Interface version
- 2.4
Business name.
-
country
- presence
- Optional
- Interface version
- 2.0
Country code for the address.
List of values
ABW
- ARUBA
AFG
- AFGHANISTAN
AGO
- ANGOLA
AIA
- ANGUILLA
ALA
- ÅLAND ISLANDS
ALB
- ALBANIA
AND
- ANDORRA
ARE
- UNITED ARAB EMIRATES
ARG
- ARGENTINA
ARM
- ARMENIA
ASM
- AMERICAN SAMOA
ATA
- ANTARCTICA
ATF
- FRENCH SOUTHERN TERRITORIES
ATG
- ANTIGUA AND BARBUDA
AUS
- AUSTRALIA
AUT
- AUSTRIA
AZE
- AZERBAIJAN
BDI
- BURUNDI
BEL
- BELGIUM
BEN
- BENIN
BES
- BONAIRE, SINT EUSTATIUS AND SABA
BFA
- BURKINA FASO
BGD
- BANGLADESH
BGR
- BULGARIA
BHR
- BAHRAIN
BHS
- BAHAMAS
BIH
- BOSNIA AND HERZEGOVINA
BLM
- SAINT KITTS AND NEVIS
BLR
- BELARUS
BLZ
- BELIZE
BMU
- BERMUDA
BOL
- BOLIVIA, PLURINATIONAL STATE OF
BRA
- BRAZIL
BRB
- BARBADOS
BRN
- BRUNEI DARUSSALAM
BTN
- BHUTAN
BVT
- BOUVET ISLAND
BWA
- BOTSWANA
CAF
- CENTRAL AFRICAN REPUBLIC
CAN
- CANADA
CCK
- COCOS (KEELING) ISLANDS
CHE
- SWITZERLAND
CHL
- CHILE
CHN
- CHINA
CIV
- CÔTE D’IVOIRE
CMR
- CAMEROON
COD
- CONGO, THE DEMOCRATIC REPUBLIC OF THE
COG
- CONGO
COK
- COOK ISLANDS
COL
- COLOMBIA
COM
- COMOROS
CPV
- CAPE VERDE
CRI
- COSTA RICA
CUB
- CUBA
CUW
- CURAÇAO
CXR
- CHRISTMAS ISLAND
CYM
- CAYMAN ISLANDS
CYP
- CYPRUS
CZE
- CZECH REPUBLIC
DEU
- GERMANY
DJI
- DJIBOUTI
DMA
- DOMINICA
DNK
- DENMARK
DOM
- DOMINICAN REPUBLIC
DZA
- ALGERIA
ECU
- ECUADOR
EGY
- EGYPT
ERI
- ERITREA
ESH
- WESTERN SAHARA
ESP
- SPAIN
EST
- ESTONIA
ETH
- ETHIOPIA
FIN
- FINLAND
FJI
- FIJI
FLK
- FALKLAND ISLANDS (MALVINAS)
FRA
- FRANCE
FRO
- FAROE ISLANDS
FSM
- MICRONESIA, FEDERATED STATES OF
GAB
- GABON
GBR
- UNITED KINGDOM
GEO
- GEORGIA
GGY
- GUERNSEY
GHA
- GHANA
GIB
- GIBRALTAR
GIN
- GUINEA
GLP
- GUADELOUPE
GMB
- GAMBIA
GNB
- GUINEA-BISSAU
GNQ
- EQUATORIAL GUINEA
GRC
- GREECE
GRD
- GRENADA
GRL
- GREENLAND
GTM
- GUATEMALA
GUF
- FRENCH GUIANA
GUM
- GUAM
GUY
- GUYANA
HKG
- HONG KONG
HMD
- HEARD ISLAND AND MCDONALD ISLANDS
HND
- HONDURAS
HRV
- CROATIA
HTI
- HAITI
HUN
- HUNGARY
IDN
- INDONESIA
IMN
- ISLE OF MAN
IND
- INDIA
IOT
- BRITISH INDIAN OCEAN TERRITORY
IRL
- IRELAND
IRN
- IRAN, ISLAMIC REPUBLIC OF
IRQ
- IRAQ
ISL
- ICELAND
ISR
- ISRAEL
ITA
- ITALY
JAM
- JAMAICA
JEY
- JERSEY
JOR
- JORDAN
JPN
- JAPAN
KAZ
- KAZAKHSTAN
KEN
- KENYA
KGZ
- KYRGYZSTAN
KHM
- CAMBODIA
KIR
- KIRIBATI
KNA
- SAINT BARTHÉLEMY
KOR
- KOREA, REPUBLIC OF
KWT
- KUWAIT
LAO
- LAO PEOPLE’S DEMOCRATIC REPUBLIC
LBN
- LEBANON
LBR
- LIBERIA
LBY
- LIBYA
LCA
- SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
LIE
- LIECHTENSTEIN
LKA
- SRI LANKA
LSO
- LESOTHO
LTU
- LITHUANIA
LUX
- LUXEMBOURG
LVA
- LATVIA
MAC
- MACAO
MAF
- SAINT MARTIN (FRENCH PART)
MAR
- MOROCCO
MCO
- MONACO
MDA
- MOLDOVA, REPUBLIC OF
MDG
- MADAGASCAR
MDV
- MALDIVES
MEX
- MEXICO
MHL
- MARSHALL ISLANDS
MKD
- MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
MLI
- MALI
MLT
- MALTA
MMR
- MYANMAR
MNE
- MONTENEGRO
MNG
- MONGOLIA
MNP
- NORTHERN MARIANA ISLANDS
MOZ
- MOZAMBIQUE
MRT
- MAURITANIA
MSR
- MONTSERRAT
MTQ
- MARTINIQUE
MUS
- MAURITIUS
MWI
- MALAWI
MYS
- MALAYSIA
MYT
- MAYOTTE
NAM
- NAMIBIA
NCL
- NEW CALEDONIA
NER
- NIGER
NFK
- NORFOLK ISLAND
NGA
- NIGERIA
NIC
- NICARAGUA
NIU
- NIUE
NLD
- NETHERLANDS
NOR
- NORWAY
NPL
- NEPAL
NRU
- NAURU
NZL
- NEW ZEALAND
OMN
- OMAN
PAK
- PAKISTAN
PAN
- PANAMA
PCN
- PITCAIRN
PER
- PERU
PHL
- PHILIPPINES
PLW
- PALAU
PNG
- PAPUA NEW GUINEA
POL
- POLAND
PRI
- PUERTO RICO
PRK
- KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OF
PRT
- PORTUGAL
PRY
- PARAGUAY
PSE
- PALESTINIAN TERRITORY, OCCUPIED
PYF
- FRENCH POLYNESIA
QAT
- QATAR
REU
- RÉUNION
ROU
- ROMANIA
RUS
- RUSSIAN FEDERATION
RWA
- RWANDA
SAU
- SAUDI ARABIA
SDN
- SUDAN
SEN
- SENEGAL
SGP
- SINGAPORE
SGS
- SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
SHN
- SAN MARINO
SJM
- SVALBARD AND JAN MAYEN
SLB
- SOLOMON ISLANDS
SLE
- SIERRA LEONE
SLV
- EL SALVADOR
SMR
- SINT MAARTEN (DUTCH PART)
SOM
- SOMALIA
SPM
- HOLY SEE (VATICAN CITY STATE)
SRB
- SERBIA
SSD
- SOUTH SUDAN
STP
- SAO TOME AND PRINCIPE
SUR
- SURINAME
SVK
- SLOVAKIA
SVN
- SLOVENIA
SWE
- SWEDEN
SWZ
- SWAZILAND
SXM
- SAINT PIERRE AND MIQUELON
SYC
- SEYCHELLES
SYR
- SYRIAN ARAB REPUBLIC
TCA
- TURKS AND CAICOS ISLANDS
TCD
- CHAD
TGO
- TOGO
THA
- THAILAND
TJK
- TAJIKISTAN
TKL
- TOKELAU
TKM
- TURKMENISTAN
TLS
- TIMOR-LESTE
TON
- TONGA
TTO
- TRINIDAD AND TOBAGO
TUN
- TUNISIA
TUR
- TURKEY
TUV
- TUVALU
TWN
- TAIWAN, PROVINCE OF CHINA
TZA
- TANZANIA, UNITED REPUBLIC OF
UGA
- UGANDA
UKR
- UKRAINE
UMI
- UNITED STATES MINOR OUTLYING ISLANDS
URY
- URUGUAY
USA
- UNITED STATES
UZB
- UZBEKISTAN
VAT
- SAINT VINCENT AND THE GRENADINES
VCT
- SAINT LUCIA
VEN
- VENEZUELA, BOLIVARIAN REPUBLIC OF
VGB
- VIRGIN ISLANDS, BRITISH
VIR
- VIRGIN ISLANDS, U.S.
VNM
- VIET NAM
VUT
- VANUATU
WLF
- WALLIS AND FUTUNA
WSM
- SAMOA
YEM
- YEMEN
ZAF
- SOUTH AFRICA
ZMB
- ZAMBIA
ZWE
- ZIMBABWE
-
city
- presence
- Optional
- Interface version
- 2.0
City of the address.
-
company
- presence
- Optional
- Interface version
- 2.0
Company for the address.
-
addressAdditional1
- presence
- Optional
- Interface version
- 2.0
Addition 1 to the address.
-
addressAdditional2
- presence
- Optional
- Interface version
- 2.0
Addition 2 to the address.
-
postBox
- presence
- Optional
- Interface version
- 2.0
Post box for the address.
-
state
- presence
- Optional
- Interface version
- 2.0
Address state/department. To be completed in accordance with ISO 3166-2. The first two letters designate the country and the letters following the hyphen designate the subdivision, e.g. FR-ARA for the French region Auvergne-Rhône-Alpes.
-
street
- presence
- Optional
- Interface version
- 2.0
Name of the street of the address.
-
streetNumber
- presence
- Optional
- Interface version
- 2.0
Number of the street of the address.
-
zipCode
- presence
- Optional
- Interface version
- 2.0
Postal code for the address.
-
customerContact
- presence
- Optional
- Interface version
- 2.0
Contains the customer’s information.
Contains
-
email
- presence
- Optional
- Interface version
- 2.0
Contact’s email address.
-
firstname
- presence
- Optional
- Interface version
- 2.0
First name of the contact.
-
gender
- presence
- Optional
- Interface version
- 2.0
Gender of the contact, male (=M) or female (=F).
-
initials
- presence
- Optional
- Interface version
- 2.2
contact initals
-
lastname
- presence
- Optional
- Interface version
- 2.0
Last name of the contact.
-
legalId
- presence
- Optional
- Interface version
- 2.4
Legal business identifier (SIRET in France). This field is applicable for merchant or customer (please see fields Contact).
-
mobile
- presence
- Optional
- Interface version
- 2.0
Mobile phone number for the contact.
-
phone
- presence
- Optional
- Interface version
- 2.0
Telephone number for the contact.
-
positionOccupied
- presence
- Optional
- Interface version
- 2.4
Position occupied.
-
title
- presence
- Optional
- Interface version
- 2.0
Title of the contact.
-
customerData
- presence
- Optional
- Interface version
- 2.0
Contains the customer’s information.
Contains
-
birthCity
- presence
- Optional
- Interface version
- 2.0
Birthplace.
-
birthCountry
- presence
- Optional
- Interface version
- 2.0
Country of birth.
-
birthZipCode
- presence
- Optional
- Interface version
- 2.0
Postal code for the birth.
-
birthDate
- presence
- Optional
- Interface version
- 2.0
Date of birth.
-
nationalityCountry
- presence
- Optional
- Interface version
- 2.0
Country of nationality.
-
newPassword
- presence
- Optional
- Interface version
- 2.0
Customer’s new password.
-
password
- presence
- Optional
- Interface version
- 2.0
Password.
-
customerId
- presence
- Optional
- Interface version
- 2.0
Customer identifier
Attention: use this free field only for the intended purpose, and therefore do not insert any personal data, especially cardholder data
As a subcontractor, SG processes personal data in accordance with the Data Processing Agreement (DPA), appended to all contracts.
Thus:
- The personal data specified in the DPA must only be transmitted to SG via the fields provided for this purpose (see data dictionary).
- All other personal data not listed in the DPA must not be transmitted to SG.
-
customerIpAddress
- presence
- Optional
- Interface version
- 2.0
Buyer’s IP address.
-
customerLanguage
- presence
- Optional
- Interface version
- 2.0
Language of the user, used on the payment pages.
List of values
It
- Italian
Ja
- Japanese
cs
- Czech
da
- Danish
de
- German
el
- Greek
en
- English
es
- Spanish
et
- Estonian
fi
- Finnish
fr
- French
hu
- Hungarian
ko
- Korean
lt
- Lithuanian
lv
- Latvian
nl
- Dutch
no
- Norwegian
pl
- Polish
pt
- Portuguese
ro
- Romanian
ru
- Russian
sk
- Slovak
sl
- Slovene
sv
- Swedish
tr
- Turkish
uk
- Ukrainian
zh
- Chinese
-
deliveryAddress
- presence
- Optional
- Interface version
- 2.0
Contains the delivery address information.
Contains
-
addressAdditional3
- presence
- Optional
- Interface version
- 2.0
Addition 3 to the address.
-
businessName
- presence
- Optional
- Interface version
- 2.4
Business name.
-
country
- presence
- Optional
- Interface version
- 2.0
Country code for the address.
List of values
ABW
- ARUBA
AFG
- AFGHANISTAN
AGO
- ANGOLA
AIA
- ANGUILLA
ALA
- ÅLAND ISLANDS
ALB
- ALBANIA
AND
- ANDORRA
ARE
- UNITED ARAB EMIRATES
ARG
- ARGENTINA
ARM
- ARMENIA
ASM
- AMERICAN SAMOA
ATA
- ANTARCTICA
ATF
- FRENCH SOUTHERN TERRITORIES
ATG
- ANTIGUA AND BARBUDA
AUS
- AUSTRALIA
AUT
- AUSTRIA
AZE
- AZERBAIJAN
BDI
- BURUNDI
BEL
- BELGIUM
BEN
- BENIN
BES
- BONAIRE, SINT EUSTATIUS AND SABA
BFA
- BURKINA FASO
BGD
- BANGLADESH
BGR
- BULGARIA
BHR
- BAHRAIN
BHS
- BAHAMAS
BIH
- BOSNIA AND HERZEGOVINA
BLM
- SAINT KITTS AND NEVIS
BLR
- BELARUS
BLZ
- BELIZE
BMU
- BERMUDA
BOL
- BOLIVIA, PLURINATIONAL STATE OF
BRA
- BRAZIL
BRB
- BARBADOS
BRN
- BRUNEI DARUSSALAM
BTN
- BHUTAN
BVT
- BOUVET ISLAND
BWA
- BOTSWANA
CAF
- CENTRAL AFRICAN REPUBLIC
CAN
- CANADA
CCK
- COCOS (KEELING) ISLANDS
CHE
- SWITZERLAND
CHL
- CHILE
CHN
- CHINA
CIV
- CÔTE D’IVOIRE
CMR
- CAMEROON
COD
- CONGO, THE DEMOCRATIC REPUBLIC OF THE
COG
- CONGO
COK
- COOK ISLANDS
COL
- COLOMBIA
COM
- COMOROS
CPV
- CAPE VERDE
CRI
- COSTA RICA
CUB
- CUBA
CUW
- CURAÇAO
CXR
- CHRISTMAS ISLAND
CYM
- CAYMAN ISLANDS
CYP
- CYPRUS
CZE
- CZECH REPUBLIC
DEU
- GERMANY
DJI
- DJIBOUTI
DMA
- DOMINICA
DNK
- DENMARK
DOM
- DOMINICAN REPUBLIC
DZA
- ALGERIA
ECU
- ECUADOR
EGY
- EGYPT
ERI
- ERITREA
ESH
- WESTERN SAHARA
ESP
- SPAIN
EST
- ESTONIA
ETH
- ETHIOPIA
FIN
- FINLAND
FJI
- FIJI
FLK
- FALKLAND ISLANDS (MALVINAS)
FRA
- FRANCE
FRO
- FAROE ISLANDS
FSM
- MICRONESIA, FEDERATED STATES OF
GAB
- GABON
GBR
- UNITED KINGDOM
GEO
- GEORGIA
GGY
- GUERNSEY
GHA
- GHANA
GIB
- GIBRALTAR
GIN
- GUINEA
GLP
- GUADELOUPE
GMB
- GAMBIA
GNB
- GUINEA-BISSAU
GNQ
- EQUATORIAL GUINEA
GRC
- GREECE
GRD
- GRENADA
GRL
- GREENLAND
GTM
- GUATEMALA
GUF
- FRENCH GUIANA
GUM
- GUAM
GUY
- GUYANA
HKG
- HONG KONG
HMD
- HEARD ISLAND AND MCDONALD ISLANDS
HND
- HONDURAS
HRV
- CROATIA
HTI
- HAITI
HUN
- HUNGARY
IDN
- INDONESIA
IMN
- ISLE OF MAN
IND
- INDIA
IOT
- BRITISH INDIAN OCEAN TERRITORY
IRL
- IRELAND
IRN
- IRAN, ISLAMIC REPUBLIC OF
IRQ
- IRAQ
ISL
- ICELAND
ISR
- ISRAEL
ITA
- ITALY
JAM
- JAMAICA
JEY
- JERSEY
JOR
- JORDAN
JPN
- JAPAN
KAZ
- KAZAKHSTAN
KEN
- KENYA
KGZ
- KYRGYZSTAN
KHM
- CAMBODIA
KIR
- KIRIBATI
KNA
- SAINT BARTHÉLEMY
KOR
- KOREA, REPUBLIC OF
KWT
- KUWAIT
LAO
- LAO PEOPLE’S DEMOCRATIC REPUBLIC
LBN
- LEBANON
LBR
- LIBERIA
LBY
- LIBYA
LCA
- SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
LIE
- LIECHTENSTEIN
LKA
- SRI LANKA
LSO
- LESOTHO
LTU
- LITHUANIA
LUX
- LUXEMBOURG
LVA
- LATVIA
MAC
- MACAO
MAF
- SAINT MARTIN (FRENCH PART)
MAR
- MOROCCO
MCO
- MONACO
MDA
- MOLDOVA, REPUBLIC OF
MDG
- MADAGASCAR
MDV
- MALDIVES
MEX
- MEXICO
MHL
- MARSHALL ISLANDS
MKD
- MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
MLI
- MALI
MLT
- MALTA
MMR
- MYANMAR
MNE
- MONTENEGRO
MNG
- MONGOLIA
MNP
- NORTHERN MARIANA ISLANDS
MOZ
- MOZAMBIQUE
MRT
- MAURITANIA
MSR
- MONTSERRAT
MTQ
- MARTINIQUE
MUS
- MAURITIUS
MWI
- MALAWI
MYS
- MALAYSIA
MYT
- MAYOTTE
NAM
- NAMIBIA
NCL
- NEW CALEDONIA
NER
- NIGER
NFK
- NORFOLK ISLAND
NGA
- NIGERIA
NIC
- NICARAGUA
NIU
- NIUE
NLD
- NETHERLANDS
NOR
- NORWAY
NPL
- NEPAL
NRU
- NAURU
NZL
- NEW ZEALAND
OMN
- OMAN
PAK
- PAKISTAN
PAN
- PANAMA
PCN
- PITCAIRN
PER
- PERU
PHL
- PHILIPPINES
PLW
- PALAU
PNG
- PAPUA NEW GUINEA
POL
- POLAND
PRI
- PUERTO RICO
PRK
- KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OF
PRT
- PORTUGAL
PRY
- PARAGUAY
PSE
- PALESTINIAN TERRITORY, OCCUPIED
PYF
- FRENCH POLYNESIA
QAT
- QATAR
REU
- RÉUNION
ROU
- ROMANIA
RUS
- RUSSIAN FEDERATION
RWA
- RWANDA
SAU
- SAUDI ARABIA
SDN
- SUDAN
SEN
- SENEGAL
SGP
- SINGAPORE
SGS
- SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
SHN
- SAN MARINO
SJM
- SVALBARD AND JAN MAYEN
SLB
- SOLOMON ISLANDS
SLE
- SIERRA LEONE
SLV
- EL SALVADOR
SMR
- SINT MAARTEN (DUTCH PART)
SOM
- SOMALIA
SPM
- HOLY SEE (VATICAN CITY STATE)
SRB
- SERBIA
SSD
- SOUTH SUDAN
STP
- SAO TOME AND PRINCIPE
SUR
- SURINAME
SVK
- SLOVAKIA
SVN
- SLOVENIA
SWE
- SWEDEN
SWZ
- SWAZILAND
SXM
- SAINT PIERRE AND MIQUELON
SYC
- SEYCHELLES
SYR
- SYRIAN ARAB REPUBLIC
TCA
- TURKS AND CAICOS ISLANDS
TCD
- CHAD
TGO
- TOGO
THA
- THAILAND
TJK
- TAJIKISTAN
TKL
- TOKELAU
TKM
- TURKMENISTAN
TLS
- TIMOR-LESTE
TON
- TONGA
TTO
- TRINIDAD AND TOBAGO
TUN
- TUNISIA
TUR
- TURKEY
TUV
- TUVALU
TWN
- TAIWAN, PROVINCE OF CHINA
TZA
- TANZANIA, UNITED REPUBLIC OF
UGA
- UGANDA
UKR
- UKRAINE
UMI
- UNITED STATES MINOR OUTLYING ISLANDS
URY
- URUGUAY
USA
- UNITED STATES
UZB
- UZBEKISTAN
VAT
- SAINT VINCENT AND THE GRENADINES
VCT
- SAINT LUCIA
VEN
- VENEZUELA, BOLIVARIAN REPUBLIC OF
VGB
- VIRGIN ISLANDS, BRITISH
VIR
- VIRGIN ISLANDS, U.S.
VNM
- VIET NAM
VUT
- VANUATU
WLF
- WALLIS AND FUTUNA
WSM
- SAMOA
YEM
- YEMEN
ZAF
- SOUTH AFRICA
ZMB
- ZAMBIA
ZWE
- ZIMBABWE
-
city
- presence
- Optional
- Interface version
- 2.0
City of the address.
-
company
- presence
- Optional
- Interface version
- 2.0
Company for the address.
-
addressAdditional1
- presence
- Optional
- Interface version
- 2.0
Addition 1 to the address.
-
addressAdditional2
- presence
- Optional
- Interface version
- 2.0
Addition 2 to the address.
-
postBox
- presence
- Optional
- Interface version
- 2.0
Post box for the address.
-
state
- presence
- Optional
- Interface version
- 2.0
Address state/department. To be completed in accordance with ISO 3166-2. The first two letters designate the country and the letters following the hyphen designate the subdivision, e.g. FR-ARA for the French region Auvergne-Rhône-Alpes.
-
street
- presence
- Optional
- Interface version
- 2.0
Name of the street of the address.
-
streetNumber
- presence
- Optional
- Interface version
- 2.0
Number of the street of the address.
-
zipCode
- presence
- Optional
- Interface version
- 2.0
Postal code for the address.
-
deliveryContact
- presence
- Optional
- Interface version
- 2.0
Contains the delivery contact’s information.
Contains
-
email
- presence
- Optional
- Interface version
- 2.0
Contact’s email address.
-
firstname
- presence
- Optional
- Interface version
- 2.0
First name of the contact.
-
gender
- presence
- Optional
- Interface version
- 2.0
Gender of the contact, male (=M) or female (=F).
-
initials
- presence
- Optional
- Interface version
- 2.2
contact initals
-
lastname
- presence
- Optional
- Interface version
- 2.0
Last name of the contact.
-
legalId
- presence
- Optional
- Interface version
- 2.4
Legal business identifier (SIRET in France). This field is applicable for merchant or customer (please see fields Contact).
-
mobile
- presence
- Optional
- Interface version
- 2.0
Mobile phone number for the contact.
-
phone
- presence
- Optional
- Interface version
- 2.0
Telephone number for the contact.
-
positionOccupied
- presence
- Optional
- Interface version
- 2.4
Position occupied.
-
title
- presence
- Optional
- Interface version
- 2.0
Title of the contact.
-
fraudData
- presence
- Optional
- Interface version
- 2.0
Contains the transaction’s antifraud rules parameters, allowing the merchant to dynamically customise the rules registered in the merchant configuration.
Contains
-
allowedIpCountryList
- presence
- Optional
- Interface version
- 2.0
List of buyer IP country codes allowed to make a paymentISO 3166 list of country codes.
List of values
ABW
- ARUBA
AFG
- AFGHANISTAN
AGO
- ANGOLA
AIA
- ANGUILLA
ALA
- ÅLAND ISLANDS
ALB
- ALBANIA
AND
- ANDORRA
ARE
- UNITED ARAB EMIRATES
ARG
- ARGENTINA
ARM
- ARMENIA
ASM
- AMERICAN SAMOA
ATA
- ANTARCTICA
ATF
- FRENCH SOUTHERN TERRITORIES
ATG
- ANTIGUA AND BARBUDA
AUS
- AUSTRALIA
AUT
- AUSTRIA
AZE
- AZERBAIJAN
BDI
- BURUNDI
BEL
- BELGIUM
BEN
- BENIN
BES
- BONAIRE, SINT EUSTATIUS AND SABA
BFA
- BURKINA FASO
BGD
- BANGLADESH
BGR
- BULGARIA
BHR
- BAHRAIN
BHS
- BAHAMAS
BIH
- BOSNIA AND HERZEGOVINA
BLM
- SAINT KITTS AND NEVIS
BLR
- BELARUS
BLZ
- BELIZE
BMU
- BERMUDA
BOL
- BOLIVIA, PLURINATIONAL STATE OF
BRA
- BRAZIL
BRB
- BARBADOS
BRN
- BRUNEI DARUSSALAM
BTN
- BHUTAN
BVT
- BOUVET ISLAND
BWA
- BOTSWANA
CAF
- CENTRAL AFRICAN REPUBLIC
CAN
- CANADA
CCK
- COCOS (KEELING) ISLANDS
CHE
- SWITZERLAND
CHL
- CHILE
CHN
- CHINA
CIV
- CÔTE D’IVOIRE
CMR
- CAMEROON
COD
- CONGO, THE DEMOCRATIC REPUBLIC OF THE
COG
- CONGO
COK
- COOK ISLANDS
COL
- COLOMBIA
COM
- COMOROS
CPV
- CAPE VERDE
CRI
- COSTA RICA
CUB
- CUBA
CUW
- CURAÇAO
CXR
- CHRISTMAS ISLAND
CYM
- CAYMAN ISLANDS
CYP
- CYPRUS
CZE
- CZECH REPUBLIC
DEU
- GERMANY
DJI
- DJIBOUTI
DMA
- DOMINICA
DNK
- DENMARK
DOM
- DOMINICAN REPUBLIC
DZA
- ALGERIA
ECU
- ECUADOR
EGY
- EGYPT
ERI
- ERITREA
ESH
- WESTERN SAHARA
ESP
- SPAIN
EST
- ESTONIA
ETH
- ETHIOPIA
FIN
- FINLAND
FJI
- FIJI
FLK
- FALKLAND ISLANDS (MALVINAS)
FRA
- FRANCE
FRO
- FAROE ISLANDS
FSM
- MICRONESIA, FEDERATED STATES OF
GAB
- GABON
GBR
- UNITED KINGDOM
GEO
- GEORGIA
GGY
- GUERNSEY
GHA
- GHANA
GIB
- GIBRALTAR
GIN
- GUINEA
GLP
- GUADELOUPE
GMB
- GAMBIA
GNB
- GUINEA-BISSAU
GNQ
- EQUATORIAL GUINEA
GRC
- GREECE
GRD
- GRENADA
GRL
- GREENLAND
GTM
- GUATEMALA
GUF
- FRENCH GUIANA
GUM
- GUAM
GUY
- GUYANA
HKG
- HONG KONG
HMD
- HEARD ISLAND AND MCDONALD ISLANDS
HND
- HONDURAS
HRV
- CROATIA
HTI
- HAITI
HUN
- HUNGARY
IDN
- INDONESIA
IMN
- ISLE OF MAN
IND
- INDIA
IOT
- BRITISH INDIAN OCEAN TERRITORY
IRL
- IRELAND
IRN
- IRAN, ISLAMIC REPUBLIC OF
IRQ
- IRAQ
ISL
- ICELAND
ISR
- ISRAEL
ITA
- ITALY
JAM
- JAMAICA
JEY
- JERSEY
JOR
- JORDAN
JPN
- JAPAN
KAZ
- KAZAKHSTAN
KEN
- KENYA
KGZ
- KYRGYZSTAN
KHM
- CAMBODIA
KIR
- KIRIBATI
KNA
- SAINT BARTHÉLEMY
KOR
- KOREA, REPUBLIC OF
KWT
- KUWAIT
LAO
- LAO PEOPLE’S DEMOCRATIC REPUBLIC
LBN
- LEBANON
LBR
- LIBERIA
LBY
- LIBYA
LCA
- SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
LIE
- LIECHTENSTEIN
LKA
- SRI LANKA
LSO
- LESOTHO
LTU
- LITHUANIA
LUX
- LUXEMBOURG
LVA
- LATVIA
MAC
- MACAO
MAF
- SAINT MARTIN (FRENCH PART)
MAR
- MOROCCO
MCO
- MONACO
MDA
- MOLDOVA, REPUBLIC OF
MDG
- MADAGASCAR
MDV
- MALDIVES
MEX
- MEXICO
MHL
- MARSHALL ISLANDS
MKD
- MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
MLI
- MALI
MLT
- MALTA
MMR
- MYANMAR
MNE
- MONTENEGRO
MNG
- MONGOLIA
MNP
- NORTHERN MARIANA ISLANDS
MOZ
- MOZAMBIQUE
MRT
- MAURITANIA
MSR
- MONTSERRAT
MTQ
- MARTINIQUE
MUS
- MAURITIUS
MWI
- MALAWI
MYS
- MALAYSIA
MYT
- MAYOTTE
NAM
- NAMIBIA
NCL
- NEW CALEDONIA
NER
- NIGER
NFK
- NORFOLK ISLAND
NGA
- NIGERIA
NIC
- NICARAGUA
NIU
- NIUE
NLD
- NETHERLANDS
NOR
- NORWAY
NPL
- NEPAL
NRU
- NAURU
NZL
- NEW ZEALAND
OMN
- OMAN
PAK
- PAKISTAN
PAN
- PANAMA
PCN
- PITCAIRN
PER
- PERU
PHL
- PHILIPPINES
PLW
- PALAU
PNG
- PAPUA NEW GUINEA
POL
- POLAND
PRI
- PUERTO RICO
PRK
- KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OF
PRT
- PORTUGAL
PRY
- PARAGUAY
PSE
- PALESTINIAN TERRITORY, OCCUPIED
PYF
- FRENCH POLYNESIA
QAT
- QATAR
REU
- RÉUNION
ROU
- ROMANIA
RUS
- RUSSIAN FEDERATION
RWA
- RWANDA
SAU
- SAUDI ARABIA
SDN
- SUDAN
SEN
- SENEGAL
SGP
- SINGAPORE
SGS
- SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
SHN
- SAN MARINO
SJM
- SVALBARD AND JAN MAYEN
SLB
- SOLOMON ISLANDS
SLE
- SIERRA LEONE
SLV
- EL SALVADOR
SMR
- SINT MAARTEN (DUTCH PART)
SOM
- SOMALIA
SPM
- HOLY SEE (VATICAN CITY STATE)
SRB
- SERBIA
SSD
- SOUTH SUDAN
STP
- SAO TOME AND PRINCIPE
SUR
- SURINAME
SVK
- SLOVAKIA
SVN
- SLOVENIA
SWE
- SWEDEN
SWZ
- SWAZILAND
SXM
- SAINT PIERRE AND MIQUELON
SYC
- SEYCHELLES
SYR
- SYRIAN ARAB REPUBLIC
TCA
- TURKS AND CAICOS ISLANDS
TCD
- CHAD
TGO
- TOGO
THA
- THAILAND
TJK
- TAJIKISTAN
TKL
- TOKELAU
TKM
- TURKMENISTAN
TLS
- TIMOR-LESTE
TON
- TONGA
TTO
- TRINIDAD AND TOBAGO
TUN
- TUNISIA
TUR
- TURKEY
TUV
- TUVALU
TWN
- TAIWAN, PROVINCE OF CHINA
TZA
- TANZANIA, UNITED REPUBLIC OF
UGA
- UGANDA
UKR
- UKRAINE
UMI
- UNITED STATES MINOR OUTLYING ISLANDS
URY
- URUGUAY
USA
- UNITED STATES
UZB
- UZBEKISTAN
VAT
- SAINT VINCENT AND THE GRENADINES
VCT
- SAINT LUCIA
VEN
- VENEZUELA, BOLIVARIAN REPUBLIC OF
VGB
- VIRGIN ISLANDS, BRITISH
VIR
- VIRGIN ISLANDS, U.S.
VNM
- VIET NAM
VUT
- VANUATU
WLF
- WALLIS AND FUTUNA
WSM
- SAMOA
YEM
- YEMEN
ZAF
- SOUTH AFRICA
ZMB
- ZAMBIA
ZWE
- ZIMBABWE
-
deniedIpCountryList
- presence
- Optional
- Interface version
- 2.0
List of buyer IP country codes not authorised to make a paymentISO 3166 list of country codes.
List of values
ABW
- ARUBA
AFG
- AFGHANISTAN
AGO
- ANGOLA
AIA
- ANGUILLA
ALA
- ÅLAND ISLANDS
ALB
- ALBANIA
AND
- ANDORRA
ARE
- UNITED ARAB EMIRATES
ARG
- ARGENTINA
ARM
- ARMENIA
ASM
- AMERICAN SAMOA
ATA
- ANTARCTICA
ATF
- FRENCH SOUTHERN TERRITORIES
ATG
- ANTIGUA AND BARBUDA
AUS
- AUSTRALIA
AUT
- AUSTRIA
AZE
- AZERBAIJAN
BDI
- BURUNDI
BEL
- BELGIUM
BEN
- BENIN
BES
- BONAIRE, SINT EUSTATIUS AND SABA
BFA
- BURKINA FASO
BGD
- BANGLADESH
BGR
- BULGARIA
BHR
- BAHRAIN
BHS
- BAHAMAS
BIH
- BOSNIA AND HERZEGOVINA
BLM
- SAINT KITTS AND NEVIS
BLR
- BELARUS
BLZ
- BELIZE
BMU
- BERMUDA
BOL
- BOLIVIA, PLURINATIONAL STATE OF
BRA
- BRAZIL
BRB
- BARBADOS
BRN
- BRUNEI DARUSSALAM
BTN
- BHUTAN
BVT
- BOUVET ISLAND
BWA
- BOTSWANA
CAF
- CENTRAL AFRICAN REPUBLIC
CAN
- CANADA
CCK
- COCOS (KEELING) ISLANDS
CHE
- SWITZERLAND
CHL
- CHILE
CHN
- CHINA
CIV
- CÔTE D’IVOIRE
CMR
- CAMEROON
COD
- CONGO, THE DEMOCRATIC REPUBLIC OF THE
COG
- CONGO
COK
- COOK ISLANDS
COL
- COLOMBIA
COM
- COMOROS
CPV
- CAPE VERDE
CRI
- COSTA RICA
CUB
- CUBA
CUW
- CURAÇAO
CXR
- CHRISTMAS ISLAND
CYM
- CAYMAN ISLANDS
CYP
- CYPRUS
CZE
- CZECH REPUBLIC
DEU
- GERMANY
DJI
- DJIBOUTI
DMA
- DOMINICA
DNK
- DENMARK
DOM
- DOMINICAN REPUBLIC
DZA
- ALGERIA
ECU
- ECUADOR
EGY
- EGYPT
ERI
- ERITREA
ESH
- WESTERN SAHARA
ESP
- SPAIN
EST
- ESTONIA
ETH
- ETHIOPIA
FIN
- FINLAND
FJI
- FIJI
FLK
- FALKLAND ISLANDS (MALVINAS)
FRA
- FRANCE
FRO
- FAROE ISLANDS
FSM
- MICRONESIA, FEDERATED STATES OF
GAB
- GABON
GBR
- UNITED KINGDOM
GEO
- GEORGIA
GGY
- GUERNSEY
GHA
- GHANA
GIB
- GIBRALTAR
GIN
- GUINEA
GLP
- GUADELOUPE
GMB
- GAMBIA
GNB
- GUINEA-BISSAU
GNQ
- EQUATORIAL GUINEA
GRC
- GREECE
GRD
- GRENADA
GRL
- GREENLAND
GTM
- GUATEMALA
GUF
- FRENCH GUIANA
GUM
- GUAM
GUY
- GUYANA
HKG
- HONG KONG
HMD
- HEARD ISLAND AND MCDONALD ISLANDS
HND
- HONDURAS
HRV
- CROATIA
HTI
- HAITI
HUN
- HUNGARY
IDN
- INDONESIA
IMN
- ISLE OF MAN
IND
- INDIA
IOT
- BRITISH INDIAN OCEAN TERRITORY
IRL
- IRELAND
IRN
- IRAN, ISLAMIC REPUBLIC OF
IRQ
- IRAQ
ISL
- ICELAND
ISR
- ISRAEL
ITA
- ITALY
JAM
- JAMAICA
JEY
- JERSEY
JOR
- JORDAN
JPN
- JAPAN
KAZ
- KAZAKHSTAN
KEN
- KENYA
KGZ
- KYRGYZSTAN
KHM
- CAMBODIA
KIR
- KIRIBATI
KNA
- SAINT BARTHÉLEMY
KOR
- KOREA, REPUBLIC OF
KWT
- KUWAIT
LAO
- LAO PEOPLE’S DEMOCRATIC REPUBLIC
LBN
- LEBANON
LBR
- LIBERIA
LBY
- LIBYA
LCA
- SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
LIE
- LIECHTENSTEIN
LKA
- SRI LANKA
LSO
- LESOTHO
LTU
- LITHUANIA
LUX
- LUXEMBOURG
LVA
- LATVIA
MAC
- MACAO
MAF
- SAINT MARTIN (FRENCH PART)
MAR
- MOROCCO
MCO
- MONACO
MDA
- MOLDOVA, REPUBLIC OF
MDG
- MADAGASCAR
MDV
- MALDIVES
MEX
- MEXICO
MHL
- MARSHALL ISLANDS
MKD
- MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
MLI
- MALI
MLT
- MALTA
MMR
- MYANMAR
MNE
- MONTENEGRO
MNG
- MONGOLIA
MNP
- NORTHERN MARIANA ISLANDS
MOZ
- MOZAMBIQUE
MRT
- MAURITANIA
MSR
- MONTSERRAT
MTQ
- MARTINIQUE
MUS
- MAURITIUS
MWI
- MALAWI
MYS
- MALAYSIA
MYT
- MAYOTTE
NAM
- NAMIBIA
NCL
- NEW CALEDONIA
NER
- NIGER
NFK
- NORFOLK ISLAND
NGA
- NIGERIA
NIC
- NICARAGUA
NIU
- NIUE
NLD
- NETHERLANDS
NOR
- NORWAY
NPL
- NEPAL
NRU
- NAURU
NZL
- NEW ZEALAND
OMN
- OMAN
PAK
- PAKISTAN
PAN
- PANAMA
PCN
- PITCAIRN
PER
- PERU
PHL
- PHILIPPINES
PLW
- PALAU
PNG
- PAPUA NEW GUINEA
POL
- POLAND
PRI
- PUERTO RICO
PRK
- KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OF
PRT
- PORTUGAL
PRY
- PARAGUAY
PSE
- PALESTINIAN TERRITORY, OCCUPIED
PYF
- FRENCH POLYNESIA
QAT
- QATAR
REU
- RÉUNION
ROU
- ROMANIA
RUS
- RUSSIAN FEDERATION
RWA
- RWANDA
SAU
- SAUDI ARABIA
SDN
- SUDAN
SEN
- SENEGAL
SGP
- SINGAPORE
SGS
- SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
SHN
- SAN MARINO
SJM
- SVALBARD AND JAN MAYEN
SLB
- SOLOMON ISLANDS
SLE
- SIERRA LEONE
SLV
- EL SALVADOR
SMR
- SINT MAARTEN (DUTCH PART)
SOM
- SOMALIA
SPM
- HOLY SEE (VATICAN CITY STATE)
SRB
- SERBIA
SSD
- SOUTH SUDAN
STP
- SAO TOME AND PRINCIPE
SUR
- SURINAME
SVK
- SLOVAKIA
SVN
- SLOVENIA
SWE
- SWEDEN
SWZ
- SWAZILAND
SXM
- SAINT PIERRE AND MIQUELON
SYC
- SEYCHELLES
SYR
- SYRIAN ARAB REPUBLIC
TCA
- TURKS AND CAICOS ISLANDS
TCD
- CHAD
TGO
- TOGO
THA
- THAILAND
TJK
- TAJIKISTAN
TKL
- TOKELAU
TKM
- TURKMENISTAN
TLS
- TIMOR-LESTE
TON
- TONGA
TTO
- TRINIDAD AND TOBAGO
TUN
- TUNISIA
TUR
- TURKEY
TUV
- TUVALU
TWN
- TAIWAN, PROVINCE OF CHINA
TZA
- TANZANIA, UNITED REPUBLIC OF
UGA
- UGANDA
UKR
- UKRAINE
UMI
- UNITED STATES MINOR OUTLYING ISLANDS
URY
- URUGUAY
USA
- UNITED STATES
UZB
- UZBEKISTAN
VAT
- SAINT VINCENT AND THE GRENADINES
VCT
- SAINT LUCIA
VEN
- VENEZUELA, BOLIVARIAN REPUBLIC OF
VGB
- VIRGIN ISLANDS, BRITISH
VIR
- VIRGIN ISLANDS, U.S.
VNM
- VIET NAM
VUT
- VANUATU
WLF
- WALLIS AND FUTUNA
WSM
- SAMOA
YEM
- YEMEN
ZAF
- SOUTH AFRICA
ZMB
- ZAMBIA
ZWE
- ZIMBABWE
-
bypass3DS
- presence
- Optional
- Interface version
- 2.0
Indicator used by the merchant to bypass the 3-D Secure procedure.
List of values
ALL
- Bypass the 3DS procedure (for CB, VISA, MASTERCARD payments)
MERCHANT_WALLET
- Bypass the 3DS procedure during “OneClick” payment for CB, VISA, MASTERCARD payments
WIP_BANCONTACT
- Bypass the 3DS procedure during “OneClick” payment for BANCONTACT payment
-
bypassCtrlList
- presence
- Optional
- Interface version
- 2.0
List of antifraud rules provided by the merchant to bypass current transaction rules.
List of values
3DSStatus
- Disable the 3-D Secure authentication rule
All
- Disable all rules
BlackBic
- Disable the BIC blacklist rule
BlackBinCard
- Disable the BIN range blacklist rule
BlackCard
- Disable the Card number blacklist rule
BlackCustomerId
- Disable the Customer ID blacklist rule
BlackCustomerName
- Disable the Customer name blacklist rule
BlackEmail
- Disable the E-mail address blackslit rule
BlackIban
- Disable the IBAN blacklist rule
BlackIp
- Disable the IP address blacklist rule
BlackMandate
- Disable the Mandate blacklist rule
BlackPhoneNumber
- Disable the Phone number blacklist rule
BlackPostalCode
- Disable the Postal code blacklist rule
CBScheme
- Disable the CB scheme card rule
CapCollarAmount
- Disable the Amount range rule
CardCountry
- Disable the Card country rule
CommercialCard
- Disable the Commercial card (and card country) rule
ECard
- Disable the Virtual card rule
EmailSyntax
- Disable the E-mail address syntax rule
ExpiryDate
- Disable the Card expiry date rule
FreeEmail
- Disable the Free e-mail address rule
GreyBic
- Disable the BIC greylist rule
GreyBinCard
- Disable the BIN range greylist rule
GreyCard
- Disable the Card number greylist rule
GreyCustomerId
- Disable the Customer ID greylist rule
GreyCustomerName
- Disable the Customer name greylist rule
GreyEmail
- Disable the E-mail address greylist rule
GreyIban
- Disable the IBAN greylist rule
GreyIp
- Disable the IP address greylist rule
GreyMandate
- Disable the Mandate greylist rule
GreyPhoneNumber
- Disable the Phone number greylist rule
GreyPostalCode
- Disable the postal code greylist rule
HotList
- Disable the Lost and stolen card rule
IbanCountry
- Disable the IBAN country rule
IpCountry
- Disable the IP address country rule
IpReputations
- Disable the IP address reputation rule
MaxCardPerCustomerId
- Disable the Number of cards per customer rule
MaxCardPerIp
- Disable the Number of cards per IP address rule
MaxCustidPerIban
- Disable the Number of customers per IBAN rule
MaxCustomerIdPerCard
- Disable the Number of customers per card rule
MaxIbanPerCustid
- Disable the Number of IBAN per customer rule
MaxIbanPerIp
- Disable the Number of IBAN per IP address rule
MaxIpPerIban
- Disable the Number of IP address per IBAN rule
MaxMandatePerIp
- Disable the Number of mandates per IP address rule
MaxQuantityPerProduct
- Disable the Product quantity rule
PrepaidCardForbidden
- Disable the prepaid card rule
RiskyProductList
- Disable the Risky product list rule
RiskyProductQuantity
- Disable the Risky product quantity rule
RiskyProductRatio
- Disable the Risky product ratio rule
SimilarityBillingCardCountry
- Disable the Delivery and card country rule
SimilarityDeliveryBillingCountry
- Disable the Delivery and billing country rule
SimilarityDeliveryBillingPostalCode
- Disable the delivery and billing postal code rule
SimilarityDeliveryCardCountry
- Disable the Delivery and card country rule
SimilarityDeliveryIbanCountry
- Disable the Delivery and IBAN country rule
SimilarityIpCardCountry
- Disable the IP and card country rule
SimilarityIpIbanCountry
- Disable the IBAN country rule
SimilarityPhoneIbanCountry
- Disable the Phone and IBAN country rule
SystematicAuthorizationCard
- Disable the Systematic authorisation card rule
VelocityCard
- Disable the Card velocity rule
VelocityCustomerId
- Disable the Customer ID velocity rule
VelocityIban
- Disable the IBAN velocity rule
VelocityIp
- Disable the IP address velocity rule
VelocityMandate
- Disable the Mandate velocity rule
WhiteBic
- Disable the BIC whitelist rule
WhiteBinCard
- Disable the BIN range whitelist rule
WhiteCard
- Disable the Card number whitelist rule
WhiteCustomerId
- Disable the Customer ID whitelist rule
WhiteCustomerName
- Disable the Customer name whitelist rule
WhiteEmail
- Disable the E-mail address whitelist rule
WhiteIban
- Disable the IBAN whitelist rule
WhiteIp
- Disable the IP address whitelist rule
WhiteMandate
- Disable the Mandate whitelist rule
WhitePhoneNumber
- Disable the Phone number whitelist rule
WhitePostalCode
- Disable the Postal code whitelist rule
-
allowedCardArea
- presence
- Optional
- Interface version
- 2.0
List identifier of card countries allowed to make a payment. Countries are grouped by geographical area.
List of values
EEA
- Member States in the European Economic Area: AUT, BEL, BGR, CHE, CYP, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, GRC, HRV, HUN, IRL, ISL, ITA, LIE, LTU, LUX, LVA, MLT, NLD, NOR, POL, PRT, ROM, SVK, SVN, SWE
EFTA
- Member States in the free trade zone (European Free Trade Association): ISL, LIE, NOR, CHE
FRJEL
- List of countries authorised for French online games: AUT, BEL, BGR, CYP, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, GRC, MLT, NLD, NOR, POL, PRT, ROM, HUN, IRL, ISL, ITA, LTU, LUX, LVA, SVK, SVN, SWE
UEUR
- The Member States in the European Union: AUT, BEL, BGR, CYP, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, GRC, HRV, HUN, IRL, ITA, LTU, LUX, LVA, MLT, NLD, POL, PRT, ROM, SVK, SVN, SWE
ZEURO
- Member States in the Eurozone (EMU: Economic and Monetary Union): AUT, BEL, CYP, DEU, ESP, EST, FIN, FRA, GRC, IRL, ITA, LTU, LUX, LVA, MLT, NLD, PRT, SVK, SVN
-
allowedIpArea
- presence
- Optional
- Interface version
- 2.0
List identifier of IP countries allowed to make a payment.
List of values
EEA
- Member States in the European Economic Area: AUT, BEL, BGR, CHE, CYP, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, GRC, HRV, HUN, IRL, ISL, ITA, LIE, LTU, LUX, LVA, MLT, NLD, NOR, POL, PRT, ROM, SVK, SVN, SWE
EFTA
- Member States in the free trade zone (European Free Trade Association): ISL, LIE, NOR, CHE
FRJEL
- List of countries authorised for French online games: AUT, BEL, BGR, CYP, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, GRC, MLT, NLD, NOR, POL, PRT, ROM, HUN, IRL, ISL, ITA, LTU, LUX, LVA, SVK, SVN, SWE
UEUR
- The Member States in the European Union: AUT, BEL, BGR, CYP, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, GRC, HRV, HUN, IRL, ITA, LTU, LUX, LVA, MLT, NLD, POL, PRT, ROM, SVK, SVN, SWE
ZEURO
- Member States in the Eurozone (EMU: Economic and Monetary Union): AUT, BEL, CYP, DEU, ESP, EST, FIN, FRA, GRC, IRL, ITA, LTU, LUX, LVA, MLT, NLD, PRT, SVK, SVN
-
deniedCardArea
- presence
- Optional
- Interface version
- 2.0
Identifier of a predefined list of card countries refused by the merchant.
List of values
EEA
- Member States in the European Economic Area: AUT, BEL, BGR, CHE, CYP, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, GRC, HRV, HUN, IRL, ISL, ITA, LIE, LTU, LUX, LVA, MLT, NLD, NOR, POL, PRT, ROM, SVK, SVN, SWE
EFTA
- Member States in the free trade zone (European Free Trade Association): ISL, LIE, NOR, CHE
FRJEL
- List of countries authorised for French online games: AUT, BEL, BGR, CYP, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, GRC, MLT, NLD, NOR, POL, PRT, ROM, HUN, IRL, ISL, ITA, LTU, LUX, LVA, SVK, SVN, SWE
UEUR
- The Member States in the European Union: AUT, BEL, BGR, CYP, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, GRC, HRV, HUN, IRL, ITA, LTU, LUX, LVA, MLT, NLD, POL, PRT, ROM, SVK, SVN, SWE
ZEURO
- Member States in the Eurozone (EMU: Economic and Monetary Union): AUT, BEL, CYP, DEU, ESP, EST, FIN, FRA, GRC, IRL, ITA, LTU, LUX, LVA, MLT, NLD, PRT, SVK, SVN
-
deniedCardCountryList
- presence
- Optional
- Interface version
- 2.0
List of country codes for cards not authorised to make a payment
List of values
ABW
- ARUBA
AFG
- AFGHANISTAN
AGO
- ANGOLA
AIA
- ANGUILLA
ALA
- ÅLAND ISLANDS
ALB
- ALBANIA
AND
- ANDORRA
ARE
- UNITED ARAB EMIRATES
ARG
- ARGENTINA
ARM
- ARMENIA
ASM
- AMERICAN SAMOA
ATA
- ANTARCTICA
ATF
- FRENCH SOUTHERN TERRITORIES
ATG
- ANTIGUA AND BARBUDA
AUS
- AUSTRALIA
AUT
- AUSTRIA
AZE
- AZERBAIJAN
BDI
- BURUNDI
BEL
- BELGIUM
BEN
- BENIN
BES
- BONAIRE, SINT EUSTATIUS AND SABA
BFA
- BURKINA FASO
BGD
- BANGLADESH
BGR
- BULGARIA
BHR
- BAHRAIN
BHS
- BAHAMAS
BIH
- BOSNIA AND HERZEGOVINA
BLM
- SAINT KITTS AND NEVIS
BLR
- BELARUS
BLZ
- BELIZE
BMU
- BERMUDA
BOL
- BOLIVIA, PLURINATIONAL STATE OF
BRA
- BRAZIL
BRB
- BARBADOS
BRN
- BRUNEI DARUSSALAM
BTN
- BHUTAN
BVT
- BOUVET ISLAND
BWA
- BOTSWANA
CAF
- CENTRAL AFRICAN REPUBLIC
CAN
- CANADA
CCK
- COCOS (KEELING) ISLANDS
CHE
- SWITZERLAND
CHL
- CHILE
CHN
- CHINA
CIV
- CÔTE D’IVOIRE
CMR
- CAMEROON
COD
- CONGO, THE DEMOCRATIC REPUBLIC OF THE
COG
- CONGO
COK
- COOK ISLANDS
COL
- COLOMBIA
COM
- COMOROS
CPV
- CAPE VERDE
CRI
- COSTA RICA
CUB
- CUBA
CUW
- CURAÇAO
CXR
- CHRISTMAS ISLAND
CYM
- CAYMAN ISLANDS
CYP
- CYPRUS
CZE
- CZECH REPUBLIC
DEU
- GERMANY
DJI
- DJIBOUTI
DMA
- DOMINICA
DNK
- DENMARK
DOM
- DOMINICAN REPUBLIC
DZA
- ALGERIA
ECU
- ECUADOR
EGY
- EGYPT
ERI
- ERITREA
ESH
- WESTERN SAHARA
ESP
- SPAIN
EST
- ESTONIA
ETH
- ETHIOPIA
FIN
- FINLAND
FJI
- FIJI
FLK
- FALKLAND ISLANDS (MALVINAS)
FRA
- FRANCE
FRO
- FAROE ISLANDS
FSM
- MICRONESIA, FEDERATED STATES OF
GAB
- GABON
GBR
- UNITED KINGDOM
GEO
- GEORGIA
GGY
- GUERNSEY
GHA
- GHANA
GIB
- GIBRALTAR
GIN
- GUINEA
GLP
- GUADELOUPE
GMB
- GAMBIA
GNB
- GUINEA-BISSAU
GNQ
- EQUATORIAL GUINEA
GRC
- GREECE
GRD
- GRENADA
GRL
- GREENLAND
GTM
- GUATEMALA
GUF
- FRENCH GUIANA
GUM
- GUAM
GUY
- GUYANA
HKG
- HONG KONG
HMD
- HEARD ISLAND AND MCDONALD ISLANDS
HND
- HONDURAS
HRV
- CROATIA
HTI
- HAITI
HUN
- HUNGARY
IDN
- INDONESIA
IMN
- ISLE OF MAN
IND
- INDIA
IOT
- BRITISH INDIAN OCEAN TERRITORY
IRL
- IRELAND
IRN
- IRAN, ISLAMIC REPUBLIC OF
IRQ
- IRAQ
ISL
- ICELAND
ISR
- ISRAEL
ITA
- ITALY
JAM
- JAMAICA
JEY
- JERSEY
JOR
- JORDAN
JPN
- JAPAN
KAZ
- KAZAKHSTAN
KEN
- KENYA
KGZ
- KYRGYZSTAN
KHM
- CAMBODIA
KIR
- KIRIBATI
KNA
- SAINT BARTHÉLEMY
KOR
- KOREA, REPUBLIC OF
KWT
- KUWAIT
LAO
- LAO PEOPLE’S DEMOCRATIC REPUBLIC
LBN
- LEBANON
LBR
- LIBERIA
LBY
- LIBYA
LCA
- SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
LIE
- LIECHTENSTEIN
LKA
- SRI LANKA
LSO
- LESOTHO
LTU
- LITHUANIA
LUX
- LUXEMBOURG
LVA
- LATVIA
MAC
- MACAO
MAF
- SAINT MARTIN (FRENCH PART)
MAR
- MOROCCO
MCO
- MONACO
MDA
- MOLDOVA, REPUBLIC OF
MDG
- MADAGASCAR
MDV
- MALDIVES
MEX
- MEXICO
MHL
- MARSHALL ISLANDS
MKD
- MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
MLI
- MALI
MLT
- MALTA
MMR
- MYANMAR
MNE
- MONTENEGRO
MNG
- MONGOLIA
MNP
- NORTHERN MARIANA ISLANDS
MOZ
- MOZAMBIQUE
MRT
- MAURITANIA
MSR
- MONTSERRAT
MTQ
- MARTINIQUE
MUS
- MAURITIUS
MWI
- MALAWI
MYS
- MALAYSIA
MYT
- MAYOTTE
NAM
- NAMIBIA
NCL
- NEW CALEDONIA
NER
- NIGER
NFK
- NORFOLK ISLAND
NGA
- NIGERIA
NIC
- NICARAGUA
NIU
- NIUE
NLD
- NETHERLANDS
NOR
- NORWAY
NPL
- NEPAL
NRU
- NAURU
NZL
- NEW ZEALAND
OMN
- OMAN
PAK
- PAKISTAN
PAN
- PANAMA
PCN
- PITCAIRN
PER
- PERU
PHL
- PHILIPPINES
PLW
- PALAU
PNG
- PAPUA NEW GUINEA
POL
- POLAND
PRI
- PUERTO RICO
PRK
- KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OF
PRT
- PORTUGAL
PRY
- PARAGUAY
PSE
- PALESTINIAN TERRITORY, OCCUPIED
PYF
- FRENCH POLYNESIA
QAT
- QATAR
REU
- RÉUNION
ROU
- ROMANIA
RUS
- RUSSIAN FEDERATION
RWA
- RWANDA
SAU
- SAUDI ARABIA
SDN
- SUDAN
SEN
- SENEGAL
SGP
- SINGAPORE
SGS
- SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
SHN
- SAN MARINO
SJM
- SVALBARD AND JAN MAYEN
SLB
- SOLOMON ISLANDS
SLE
- SIERRA LEONE
SLV
- EL SALVADOR
SMR
- SINT MAARTEN (DUTCH PART)
SOM
- SOMALIA
SPM
- HOLY SEE (VATICAN CITY STATE)
SRB
- SERBIA
SSD
- SOUTH SUDAN
STP
- SAO TOME AND PRINCIPE
SUR
- SURINAME
SVK
- SLOVAKIA
SVN
- SLOVENIA
SWE
- SWEDEN
SWZ
- SWAZILAND
SXM
- SAINT PIERRE AND MIQUELON
SYC
- SEYCHELLES
SYR
- SYRIAN ARAB REPUBLIC
TCA
- TURKS AND CAICOS ISLANDS
TCD
- CHAD
TGO
- TOGO
THA
- THAILAND
TJK
- TAJIKISTAN
TKL
- TOKELAU
TKM
- TURKMENISTAN
TLS
- TIMOR-LESTE
TON
- TONGA
TTO
- TRINIDAD AND TOBAGO
TUN
- TUNISIA
TUR
- TURKEY
TUV
- TUVALU
TWN
- TAIWAN, PROVINCE OF CHINA
TZA
- TANZANIA, UNITED REPUBLIC OF
UGA
- UGANDA
UKR
- UKRAINE
UMI
- UNITED STATES MINOR OUTLYING ISLANDS
URY
- URUGUAY
USA
- UNITED STATES
UZB
- UZBEKISTAN
VAT
- SAINT VINCENT AND THE GRENADINES
VCT
- SAINT LUCIA
VEN
- VENEZUELA, BOLIVARIAN REPUBLIC OF
VGB
- VIRGIN ISLANDS, BRITISH
VIR
- VIRGIN ISLANDS, U.S.
VNM
- VIET NAM
VUT
- VANUATU
WLF
- WALLIS AND FUTUNA
WSM
- SAMOA
YEM
- YEMEN
ZAF
- SOUTH AFRICA
ZMB
- ZAMBIA
ZWE
- ZIMBABWE
-
allowedCardCountryList
- presence
- Optional
- Interface version
- 2.0
List of card country codes allowed to make a payment. ISO 3166 list of country codes.
List of values
ABW
- ARUBA
AFG
- AFGHANISTAN
AGO
- ANGOLA
AIA
- ANGUILLA
ALA
- ÅLAND ISLANDS
ALB
- ALBANIA
AND
- ANDORRA
ARE
- UNITED ARAB EMIRATES
ARG
- ARGENTINA
ARM
- ARMENIA
ASM
- AMERICAN SAMOA
ATA
- ANTARCTICA
ATF
- FRENCH SOUTHERN TERRITORIES
ATG
- ANTIGUA AND BARBUDA
AUS
- AUSTRALIA
AUT
- AUSTRIA
AZE
- AZERBAIJAN
BDI
- BURUNDI
BEL
- BELGIUM
BEN
- BENIN
BES
- BONAIRE, SINT EUSTATIUS AND SABA
BFA
- BURKINA FASO
BGD
- BANGLADESH
BGR
- BULGARIA
BHR
- BAHRAIN
BHS
- BAHAMAS
BIH
- BOSNIA AND HERZEGOVINA
BLM
- SAINT KITTS AND NEVIS
BLR
- BELARUS
BLZ
- BELIZE
BMU
- BERMUDA
BOL
- BOLIVIA, PLURINATIONAL STATE OF
BRA
- BRAZIL
BRB
- BARBADOS
BRN
- BRUNEI DARUSSALAM
BTN
- BHUTAN
BVT
- BOUVET ISLAND
BWA
- BOTSWANA
CAF
- CENTRAL AFRICAN REPUBLIC
CAN
- CANADA
CCK
- COCOS (KEELING) ISLANDS
CHE
- SWITZERLAND
CHL
- CHILE
CHN
- CHINA
CIV
- CÔTE D’IVOIRE
CMR
- CAMEROON
COD
- CONGO, THE DEMOCRATIC REPUBLIC OF THE
COG
- CONGO
COK
- COOK ISLANDS
COL
- COLOMBIA
COM
- COMOROS
CPV
- CAPE VERDE
CRI
- COSTA RICA
CUB
- CUBA
CUW
- CURAÇAO
CXR
- CHRISTMAS ISLAND
CYM
- CAYMAN ISLANDS
CYP
- CYPRUS
CZE
- CZECH REPUBLIC
DEU
- GERMANY
DJI
- DJIBOUTI
DMA
- DOMINICA
DNK
- DENMARK
DOM
- DOMINICAN REPUBLIC
DZA
- ALGERIA
ECU
- ECUADOR
EGY
- EGYPT
ERI
- ERITREA
ESH
- WESTERN SAHARA
ESP
- SPAIN
EST
- ESTONIA
ETH
- ETHIOPIA
FIN
- FINLAND
FJI
- FIJI
FLK
- FALKLAND ISLANDS (MALVINAS)
FRA
- FRANCE
FRO
- FAROE ISLANDS
FSM
- MICRONESIA, FEDERATED STATES OF
GAB
- GABON
GBR
- UNITED KINGDOM
GEO
- GEORGIA
GGY
- GUERNSEY
GHA
- GHANA
GIB
- GIBRALTAR
GIN
- GUINEA
GLP
- GUADELOUPE
GMB
- GAMBIA
GNB
- GUINEA-BISSAU
GNQ
- EQUATORIAL GUINEA
GRC
- GREECE
GRD
- GRENADA
GRL
- GREENLAND
GTM
- GUATEMALA
GUF
- FRENCH GUIANA
GUM
- GUAM
GUY
- GUYANA
HKG
- HONG KONG
HMD
- HEARD ISLAND AND MCDONALD ISLANDS
HND
- HONDURAS
HRV
- CROATIA
HTI
- HAITI
HUN
- HUNGARY
IDN
- INDONESIA
IMN
- ISLE OF MAN
IND
- INDIA
IOT
- BRITISH INDIAN OCEAN TERRITORY
IRL
- IRELAND
IRN
- IRAN, ISLAMIC REPUBLIC OF
IRQ
- IRAQ
ISL
- ICELAND
ISR
- ISRAEL
ITA
- ITALY
JAM
- JAMAICA
JEY
- JERSEY
JOR
- JORDAN
JPN
- JAPAN
KAZ
- KAZAKHSTAN
KEN
- KENYA
KGZ
- KYRGYZSTAN
KHM
- CAMBODIA
KIR
- KIRIBATI
KNA
- SAINT BARTHÉLEMY
KOR
- KOREA, REPUBLIC OF
KWT
- KUWAIT
LAO
- LAO PEOPLE’S DEMOCRATIC REPUBLIC
LBN
- LEBANON
LBR
- LIBERIA
LBY
- LIBYA
LCA
- SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
LIE
- LIECHTENSTEIN
LKA
- SRI LANKA
LSO
- LESOTHO
LTU
- LITHUANIA
LUX
- LUXEMBOURG
LVA
- LATVIA
MAC
- MACAO
MAF
- SAINT MARTIN (FRENCH PART)
MAR
- MOROCCO
MCO
- MONACO
MDA
- MOLDOVA, REPUBLIC OF
MDG
- MADAGASCAR
MDV
- MALDIVES
MEX
- MEXICO
MHL
- MARSHALL ISLANDS
MKD
- MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
MLI
- MALI
MLT
- MALTA
MMR
- MYANMAR
MNE
- MONTENEGRO
MNG
- MONGOLIA
MNP
- NORTHERN MARIANA ISLANDS
MOZ
- MOZAMBIQUE
MRT
- MAURITANIA
MSR
- MONTSERRAT
MTQ
- MARTINIQUE
MUS
- MAURITIUS
MWI
- MALAWI
MYS
- MALAYSIA
MYT
- MAYOTTE
NAM
- NAMIBIA
NCL
- NEW CALEDONIA
NER
- NIGER
NFK
- NORFOLK ISLAND
NGA
- NIGERIA
NIC
- NICARAGUA
NIU
- NIUE
NLD
- NETHERLANDS
NOR
- NORWAY
NPL
- NEPAL
NRU
- NAURU
NZL
- NEW ZEALAND
OMN
- OMAN
PAK
- PAKISTAN
PAN
- PANAMA
PCN
- PITCAIRN
PER
- PERU
PHL
- PHILIPPINES
PLW
- PALAU
PNG
- PAPUA NEW GUINEA
POL
- POLAND
PRI
- PUERTO RICO
PRK
- KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OF
PRT
- PORTUGAL
PRY
- PARAGUAY
PSE
- PALESTINIAN TERRITORY, OCCUPIED
PYF
- FRENCH POLYNESIA
QAT
- QATAR
REU
- RÉUNION
ROU
- ROMANIA
RUS
- RUSSIAN FEDERATION
RWA
- RWANDA
SAU
- SAUDI ARABIA
SDN
- SUDAN
SEN
- SENEGAL
SGP
- SINGAPORE
SGS
- SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
SHN
- SAN MARINO
SJM
- SVALBARD AND JAN MAYEN
SLB
- SOLOMON ISLANDS
SLE
- SIERRA LEONE
SLV
- EL SALVADOR
SMR
- SINT MAARTEN (DUTCH PART)
SOM
- SOMALIA
SPM
- HOLY SEE (VATICAN CITY STATE)
SRB
- SERBIA
SSD
- SOUTH SUDAN
STP
- SAO TOME AND PRINCIPE
SUR
- SURINAME
SVK
- SLOVAKIA
SVN
- SLOVENIA
SWE
- SWEDEN
SWZ
- SWAZILAND
SXM
- SAINT PIERRE AND MIQUELON
SYC
- SEYCHELLES
SYR
- SYRIAN ARAB REPUBLIC
TCA
- TURKS AND CAICOS ISLANDS
TCD
- CHAD
TGO
- TOGO
THA
- THAILAND
TJK
- TAJIKISTAN
TKL
- TOKELAU
TKM
- TURKMENISTAN
TLS
- TIMOR-LESTE
TON
- TONGA
TTO
- TRINIDAD AND TOBAGO
TUN
- TUNISIA
TUR
- TURKEY
TUV
- TUVALU
TWN
- TAIWAN, PROVINCE OF CHINA
TZA
- TANZANIA, UNITED REPUBLIC OF
UGA
- UGANDA
UKR
- UKRAINE
UMI
- UNITED STATES MINOR OUTLYING ISLANDS
URY
- URUGUAY
USA
- UNITED STATES
UZB
- UZBEKISTAN
VAT
- SAINT VINCENT AND THE GRENADINES
VCT
- SAINT LUCIA
VEN
- VENEZUELA, BOLIVARIAN REPUBLIC OF
VGB
- VIRGIN ISLANDS, BRITISH
VIR
- VIRGIN ISLANDS, U.S.
VNM
- VIET NAM
VUT
- VANUATU
WLF
- WALLIS AND FUTUNA
WSM
- SAMOA
YEM
- YEMEN
ZAF
- SOUTH AFRICA
ZMB
- ZAMBIA
ZWE
- ZIMBABWE
-
deniedIpArea
- presence
- Optional
- Interface version
- 2.0
Name of a pre-established list of buyer IP country codes not authorised to make a payment.
List of values
EEA
- Member States in the European Economic Area: AUT, BEL, BGR, CHE, CYP, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, GRC, HRV, HUN, IRL, ISL, ITA, LIE, LTU, LUX, LVA, MLT, NLD, NOR, POL, PRT, ROM, SVK, SVN, SWE
EFTA
- Member States in the free trade zone (European Free Trade Association): ISL, LIE, NOR, CHE
FRJEL
- List of countries authorised for French online games: AUT, BEL, BGR, CYP, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, GRC, MLT, NLD, NOR, POL, PRT, ROM, HUN, IRL, ISL, ITA, LTU, LUX, LVA, SVK, SVN, SWE
UEUR
- The Member States in the European Union: AUT, BEL, BGR, CYP, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, GRC, HRV, HUN, IRL, ITA, LTU, LUX, LVA, MLT, NLD, POL, PRT, ROM, SVK, SVN, SWE
ZEURO
- Member States in the Eurozone (EMU: Economic and Monetary Union): AUT, BEL, CYP, DEU, ESP, EST, FIN, FRA, GRC, IRL, ITA, LTU, LUX, LVA, MLT, NLD, PRT, SVK, SVN
-
bypassInfoList
- presence
- Optional
- Interface version
- 2.0
List of information provided by the merchant to bypass fraud information.
List of values
Card
- Bypass informations about card
IpCountry
- Bypass all information
-
riskManagementDynamicSettingList
- presence
- Optional
- Interface version
- 2.0
List of parameters of th setting information related to the antifraud rules to be dynamically overwritten.
Contains
-
riskManagementDynamicSetting
- presence
- Optional
- Interface version
- 2.0
Parameters of the Setting information related to the antifraud rule to be dynamically overwritten.
Contains
-
riskManagementDynamicParam
- presence
- Optional
- Interface version
- 2.0
Parameter regarding the antifraud rule that is to be dynamically overwritten.
List of values
AllowedBillingCardCountryCombiList
- Deprecated value. For the “Billing and card country” rule, the parameter contains the list of the combinations of allowed billing country and card country to overwrite.
AllowedCardCountryList
- Deprecated value. For the “Card country” rule, the parameter contains the list of allowed card countries to overwrite.
AllowedCommercialCardCountryList
- Deprecated value. For “Commercial card (and card country)” rule, the parameter contains the list of allowed commercial card countries to overwrite.
AllowedDeliveryCardCountryCombiList
- Deprecated value. For the “Delivery and card country” rule, the parameter contains the list of the combinations of allowed delivery country and card country to overwrite.
AllowedIpCardCountryCombiList
- Deprecated value. For the “IP and card country” rule, the parameter contains the list of the combinations of allowed card country and IP address country to overwrite.
AllowedIpCountryList
- Deprecated value. For the “IP address country” rule, the parameter contains the list of allowed IP address countries to overwrite.
DeniedBillingCardCountryCombiList
- Deprecated value. For the “Billing and card country” rule, the parameter contains the list of the combinations of denied billing country and card country to overwrite.
DeniedCardCountryList
- Deprecated value. For the “Card country” rule, the parameter contains the list of denied card countries to overwrite.
DeniedCommercialCardCountryList
- Deprecated value. For “Commercial card (and card country)” rule, the parameter contains the list of denied commercial card countries to overwrite.
DeniedDeliveryCardCountryCombiList
- Deprecated value. For the “Delivery and card country” rule, the parameter contains the list of the combinations of denied delivery country and card country to overwrite.
DeniedIpCardCountryCombiList
- Deprecated value. For the “IP and card country” rule, the parameter contains the list of the combinations of denied card country and IP address country to overwrite.
DeniedIpCountryList
- Deprecated value. For the “IP address country” rule, the parameter contains the list of denied IP address countries to overwrite.
NDeniedBillingCardCountryCombiList
- Denied card and billing country combinations list
NDeniedCardCountryList
- Denied card country list
NDeniedCommercialCardCountryList
- Denied corprate card country list
NDeniedDeliveryCardCountryCombiList
- Denied card and delivery country combinations list
NDeniedDeliveryIbanCountryCombiList
- Denied IBAN and delivery country combinations list
NDeniedExceptBillingCardCountryCombiList
- Denied card and billing country combinations except…
NDeniedExceptCardCountryList
- Denied card countries except…
NDeniedExceptCommercialCardCountryList
- Denied corprate card countries except…
NDeniedExceptDeliveryCardCountryCombiList
- Denied card and delivery country combinations except…
NDeniedExceptDeliveryIbanCountryCombiList
- Denied IBAN and delivery country combinations except…
NDeniedExceptIbanCountryList
- Denied IBAN countries except…
NDeniedExceptIpCardCountryCombiList
- Denied card and IP address country combinations except…
NDeniedExceptIpCountryList
- Denied IP address countries except…
NDeniedExceptIpIbanCountryCombiList
- Denied IBAN and IP address country combinations except…
NDeniedExceptPhoneIbanCountryCombiList
- Denied phone number and delivery country combinations except…
NDeniedIbanCountryList
- Denied IBAN country list
NDeniedIpCardCountryCombiList
- Denied card and IP address country combinations list
NDeniedIpCountryList
- Denied IP address country list
NDeniedIpIbanCountryCombiList
- Denied IBAN and IP address country combinations list
NDeniedPhoneIbanCountryCombiList
- Denied phone number and delivery country combinations list
PAllowedBillingCardCountryCombiList
- Encouraged card and billing country combinations list
PAllowedCardCountryList
- Encouraged card country list
PAllowedCommercialCardCountryList
- Encouraged corprate card country list
PAllowedDeliveryCardCountryCombiList
- Encouraged card and delivery country combinations list
PAllowedDeliveryIbanCountryCombiList
- Encouraged IBAN and delivery country combinations list
PAllowedEncouragedIbanCountryList
- Encouraged IBAN country list
PAllowedExceptBillingCardCountryCombiList
- Encouraged card and billing country combinations except…
PAllowedExceptCardCountryList
- Encouraged card countries except…
PAllowedExceptCommercialCardCountryList
- Encouraged corprate card countries except…
PAllowedExceptDeliveryCardCountryCombiList
- Encouraged card and delivery country combinations except…
PAllowedExceptDeliveryIbanCountryCombiList
- Encouraged IBAN and delivery country combinations except…
PAllowedExceptIpCardCountryCombiList
- Encouraged card and IP address country combinations except…
PAllowedExceptIpCountryList
- Encouraged IP address countries except…
PAllowedExceptIpIbanCountryCombiList
- Encouraged IBAN and IP address country combinations except…
PAllowedExceptPhoneIbanCountryCombiList
- Encouraged phone number and delivery country combinations except…
PAllowedIbanCountryList
- Encouraged IBAN countries except…
PAllowedIpCardCountryCombiList
- Encouraged card and IP address country combinations list
PAllowedIpCountryList
- Encouraged IP address country list
PAllowedIpIbanCountryCombiList
- Encouraged IBAN and IP address country combinations list
PAllowedPhoneIbanCountryCombiList
- Encouraged phone number and delivery country combinations list
-
riskManagementDynamicValue
- presence
- Optional
- Interface version
- 2.0
New parameter value regarding to the antifraud rule to be dynamically overwritten.
-
holderAddress
- presence
- Optional
- Interface version
- 2.0
Contains the payment mean holder’s address information.
Contains
-
addressAdditional3
- presence
- Optional
- Interface version
- 2.0
Addition 3 to the address.
-
businessName
- presence
- Optional
- Interface version
- 2.4
Business name.
-
country
- presence
- Optional
- Interface version
- 2.0
Country code for the address.
List of values
ABW
- ARUBA
AFG
- AFGHANISTAN
AGO
- ANGOLA
AIA
- ANGUILLA
ALA
- ÅLAND ISLANDS
ALB
- ALBANIA
AND
- ANDORRA
ARE
- UNITED ARAB EMIRATES
ARG
- ARGENTINA
ARM
- ARMENIA
ASM
- AMERICAN SAMOA
ATA
- ANTARCTICA
ATF
- FRENCH SOUTHERN TERRITORIES
ATG
- ANTIGUA AND BARBUDA
AUS
- AUSTRALIA
AUT
- AUSTRIA
AZE
- AZERBAIJAN
BDI
- BURUNDI
BEL
- BELGIUM
BEN
- BENIN
BES
- BONAIRE, SINT EUSTATIUS AND SABA
BFA
- BURKINA FASO
BGD
- BANGLADESH
BGR
- BULGARIA
BHR
- BAHRAIN
BHS
- BAHAMAS
BIH
- BOSNIA AND HERZEGOVINA
BLM
- SAINT KITTS AND NEVIS
BLR
- BELARUS
BLZ
- BELIZE
BMU
- BERMUDA
BOL
- BOLIVIA, PLURINATIONAL STATE OF
BRA
- BRAZIL
BRB
- BARBADOS
BRN
- BRUNEI DARUSSALAM
BTN
- BHUTAN
BVT
- BOUVET ISLAND
BWA
- BOTSWANA
CAF
- CENTRAL AFRICAN REPUBLIC
CAN
- CANADA
CCK
- COCOS (KEELING) ISLANDS
CHE
- SWITZERLAND
CHL
- CHILE
CHN
- CHINA
CIV
- CÔTE D’IVOIRE
CMR
- CAMEROON
COD
- CONGO, THE DEMOCRATIC REPUBLIC OF THE
COG
- CONGO
COK
- COOK ISLANDS
COL
- COLOMBIA
COM
- COMOROS
CPV
- CAPE VERDE
CRI
- COSTA RICA
CUB
- CUBA
CUW
- CURAÇAO
CXR
- CHRISTMAS ISLAND
CYM
- CAYMAN ISLANDS
CYP
- CYPRUS
CZE
- CZECH REPUBLIC
DEU
- GERMANY
DJI
- DJIBOUTI
DMA
- DOMINICA
DNK
- DENMARK
DOM
- DOMINICAN REPUBLIC
DZA
- ALGERIA
ECU
- ECUADOR
EGY
- EGYPT
ERI
- ERITREA
ESH
- WESTERN SAHARA
ESP
- SPAIN
EST
- ESTONIA
ETH
- ETHIOPIA
FIN
- FINLAND
FJI
- FIJI
FLK
- FALKLAND ISLANDS (MALVINAS)
FRA
- FRANCE
FRO
- FAROE ISLANDS
FSM
- MICRONESIA, FEDERATED STATES OF
GAB
- GABON
GBR
- UNITED KINGDOM
GEO
- GEORGIA
GGY
- GUERNSEY
GHA
- GHANA
GIB
- GIBRALTAR
GIN
- GUINEA
GLP
- GUADELOUPE
GMB
- GAMBIA
GNB
- GUINEA-BISSAU
GNQ
- EQUATORIAL GUINEA
GRC
- GREECE
GRD
- GRENADA
GRL
- GREENLAND
GTM
- GUATEMALA
GUF
- FRENCH GUIANA
GUM
- GUAM
GUY
- GUYANA
HKG
- HONG KONG
HMD
- HEARD ISLAND AND MCDONALD ISLANDS
HND
- HONDURAS
HRV
- CROATIA
HTI
- HAITI
HUN
- HUNGARY
IDN
- INDONESIA
IMN
- ISLE OF MAN
IND
- INDIA
IOT
- BRITISH INDIAN OCEAN TERRITORY
IRL
- IRELAND
IRN
- IRAN, ISLAMIC REPUBLIC OF
IRQ
- IRAQ
ISL
- ICELAND
ISR
- ISRAEL
ITA
- ITALY
JAM
- JAMAICA
JEY
- JERSEY
JOR
- JORDAN
JPN
- JAPAN
KAZ
- KAZAKHSTAN
KEN
- KENYA
KGZ
- KYRGYZSTAN
KHM
- CAMBODIA
KIR
- KIRIBATI
KNA
- SAINT BARTHÉLEMY
KOR
- KOREA, REPUBLIC OF
KWT
- KUWAIT
LAO
- LAO PEOPLE’S DEMOCRATIC REPUBLIC
LBN
- LEBANON
LBR
- LIBERIA
LBY
- LIBYA
LCA
- SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA
LIE
- LIECHTENSTEIN
LKA
- SRI LANKA
LSO
- LESOTHO
LTU
- LITHUANIA
LUX
- LUXEMBOURG
LVA
- LATVIA
MAC
- MACAO
MAF
- SAINT MARTIN (FRENCH PART)
MAR
- MOROCCO
MCO
- MONACO
MDA
- MOLDOVA, REPUBLIC OF
MDG
- MADAGASCAR
MDV
- MALDIVES
MEX
- MEXICO
MHL
- MARSHALL ISLANDS
MKD
- MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
MLI
- MALI
MLT
- MALTA
MMR
- MYANMAR
MNE
- MONTENEGRO
MNG
- MONGOLIA
MNP
- NORTHERN MARIANA ISLANDS
MOZ
- MOZAMBIQUE
MRT
- MAURITANIA
MSR
- MONTSERRAT
MTQ
- MARTINIQUE
MUS
- MAURITIUS
MWI
- MALAWI
MYS
- MALAYSIA
MYT
- MAYOTTE
NAM
- NAMIBIA
NCL
- NEW CALEDONIA
NER
- NIGER
NFK
- NORFOLK ISLAND
NGA
- NIGERIA
NIC
- NICARAGUA
NIU
- NIUE
NLD
- NETHERLANDS
NOR
- NORWAY
NPL
- NEPAL
NRU
- NAURU
NZL
- NEW ZEALAND
OMN
- OMAN
PAK
- PAKISTAN
PAN
- PANAMA
PCN
- PITCAIRN
PER
- PERU
PHL
- PHILIPPINES
PLW
- PALAU
PNG
- PAPUA NEW GUINEA
POL
- POLAND
PRI
- PUERTO RICO
PRK
- KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OF
PRT
- PORTUGAL
PRY
- PARAGUAY
PSE
- PALESTINIAN TERRITORY, OCCUPIED
PYF
- FRENCH POLYNESIA
QAT
- QATAR
REU
- RÉUNION
ROU
- ROMANIA
RUS
- RUSSIAN FEDERATION
RWA
- RWANDA
SAU
- SAUDI ARABIA
SDN
- SUDAN
SEN
- SENEGAL
SGP
- SINGAPORE
SGS
- SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
SHN
- SAN MARINO
SJM
- SVALBARD AND JAN MAYEN
SLB
- SOLOMON ISLANDS
SLE
- SIERRA LEONE
SLV
- EL SALVADOR
SMR
- SINT MAARTEN (DUTCH PART)
SOM
- SOMALIA
SPM
- HOLY SEE (VATICAN CITY STATE)
SRB
- SERBIA
SSD
- SOUTH SUDAN
STP
- SAO TOME AND PRINCIPE
SUR
- SURINAME
SVK
- SLOVAKIA
SVN
- SLOVENIA
SWE
- SWEDEN
SWZ
- SWAZILAND
SXM
- SAINT PIERRE AND MIQUELON
SYC
- SEYCHELLES
SYR
- SYRIAN ARAB REPUBLIC
TCA
- TURKS AND CAICOS ISLANDS
TCD
- CHAD
TGO
- TOGO
THA
- THAILAND
TJK
- TAJIKISTAN
TKL
- TOKELAU
TKM
- TURKMENISTAN
TLS
- TIMOR-LESTE
TON
- TONGA
TTO
- TRINIDAD AND TOBAGO
TUN
- TUNISIA
TUR
- TURKEY
TUV
- TUVALU
TWN
- TAIWAN, PROVINCE OF CHINA
TZA
- TANZANIA, UNITED REPUBLIC OF
UGA
- UGANDA
UKR
- UKRAINE
UMI
- UNITED STATES MINOR OUTLYING ISLANDS
URY
- URUGUAY
USA
- UNITED STATES
UZB
- UZBEKISTAN
VAT
- SAINT VINCENT AND THE GRENADINES
VCT
- SAINT LUCIA
VEN
- VENEZUELA, BOLIVARIAN REPUBLIC OF
VGB
- VIRGIN ISLANDS, BRITISH
VIR
- VIRGIN ISLANDS, U.S.
VNM
- VIET NAM
VUT
- VANUATU
WLF
- WALLIS AND FUTUNA
WSM
- SAMOA
YEM
- YEMEN
ZAF
- SOUTH AFRICA
ZMB
- ZAMBIA
ZWE
- ZIMBABWE
-
city
- presence
- Optional
- Interface version
- 2.0
City of the address.
-
company
- presence
- Optional
- Interface version
- 2.0
Company for the address.
-
addressAdditional1
- presence
- Optional
- Interface version
- 2.0
Addition 1 to the address.
-
addressAdditional2
- presence
- Optional
- Interface version
- 2.0
Addition 2 to the address.
-
postBox
- presence
- Optional
- Interface version
- 2.0
Post box for the address.
-
state
- presence
- Optional
- Interface version
- 2.0
Address state/department. To be completed in accordance with ISO 3166-2. The first two letters designate the country and the letters following the hyphen designate the subdivision, e.g. FR-ARA for the French region Auvergne-Rhône-Alpes.
-
street
- presence
- Optional
- Interface version
- 2.0
Name of the street of the address.
-
streetNumber
- presence
- Optional
- Interface version
- 2.0
Number of the street of the address.
-
zipCode
- presence
- Optional
- Interface version
- 2.0
Postal code for the address.
-
holderContact
- presence
- Optional
- Interface version
- 2.0
Contains contact details of the payment mean holder.
Contains
-
email
- presence
- Optional
- Interface version
- 2.0
Contact’s email address.
-
firstname
- presence
- Optional
- Interface version
- 2.0
First name of the contact.
-
gender
- presence
- Optional
- Interface version
- 2.0
Gender of the contact, male (=M) or female (=F).
-
initials
- presence
- Optional
- Interface version
- 2.2
contact initals
-
lastname
- presence
- Optional
- Interface version
- 2.0
Last name of the contact.
-
legalId
- presence
- Optional
- Interface version
- 2.4
Legal business identifier (SIRET in France). This field is applicable for merchant or customer (please see fields Contact).
-
mobile
- presence
- Optional
- Interface version
- 2.0
Mobile phone number for the contact.
-
phone
- presence
- Optional
- Interface version
- 2.0
Telephone number for the contact.
-
positionOccupied
- presence
- Optional
- Interface version
- 2.4
Position occupied.
-
title
- presence
- Optional
- Interface version
- 2.0
Title of the contact.
-
holderData
- presence
- Optional
- Interface version
- 2.0
Contains the payment mean holder’s information.
Contains
-
birthCity
- presence
- Optional
- Interface version
- 2.0
Birthplace.
-
birthCountry
- presence
- Optional
- Interface version
- 2.0
Country of birth.
-
birthZipCode
- presence
- Optional
- Interface version
- 2.0
Postal code for the birth.
-
birthDate
- presence
- Optional
- Interface version
- 2.0
Date of birth.
-
nationalityCountry
- presence
- Optional
- Interface version
- 2.0
Country of nationality.
-
newPassword
- presence
- Optional
- Interface version
- 2.0
Customer’s new password.
-
password
- presence
- Optional
- Interface version
- 2.0
Password.
-
interfaceVersionAutomaticResponse
- presence
- Optional
- Interface version
- 3.0
Automatic response version.
- Version syntax for Sogenactif Paypage with prefix AR_HP_ or AR_JS and version 2.x or 2x (example AR_HP_2.45 or AR_HP_245) or 3.x or 3x (example AR_JS_3.0 or AR_JS_30)
- Version syntax for Sogenactif Walletpage with prefix ARWI_HP or ARWI_JS and version 2.x or 2x (example ARWI_HP_2.4 or ARWI_HP_24) or 3.x or 3x (example ARWI_JS_3.0 or ARWI_JS_30).
-
interfaceVersionNormalResponse
- presence
- Optional
- Interface version
- 3.0
Manual response version.
- Version syntax for Sogenactif Paypage with prefix MR_HP_ or MR_JS and version 2.x or 2x (example MR_HP_2.45 or MR_HP_245) or 3.x or 3x (example MR_JS_3.0 or MR_JS_30)
- Version syntax for Sogenactif Walletpage with prefix MRWI_HP or MRWI_JS and version 2.x or 2x (example MRWI_HP_2.4 or MRWI_HP_24) or 3.x or 3x (example MRWI_JS_3.0 or MRWI_JS_30).
-
intermediateServiceProviderId
- presence
- Optional
- Interface version
- 2.2
Identifier of the Service used by the merchant for the exchanges with the Sogenactif platform.
-
mandateId
- presence
- Optional
- Interface version
- 2.4
Mandate number.
-
merchantName
- presence
- Optional
- Interface version
- 2.6
Merchant name (equivalent to the Merchant name registered during the Shop enrollment).If indicated in the payment request, allows to change the name displayed on the 3-D Secure authentication page.
-
merchantSessionId
- presence
- Optional
- Interface version
- 2.0
Merchant’s session number. Allows consolidation between requests and responses.
-
merchantUrl
- presence
- Optional
- Interface version
- 2.6
Merchant web site URL.
-
paymentMeanBrandList
- presence
- Optional
- Interface version
- 2.0
List of payment methods accepted for a transaction. If this field is not filled out, the Sogenactif server recovers the list of payment methods available for the configuration of the shop.
List of values
1EUROCOM
- Cofidis Pay 5x10x20x paymentMeanBrandType: ONLINE_CREDIT
3XCBCOFINOGA
- Deprecated. Cofinoga 3xCB paymentMeanBrandType: CARD
ACCEPTGIRO
- AcceptGiro paymentMeanBrandType: CREDIT_TRANSFER
ACCORD_3X
- Facily Pay 3 X payment paymentMeanBrandType: ONLINE_CREDIT
ACCORD_4X
- Facily Pay 4 X payment paymentMeanBrandType: ONLINE_CREDIT
AIRPLUS
- Airplus card paymentMeanBrandType: CARD
AIRPLUS_LOGEE
- Airplus logee card paymentMeanBrandType: CARD
AMEX
- American Express card paymentMeanBrandType: CARD
AMEX_LOGEE
- American Express logee card paymentMeanBrandType: CARD
APPLEPAY
- Apple Pay paymentMeanBrandType : CARD
AURORE
- CPAY card paymentMeanBrandType : CARD
BCACB_3X
- Floa Bank CB 3 X payment paymentMeanBrandType: ONLINE_CREDIT
BCACB_4X
- Floa Bank CB 4 X payment paymentMeanBrandType: ONLINE_CREDIT
BCACUP
- CUP card issued by Floa Bank paymentMeanBrandType: CARD
BCMC
- Bancontact paymentMeanBrandType: CARD
CACF_3X
- CACF 3 X payment paymentMeanBrandType: ONLINE_CREDIT
CACF_4X
- CACF 4 X payment paymentMeanBrandType: ONLINE_CREDIT
CADHOC
- Cadhoc paymentMeanBrandType: CARD
CADOCARTE
- Cado Carte paymentMeanBrandType: CARD
CB
- Carte Bancaire paymentMeanBrandType: CARD
CETELEM_3X
- Cetelem 3xCB paymentMeanBrandType: ONLINE_CREDIT
CETELEM_4X
- Cetelem 4xCB paymentMeanBrandType: ONLINE_CREDIT
COFIDIS_3X
- Cofidis 3xCB paymentMeanBrandType: ONLINE_CREDIT
COFIDIS_4X
- Cofidis 4xCB paymentMeanBrandType: ONLINE_CREDIT
CONECS
- Titres Restaurants Dématérialisés Conecs paymentMeanBrandType: VOUCHER
CUP
- China UnionPay card paymentMeanBrandType: CARD
CVA
- Visa Aurore card paymentMeanBrandType: CARD
CVCO
- Chèque-Vacances Connect paymentMeanBrandType: VOUCHER
DINERS
- Diners club international card paymentMeanBrandType: CARD
FRANFINANCE_3X
- Franfinance 3xCB paymentMeanBrandType: ONLINE_CREDIT
FRANFINANCE_4X
- Franfinance 4xCB paymentMeanBrandType: ONLINE_CREDIT
GIROPAY
- Giropay paymentMeanBrandType: CREDIT_TRANSFER
GOOGLEPAY
- Google Pay paymentMeanBrandType : CARD
ILLICADO
- Illicado paymentMeanBrandType: CARD
INCASSO
- Incasso paymentMeanBrandType: DIRECT_DEBIT
INGHOMEPAY
- PayButton ING Home’Pay paymentMeanBrandType: CREDIT_TRANSFER
JCB
- Japan Credit Bureau card paymentMeanBrandType: CARD
LEPOTCOMMUN
- Le Pot Commun paymentMeanBrandType: CARD
LYDIA
- Lydia paymentMeanBrandType: PROVIDER
MAESTRO
- Carte Maestro (Mastercard) paymentMeanBrandType: CARD
MASTERCARD
- Mastercard card paymentMeanBrandType: CARD
MASTERPASS
- Deprecated - MasterPass electronic wallet paymentMeanBrandType: WALLET
ONEY34X
- Oney Paiement 3 or 4 X payment paymentMeanBrandType: ONLINE_CREDIT
PAYLIB
- Paylib electronic wallet paymentMeanBrandType: WALLET
PAYPAL
- Paypal paymentMeanBrandType: WALLET
PAYTRAIL
- Paytrail paymentMeanBrandType: CREDIT_TRANSFER
PAY_BY_BANK
- SEPA credit transfer paymentMeanBrandType: CREDIT_TRANSFER
SAMSUNGPAY
- Samsung Pay paymentMeanBrandType : CARD
SEPA_DIRECT_DEBIT
- SDD (SEPA Direct Debit) paymentMeanBrandType: DIRECT_DEBIT
SOFINCO
- Sofinco card paymentMeanBrandType: CARD
UNKNOWN
- Unknown
VISA
- Visa card paymentMeanBrandType: CARD
VISACHECKOUT
- Deprecated - Visa Checkout electronic wallet paymentMeanBrandType: WALLET
VISA_ELECTRON
- Visa Electron card paymentMeanBrandType: CARD
VPAY
- VPAY card (Visa) paymentMeanBrandType: CARD
-
paymentMeanData
- presence
- Optional
- Interface version
- 2.4
Contains specific information regarding the payment method used by the buyer.
Contains
-
sdd
- presence
- Optional
- Interface version
- 2.4
Contains specific information on SDD payment method.
Contains
-
mandateAuthentMethod
- presence
- Optional
- Interface version
- 2.4
Type of signature used for the creation of the mandate.
List of values
MAIL_OTP
- Authentication by SMS
SMS_OTP
- Authentication by eMail
-
mandateCertificationType
- presence
- Optional
- Interface version
- 2.4
Mandate signature certification type.
List of values
E_BASIC
- Electronic signature not certified. If the mandate is an E_BASIC one, the merchant didn’t proof that he has a sufficient knowledge of his client allowing him to be sure that the client is the one that he claims to be when he creates his mandate. The client can oppose the validity of the mandate.
-
responseEncoding
- presence
- Optional
- Interface version
- 2.5
Encoding type of the response expected by the merchant.
List of values
base64
- Encoding in base64
base64Url
- Encoding in base64 including a list of special characters
-
responseKeyVersion
- presence
- Optional
- Interface version
- 2.0
Identifier of the merchant’s secret key used to calculate the imprint of the response.
-
returnContext
- presence
- Optional
- Interface version
- 2.0
Context of a buyer’’s order.All information transmitted in this field by the merchant during the payment request is sent back in the response without amendment.Attention : the following characters “|”, “«”, “»”, and «”» are not recommended in this field. If they are used, they will be returned as provided but they will be replaced by blanks in the Sogenactif database.
Attention: use this free field only for the intended purpose, and therefore do not insert any personal data, especially cardholder data
As a subcontractor, SG processes personal data in accordance with the Data Processing Agreement (DPA), appended to all contracts.
Thus:
- The personal data specified in the DPA must only be transmitted to SG via the fields provided for this purpose (see data dictionary).
- All other personal data not listed in the DPA must not be transmitted to SG.
-
sealAlgorithm
- presence
- Optional
- Interface version
- 2.2
Algorithm applied to calculate the seal encryption.
List of values
HMAC-SHA-256
- The encryption algorithm applied is HMAC-SHA-256
HMAC-SHA-512
- The encryption algorithm applied is HMAC-SHA-512
SHA-256
- The encryption algorithm applied is SHA-256
-
templateName
- presence
- Optional
- Interface version
- 2.0
Name of the file corresponding to the style sheet (name of the zip file) used to personalize the payment pages.
-
transactionActors
- presence
- Optional
- Interface version
- 2.4
Indicates the players in the transaction.
List of values
BTOB
- Business to Business
BTOC
- Business to Consumer
BTOF
- Business to organization / association
-
walletActionNameList
- presence
- Optional
- Interface version
- 2.0
List of actions expected and limited by the merchant. Only the actions mentioned in this list will be allowed in the session of walletPage.
List of values
ADDPM
- Add payment methods
DELETEPM
- Delete payment means
SIGNOFF
- Delete the wallet
UPDATEPM
- Update payment means
Request sample
Response
Required
-
seal
- presence
- Required
- Interface version
- 2.0
Message seal used to ensure the integrity of the request and the authentication of sender / receiver of the message.
Optional
-
redirectionData
- presence
- Optional
- Interface version
- 2.0
In case of 3-D Secure payment, contains the context of the transaction retrieved from the cardCheckEnrollment method. In case of 3-D Secure server Standalone, it contains the Payer Authentication Request (PAReq) that the merchant must transmit to ACS for 3-D Secure authentication (format: base 64 encoded).In case of external payment provider, contains the context of the transaction sent by the merchant during the transaction initialisation.
-
redirectionStatusCode
- presence
- Optional
- Interface version
- 2.0
Response code returned by Sogenactif when redirecting (e.g. redirecting to the ACS, to Sogenactif server…). Indicates whether redirecting is possible or not.
List of values
00
- In response to paymentWebInit: transaction initialized
- In response to walletCheckEnrollment and cardCheckEnrollment: Carte enrolled
01
- In response to cardCheckEnrollment and walletCheckEnrollment: card non 3-D Secure enrolled
03
- Merchant contract invalid
10
- Undefinied card enrollment (in response to cardCheckEnrollment and walletCheckEnrollment only)
12
- Invalid transaction, check parameters transferred in the request
14
- Invalid payment mean data (ex: PAN)
30
- Format error (Webinit ERROR)
34
- Suspicion of fraud, signature error (Webinit ERROR)
80
- Error during DS interrogation
89
- MPI session expired
91
- Merchant not configured in the 3-D Secire server
94
- In response to paymentWebInit: transaction duplicated. The transactionReference of this transaction has already been used
- In response to cardCheckEnrollment or walletCheckEnrollment: error during the enrollment verification call
99
- Internal error
-
redirectionStatusMessage
- presence
- Optional
- Interface version
- 2.0
Additional information that is returned with redirectionStatusCode.
-
redirectionUrl
- presence
- Optional
- Interface version
- 2.0
In case of an enrollment check, contains the redirection URL to the ACS required for the cardholder authentication. In case of Sogenactif In-App payment, contains the URL of the next request. In case of 3-D Secure Standalone, contains the redirection URL to the ACS required for the cardholder authentication.
-
redirectionVersion
- presence
- Optional
- Interface version
- 2.0
Version of the redirection message.
Response sample
Changelog