creditTransferInquire
To search in the page use Ctrl+F on your keyboard
Requests to retrieve the list of issuer’s bank available. This service is currently available for the payment means iDEAL.
This request provides a list of issuer’s banks. If the request is successful, you will receive in response a list of bank with their name and code. This information must be use for the initialization step (CreditTransferInitialize).
Recommended interfaceVersion: IR_WS_2.51
Endpoints
-
- PROD
-
https://office-server.sogenactif.com/rs-services/v2/checkout/creditTransferInquire
- method
- POST
-
- TEST
-
https://office-server-sogenactif.test.sips-services.com/rs-services/v2/checkout/creditTransferInquire
- method
- POST
-
- PROD
-
https://office-server.sogenactif.com/services/v2/checkout?wsdl
- method
- POST
-
- TEST
-
https://office-server-sogenactif.test.sips-services.com/services/v2/checkout?wsdl
- method
- POST
Request
Required
-
currencyCode
- presence
- Required
- Interface version
- 2.0
Currency code for the transaction. This code is ISO 4217 compatible.
List of values
032
- Argentinean Peso
036
- Australian Dollar
048
- Bahrain Dinar
116
- Cambodian Riel
124
- Canadian Dollar
144
- Sri Lanka Rupee
156
- China Yuan Renminbi
191
- Croatia Kuna
203
- Czech Republic Koruna
208
- Danes crown
344
- Hong Kong dollar
348
- Hungary Forint
352
- Iceland Rupee
356
- Indian rupee
376
- Israel Shekel
392
- Japanese Yen
410
- South Korean Won
414
- Kuwait Dinar
458
- Malaysia Ringgit
480
- Mauritius Rupee
484
- Mexican Peso
524
- Nepal Rupee
554
- New Zealand Dollar
578
- Norwegian crown
634
- Qatar Riyal
643
- Russia Ruble
682
- Saudi Arabia Riyal
702
- Singapore Dollar
710
- South Africa Rand
752
- Swedish crown
756
- Swiss Franc
764
- Thailand Baht
784
- United Arab Emirates Dirham
788
- Tunisia Dinar
826
- Pound
840
- American Dollar
901
- Taiwan Dollar
941
- Serbian Dinar
946
- Roumania New Leu
949
- New Turkish Lira
952
- CFA Franc
953
- CFP Franc
975
- Bulgaria Lev
978
- Euro
980
- Ukraine Hryvnia
985
- Poland Zloty
986
- Brazilian Real
-
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.
-
paymentMeanBrand
- presence
- Required
- Interface version
- 2.0
Name of the payment method that is used. It is related to one paymentMeanType.
List of values
1EUROCOM
- Cofidis Pay 5x10x20x Acquisition contract: ONLINE_CREDIT
3XCBCOFINOGA
- Depreciated. Cofinoga 3xCB paymentMeanBrandType: CARD
ACCEPTGIRO
- AcceptGiro paymentMeanBrandType: CREDIT_TRANSFER
ACCORD
- Oney card paymentMeanBrandType: CARD
ACCORD_3X
- Payment in 3 times with Facily Pay paymentMeanBrandType: ONLINE_CREDIT
ACCORD_4X
- Payment in 4 times with Facily Pay paymentMeanBrandType: ONLINE_CREDIT
ACCORD_KDO
- Carte Cadeau Oney paymentMeanBrandType: CARD
AIRPLUS
- Airplus card paymentMeanBrandType: CARD
AIRPLUS_LOGEE
- Airplus card paymentMeanBrandType: CARD
AMEX
- American Express card paymentMeanBrandType: CARD
AMEX_LOGEE
- American Express card paymentMeanBrandType: CARD
AURORE
- CPAY card paymentMeanBrandType: CARD
BCACB_3X
- Payment in 3 times with Floa Bank CB paymentMeanBrandType: ONLINE_CREDIT
BCACB_4X
- Payment in 4 times with Floa Bank CB paymentMeanBrandType: ONLINE_CREDIT
BCACUP
- CUP card of Floa Bank paymentMeanBrandType: CARD
BCMC
- Bancontact card paymentMeanBrandType: CARD
CACF_3X
- CACF payment in 3 installments paymentMeanBrandType: ONLINE_CREDIT
CACF_3XSANSFRAIS
- CACF payment in 3 installments free of charge paymentMeanBrandType: ONLINE_CREDIT
CACF_4X
- CACF payment in 4 installments paymentMeanBrandType: ONLINE_CREDIT
CACF_4XSANSFRAIS
- CACF payment in 4 installments free of charge paymentMeanBrandType: ONLINE_CREDIT
CADHOC
- Cadhoc paymentMeanBrandType: CARD
CADOCARTE
- Cado Carte paymentMeanBrandType: CARD
CB
- Carte Bancaire paymentMeanBrandType: CARD
CBCONLINE
- PayButton CBC Online paymentMeanBrandType: CREDIT_TRANSFER
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
- Carte Diners club international paymentMeanBrandType: CARD
ELV
- Elektronisches LastschriftVerfahren paymentMeanBrandType: DIRECT_DEBIT
FIVORY
- Lyf Pay paymentMeanBrandType: WALLET
FRANFINANCE_3X
- Franfinance 3xCB paymentMeanBrandType: ONLINE_CREDIT
FRANFINANCE_4X
- Franfinance 4xCB paymentMeanBrandType: ONLINE_CREDIT
GIROPAY
- Giropay paymentMeanBrandType: CREDIT_TRANSFER
IDEAL
- iDeal paymentMeanBrandType: CREDIT_TRANSFER
ILLICADO
- Illicado paymentMeanBrandType: CARD
INCASSO
- Incasso paymentMeanBrandType: DIRECT_DEBIT
INGHOMEPAY
- PayButton ING Home’Pay paymentMeanBrandType: CREDIT_TRANSFER
JCB
- Carte Japan Credit Bureau paymentMeanBrandType: CARD
KBCONLINE
- PayButton KBC Online paymentMeanBrandType: CREDIT_TRANSFER
LEPOTCOMMUN
- Le Pot Commun paymentMeanBrandType: CARD
LYDIA
- Lydia paymentMeanBrandType: PROVIDER
MAESTRO
- Maestro card (Mastercard) paymentMeanBrandType: CARD
MASTERCARD
- Mastercard card paymentMeanBrandType: CARD
MASTERPASS
- Deprecated - MasterPass paymentMeanBrandType:
ONEY34X
- Payment in 3 or 4 times with Oney paymentMeanBrandType: ONLINE_CREDIT
PAYLIB
- Paylib paymentMeanBrandType:
PAYPAL
- Paypal paymentMeanBrandType: WALLET
PAYTRAIL
- Paytrail paymentMeanBrandType: CREDIT_TRANSFER
PAY_BY_BANK
- SEPA credit transfer paymentMeanBrandType: CREDIT_TRANSFER
PRESTO
- Presto Plus paymentMeanBrandType: ONLINE_CREDIT
SEPA_DIRECT_DEBIT
- SDD (SEPA Direct Debit) paymentMeanBrandType: DIRECT_DEBIT
SOFINCO
- Sofinco card paymentMeanBrandType: CARD
SOFORTUBERWEISUNG
- Sofortüberweisung (Sofort Banking) paymentMeanBrandType: CREDIT_TRANSFER
UNKNOWN
- Unknown payment mean (this value can be returned by Sogenactif but must not be used in a request)
VISA
- Visa card paymentMeanBrandType: CARD
VISACHECKOUT
- Deprecated - Visa Checkout wallet paymentMeanBrandType: WALLET
VISA_ELECTRON
- Carte Visa Electron paymentMeanBrandType: CARD
VPAY
- VPAY card (Visa) paymentMeanBrandType: CARD
-
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
-
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
-
intermediateServiceProviderId
- presence
- Optional
- Interface version
- 2.12
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
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
{
"currencyCode": "978",
"customerLanguage": "fr",
"interfaceVersion": "IR_WS_2.9",
"keyVersion": "1",
"merchantId": "011223344550000",
"paymentMeanBrand": "IDEAL",
"transactionReference": " TREFEXA2015",
"seal": "ec7be3e2a0086a86f66f74bb6e10f244e51e4e648c7dbbf7c89ce9aa78a569cf"
}
<urn:creditTransferInquire>
<urn:input>
<urn:merchantId>011223344550000</urn:merchantId>
<urn:transactionReference>TREFEXA2015</urn:transactionReference>
<urn:interfaceVersion>IR_WS_2.6</urn:interfaceVersion>
<urn:currencyCode>978</urn:currencyCode>
<urn:customerLanguage>fr</urn:customerLanguage>
<urn:paymentMeanBrand>IDEAL</urn:paymentMeanBrand>
</urn:input>
</urn:creditTransferInquire>
Response
Required
-
responseCode
- presence
- Required
- Interface version
- 2.0
Sogenactif server response code.
List of values
00
- Operation accepted
03
- Invalid merchant contract
12
- Invalid transaction. Please check the request 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
99
- Temporarily problem with the payment server
-
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
-
customerBankList
- presence
- Optional
- Interface version
- 2.0
liste des banques du client
Contains
-
customerBankCode
- presence
- Optional
- Interface version
- 2.0
Bank code of the customer either in national, or international or specific codification. The format is specified in the field customerBankAccountType (eg BIC …).
-
customerBankName
- presence
- Optional
- Interface version
- 2.0
Bank name of the customer.
-
errorFieldName
- presence
- Optional
- Interface version
- 2.0
Error field name of the incoming request. Present when responseCode = 12 or 30.
Response sample
{
"customerBankList": [
{
"customerBankCode": "RABONL2U",
"customerBankName": "BANK - RABO"
},
{
"customerBankCode": "INGBNL2A",
"customerBankName": "BANK - ING"
}
],
"responseCode": "00",
"seal": "c46465d780517ce593b4bd5afe789fe58d2bc972937aaa35707ec8668265e6dc"
}
<creditTransferInquireResponse xmlns="urn:sips:cn:contract:office:checkout:v2">
<output>
<responseCode>00</responseCode>
<customerBankList>
<customerBankCode>RABONL2U</customerBankCode>
<customerBankName>BANK - RABO</customerBankName>
</customerBankList>
</output>
</creditTransferInquireResponse>
Changelog
Interface version | Data | Attendance | Container |
---|---|---|---|
2.0 |
customerLanguage
|
Request | |
2.12 |
intermediateServiceProviderId
|
Request | |
2.0 |
s10TransactionReference
|
Request | |
2.0 |
s10TransactionId
|
Container |
s10TransactionReference
|
2.0 |
s10TransactionIdDate
|
Container |
s10TransactionReference
|
2.12 |
sealAlgorithm
|
Request | |
2.0 |
transactionReference
|
Request | |
2.0 |
currencyCode
|
Request | |
2.0 |
interfaceVersion
|
Request | |
2.0 |
keyVersion
|
Request | |
2.0 |
merchantId
|
Request | |
2.0 |
paymentMeanBrand
|
Request | |
2.0 |
seal
|
Request/Response | |
2.0 |
customerBankList
|
Response | |
2.0 |
customerBankCode
|
Container |
customerBankList
|
2.0 |
customerBankName
|
Container |
customerBankList
|
2.0 |
errorFieldName
|
Response | |
2.0 |
responseCode
|
Response |