paymentProviderGetContext
To search in the page use Ctrl+F on your keyboard
This request is optional and allow you to know the identity of the payer and his shipping address in order to display them before the confirmation of transaction of a PayPal transaction.
Recommended interfaceVersion: IR_WS_2.55
Endpoints
-
- PROD
-
https://office-server.sogenactif.com/rs-services/v2/checkout/paymentProviderGetContext
- method
- POST
-
- TEST
-
https://office-server-sogenactif.test.sips-services.com/rs-services/v2/checkout/paymentProviderGetContext
- method
- POST
-
- PROD
-
https://office-server.sogenactif.com/services/v2/checkout?wsd
- method
- POST
-
- TEST
-
https://office-server-sogenactif.test.sips-services.com/services/v2/checkout?wsd
- 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
IR_WS_
- Sogenactif Paypage and Sogenactif Office Serveur (SOAP/JSON) interface.
-
keyVersion
- presence
- Required
- Interface version
- 2.0
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.
-
messageVersion
- presence
- Required
- Interface version
- 2.0
Parameters version of redirection (used for Sogenactif Office Serveur with redirection).
-
redirectionData
- presence
- Required
- 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.
-
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
-
intermediateServiceProviderId
- presence
- Optional
- Interface version
- 1.2
Identifier of the Service used by the merchant for the exchanges with the Sogenactif platform.
-
s10TransactionReference
- presence
- Optional
- Interface version
- 2.0
Contains the identification of the transaction (to be compliant with Sogenactif 1.0).Contains the data pair (s10TransactionId, s10TransactionIdDAte) which ensures the uniqueness of the transaction 1.0.
Contains
-
s10TransactionId
- presence
- Optional
- Interface version
- 2.0
- Format
-
N6Any character is accepted
The merchant can choose between transactionId and transactionReference (by default) to identify his transactions.s10TransactionId is an alternative identifier for the transaction to be compliant with Sogenactif 1.0. The couple s10TransactionId/s10TransactionIdDate ensures the unicity of the transaction.
-
s10TransactionIdDate
- presence
- Optional
- Interface version
- 2.0
Date of the transaction (expressed in the Sogenactif server time zone).The couple s10TransactionId/s10TransactionIdDate ensures the unicity of the transaction 1.0.The use of this couple instead of transactionReference depends on an option in the merchant configuration.
-
sealAlgorithm
- presence
- Optional
- Interface version
- 2.12
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
-
transactionReference
- presence
- Optional
- Interface version
- 2.0
The merchant can choose of referencing his transactions by a transactionId or a transactionReference.transactionReference uniquely identifies a transaction throughout the life of the shop.
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
-
acquirerNativeResponseCode
- presence
- Optional
- Interface version
- 2.0
Response code returned by the acquirer, in its own codification, during an authorisation request.
-
acquirerResponseIdentifier
- presence
- Optional
- Interface version
- 2.0
Please see “authorMessageReference”.
-
acquirerResponseMessage
- presence
- Optional
- Interface version
- 2.0
Acquirer response message to the originator of the transaction (for example, message to be displayed to the holder or the cashier)..
-
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.
-
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.11
contact initals
-
lastname
- presence
- Optional
- Interface version
- 2.0
Last name of the 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.
-
title
- presence
- Optional
- Interface version
- 2.0
Title of the contact.
-
workphone
- presence
- Optional
- Interface version
- 2.23
Holder’s business phone number.
-
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.
-
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.11
contact initals
-
lastname
- presence
- Optional
- Interface version
- 2.0
Last name of the 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.
-
title
- presence
- Optional
- Interface version
- 2.0
Title of the contact.
-
workphone
- presence
- Optional
- Interface version
- 2.23
Holder’s business phone number.
-
errorFieldName
- presence
- Optional
- Interface version
- 2.21
Error field name of the incoming request. Present when responseCode = 12 or 30.
-
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.
-
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.
-
paymentMeanData
- presence
- Optional
- Interface version
- 2.0
Contains specific information regarding the payment method used by the buyer.
Contains
-
bcmcMobile
- presence
- Optional
- Interface version
- 2.21
Contains specific information on Bancontact Mobile.
Contains
-
completionRedirectUrl
- presence
- Optional
- Interface version
- 2.21
Optional URL for Bancontact mobile application that can be used as Merchant Callback URL for notifications. It is triggered by the Payer Mobile Payment Application once the Payer had reviewed the transaction results in its Mobile Payment Application.
-
defaultRedirectUrl
- presence
- Optional
- Interface version
- 2.21
Optional URL for Bancontact mobile application that can be used as Merchant Callback URL for notifications. It can be triggered if the transaction is not completed, or if the connection between the Mobile Payer Payment Application and its Transaction Manager Issuing is lost later during the transaction.
-
cofinoga3xcb
- presence
- Optional
- Interface version
- 2.0
Depreciated data. Contains specific information on Cofinoga 3xCB payment method.
Contains
-
creditIndicator
- presence
- Optional
- Interface version
- 2.0
Credit indicator specifies the choice of payment by the holder or commercial operation of the acceptor
-
cofinoga
- presence
- Optional
- Interface version
- 2.14
Depreciated data. Contains specific information on Cofinoga payment method.
Contains
-
settlementMode
- presence
- Optional
- Interface version
- 2.14
Settlement mode chosen by the buyer. The values of this field should be acquirer’s native codes. Any convertion is done by Sogenactif.
-
bcaCup
- presence
- Optional
- Interface version
- 2.12
Contains specific information on the CUP Card means of payment from Floa Bank.
Contains
-
settlementMode
- presence
- Optional
- Interface version
- 2.14
Settlement mode chosen by the buyer. The values of this field should be acquirer’s native codes. Any convertion is done by Sogenactif.
-
bancontact
- presence
- Optional
- Interface version
- 2.38
Contains specific information on the bancontact payment method.
Contains
-
bancontactMerchantCustomerAuthenticationMethod
- presence
- Optional
- Interface version
- 2.38
Customer authentication method used by the merchant at the point of sale.
-
initialAuthenticationCavv
- presence
- Optional
- Interface version
- 2.38
Initial authentication Cavv value.
-
payeeCardNumber
- presence
- Optional
- Interface version
- 2.38
P2P payment recipient card number.
-
payeeHolderName
- presence
- Optional
- Interface version
- 2.38
Name of the cardholder who is beneficiary of the P2P payment.
-
paypal
- presence
- Optional
- Interface version
- 2.0
Contains specific information on PayPal payment method.
Contains
-
orderDescription
- presence
- Optional
- Interface version
- 2.14
Order description of purchased items.
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.
-
deliveryAddressStatus
- presence
- Optional
- Interface version
- 2.12
Status of the delivery address.For example: confirmed, unconfirmed.
-
payerStatus
- presence
- Optional
- Interface version
- 2.12
Status of payer. For exemple, Paypal may return verified, unverified.
-
payerBusiness
- presence
- Optional
- Interface version
- 2.12
Payer’s business name.
-
dupDesc
- presence
- Optional
- Interface version
- 2.0
Description of the reason for PayPal duplication, possible when dupFlag is set to “true”. Shown to the Internet user on their PayPal account in the transaction details.
-
invoiceId
- presence
- Optional
- Interface version
- 2.0
Order number, same as the orderId but with PayPal, it must be unique. Mandatory in order to use PayPal.
-
addrOverride
- presence
- Optional
- Interface version
- 2.0
Indicator allowing the merchant to display the delivery address on PayPal pages. This indicator allows to override the address present in the PayPal account if necessary.
List of values
NO_DISPLAY
- No address is displayed, the address sent by the merchant is not taken into account by PayPal. It is the default value
NO_OVERRIDE
- PayPal displays the address the Internet user registered with PayPal
OVERRIDE
- PayPal displays the address communicated by the merchant, the address the Internet user registered with PayPal is deleted
-
mobile
- presence
- Optional
- Interface version
- 2.0
Mobile phone number for the contact.
-
dupFlag
- presence
- Optional
- Interface version
- 2.0
Indicator allowing the PayPal transaction to be duplicated. “false” default value (cannot be duplicated).
List of values
false
- Boolean indicator is false
true
- Boolean indicator is true
-
paymentStatus
- presence
- Optional
- Interface version
- 2.12
Indicates whether the Sogenactif transaction has been reconciled with one acquirer movement of from RGI and MPI .the acquisition of payments (statement from your acquirer).
List of values
KO
- Association not possible. The transaction was not matched on time
OK
- Transaction successfully matched
-
payerId
- presence
- Optional
- Interface version
- 2.12
Unique buyer account identification in the issuer of payment.
-
payerSuffix
- presence
- Optional
- Interface version
- 2.12
Suffix of payer.
-
dupCustom
- presence
- Optional
- Interface version
- 2.0
Paypal Field left free for the merchant, taken into account when dupFlag is set to “true”
-
dupType
- presence
- Optional
- Interface version
- 2.0
Paypal Duplication type. This optional information is taken into account when dupFlag is “true”.
List of values
ANY
- Duplication type: several
INSTANTONLY
- Duplication type: one
-
landingPage
- presence
- Optional
- Interface version
- 2.0
Indicator allowing the merchant to hide the subscription form on PayPal pages. “false” is the default value.
List of values
false
- Boolean indicator is false
true
- Boolean indicator is true
-
token
- presence
- Optional
- Interface version
- 2.12
Payor’s token used for a payment Paypal.
-
responseCode
- presence
- Optional
- Interface version
- 2.0
Sogenactif server response code.
List of values
00
- Operation accepted
01
- For panToToken and tokenToPan methods, partial success
02
- Request of authorized on via telephone with the issuer because of exceeding the card authorization threshold
03
- Invalid merchant contract
05
- Refused authorization
11
- Used for differed check. The PAN is blocked
12
- Invalid transaction. Please check the request parameters
14
- Invalid PAN or payment mean data check is failed (e.g. card number or the visual cryptogram of the card or AVS address)
17
- Customer cancellation
24
- In response to a cash management operation: operation not authorized. The operation you wish to perform is not compliant with the transaction status or another operation is in progress at the same time
- In response to a payment creation: operation rejected, request already carried out with the same data and the same parameters
25
- Transaction unknown by Sogenactif
30
- Format error
34
- Fraud suspicion (seal erroneous)
40
- Function not supported: the operation that you wish to perform is not part of the operation type for which you are authorized
51
- Amount too high
54
- Payment mean expiry date is past
55
- Merchant doesn’t accept prepaid cards
57
- Refund operation refused because the original transaction was subject of an unpaid
60
- Transaction pending
62
- Waiting the confirmation for the transaction (used by PayPal 1.0)
63
- Security rules not observed, transaction stopped
75
- Number of attempts to enter the data of the payment mean from Sogenactif Paypage is exceeded
90
- Service temporarily not available
94
- Duplicated transaction: the transactionReference has been used previously
97
- Session expired (no action from the user during 15 minutes), transaction refused
99
- Temporarily problem with the payment server
Response sample
Changelog