logo Sogenactif

Release 23.1

go directly to content

Search by keywords

cardCheckEnrollment

To search in the page use Ctrl+F on your keyboard

Requests for payment initialization via card with 3-D Secure process.

In this document, unless otherwise stated, any reference to 3-D Secure includes Visa (Verified by Visa), MasterCard (SecureCode) and American Express (SafeKey).

This request initializes a transaction on “Sogenactif platform and checks the card enrollment. If the card is enrolled to 3-D Secure program, you will receive in response a secure URL (redirectionUrl) to which the customer should be redirected to continue the authentication. This redirection must be made via a POST form, see the part “POST form to the ACS”. On the other hand, you can proceed with the payment directly by calling cardValidateAuthenticationAndOrder method.”

Sensitive information (card number, card security code) can be handled in three ways, via the panType field:

  • encryption via the CSE mode
  • card number tokenisation
  • card number in plain text (significant PCI constraint)
  • PROD
    https://office-server.sogenactif.com/rs-services/v2/checkout/cardCheckEnrollment
    method
    POST
  • TEST
    https://office-server-sogenactif.test.sips-services.com/rs-services/v2/checkout/cardCheckEnrollment
    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

Required

  • amount
    presence
    Required
    Interface version
    2.0

    Transaction amount. The amount must be transmitted in the smallest currency unit.For example in euros: an amount of EUR 10.50 must be transmitted in the form 1050.

  • 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 value and number of the interface used.

    List of values
    AR_WS_2.
    Obsolete
    AUT_WS_2.
    AUT_WS: Sogenactif Office Serveur (SOAP/JSON) interface for the Sogenactif authentication services.2.x: version referenced in the documentation of the function used by the merchant
    CPR_WS_2.
    Obsolete
    CR_WS_2.
    CR_WS: Sogenactif Office Serveur (SOAP/JSON) interface for Cash Management functions. 2.x: connector version used by the merchant
    DR_WS_2.
    DR_WS: Sogenactif Office Serveur (SOAP/JSON) interface for Diagnostic functions. 2.x: connector version used by the merchant
    FR_WS_2.
    FR_WS: Sogenactif Office Serveur (SOAP) interface for Fraud functions. 2.x: connector version used by the merchant
    HP_x.x
    HP: Sogenactif Paypage (POST) interface. x.x: connector version used by the merchant
    IR_MB_
    IR_MB: Sogenactif In-App (JSON) interface for Sogenactif In-App functions. 1.x: connector version used by the merchant
    IR_WS_
    IR_WS: Sogenactif Paypage (SOAP/JSON) interface. x.x: connector version used by the merchant
    IR_WS_2.
    IR_WS: Sogenactif Office Serveur (SOAP/JSON) interface for payment request functions. 2.x: connector version used by the merchant
    MR_WS_2.
    MR_WS: Sogenactif Office Serveur (SOAP/JSON) interface for mandate management. 2.x: connector version used by the merchant
    OR_WS_1.0
    OR_WS: Sogenactif Office Serveur (SOAP) interface for Sogenactif Office Serveur functions. 1.0: connector version used by the merchant
    PMR_WS_2.
    PMR_WS: Sogenactif Office Serveur (SOAP/JSON) interface for payment method repository information request functions. 2.x: connector version used by the merchant
    POR_WS_2.
    Obsolete
    TR_WS_2.
    TR_WS: Sogenactif Office Serveur (SOAP) interface for Token functions. 2.x: connector version used by the merchant
    WMR_WS_2.
    WMR_WS: Sogenactif Walletpage interface 2.x: connector version used by the merchant
    WR_WS_2.
    WR_WS: Sogenactif Office Serveur (SOAP/JSON) interface for Wallet functions. 2.x: connector version used by the merchant
  • 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.

  • orderChannel
    presence
    Required
    Interface version
    2.0

    Order channel used (Internet, Telephone, Post, Fax etc), Internet is the default value.Use of this field should be reconciled with the conditions defined in the acquirer contract.

    List of values
    FAX
    Fax order channel Acquiring contract: MOTO
    INAPP
    Order from a service inside an application (eg mobile) Acquiring contract: INTERNET
    INTERNET
    Internet order channel Acquiring contract: INTERNET
    IVR
    IVR order channel Acquiring contract: MOTO
    MAIL_ORDER
    Mail order channel Acquiring contract: MOTO
    MINITEL
    Obsolete
    MOTO
    Mail order or Telephone order channel without distinction (deprecated, use MAIL_ORDER or TELEPHONE_ORDER) Acquiring contract: MOTO
    PROXI_ATTENDED
    Obsolete
    PROXI_SEMIATTENDED
    Obsolete
    PROXI_UNATTENDED
    Obsolete
    TELEPHONE_ORDER
    Telephone order channel Acquiring contract: MOTO
  • 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

Request sample

            {
  "amount": "1000",
  "captureDay": "0",
  "captureMode": "AUTHOR_CAPTURE",
  "cardCSCValue": "123",
  "cardExpiryDate": "201602",
  "cardNumber": "1234123412341234",
  "currencyCode": "978",
  "interfaceVersion": "IR_WS_2.9",
  "keyVersion": "1",
  "merchantId": "011223344550000",
  "merchantTransactionDateTime": "2015-05-28T11:23:14.211+02:00",
  "orderChannel": "INTERNET",
  "orderId": "1234",
  "transactionReference": "TREFEXA2015",
  "seal": "607083393a51b4b23261270df83c28a61e06f74928bc1e868c0abb9325dde2f2"
}

        
                  <urn:cardCheckEnrollment>
         <urn:input>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:transactionReference>TREFEXA2015</urn:transactionReference>
            <urn:interfaceVersion>IR_WS_2.9</urn:interfaceVersion>
            <urn:amount>1000</urn:amount>
            <urn:captureDay>0</urn:captureDay>
            <urn:captureMode>AUTHOR_CAPTURE</urn:captureMode>
            <urn:cardCSCValue>123</urn:cardCSCValue>
            <urn:cardExpiryDate>201601</urn:cardExpiryDate>
            <urn:cardNumber>4907000000000600</urn:cardNumber>
            <urn:currencyCode>978</urn:currencyCode>
            <urn:merchantTransactionDateTime>2015-04-27T19:21:22.405+02:00</urn:merchantTransactionDateTime>
            <urn:orderChannel>INTERNET</urn:orderChannel>
            <urn:orderId>123456</urn:orderId>
         </urn:input>
      </urn:cardCheckEnrollment>

        

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

  • errorFieldName
    presence
    Optional
    Interface version
    2.0

    Error field name of the incoming request.Present when responseCode = 12 or 30.

  • maskedPan
    presence
    Optional
    Interface version
    2.32

    Masked Primary Account Number. In the case of wallets, masked PAN of the payment mean registered in the wallet.

  • messageVersion
    presence
    Optional
    Interface version
    2.0

    Parameters version of redirection (used for Sogenactif Office Serveur with redirection).

  • paReqMessage
    presence
    Optional
    Interface version
    2.0

    Payer Authentication Request (PAReq) that the merchant must transmit to ACS for 3-D Secure authentication.

  • paymentMeanBrandSelectionStatus
    presence
    Optional
    Interface version
    2.13

    Status of the processing of the brand application selection on paypage.

    List of values
    APPLIED_DEFAULT
    The cardholder accepted the default merchant choice
    APPLIED_HOLDER
    The cardholder selected a card brand different from the default merchant choice
    Empty
    Transaction not processed according to the payment mean brand selection rules
    NOT_APPLICABLE
    Card number filled is not a cobadged card
  • 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
  • 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.

  • responseCode
    presence
    Optional
    Interface version
    2.23

    Sogenactif server response code.

    List of values
    00
    correct enrollment check
    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
  • tokenPan
    presence
    Optional
    Interface version
    2.32

    Unique identifier for a PAN returned by the Sogenactif server via the AWL token server in a merchant-oriented format (the format is a parameter in the merchant’s configuration).

Response sample

            {
  "redirectionUrl": "http://www.acssiteweb.com",
  "paReqMessage": "eJxVUU1zgj...Rv8P/AJQjttc\u003d",
  "redirectionData": "uqjeV+Keg...MAwXk2jDJAe2TI\u003d",
  "redirectionStatusCode": "00",
  "messageVersion": "0.1",
  "seal": "3c40cf8c12a8eebdfc114c83db8f944b77932b03814d8bf43ea792c20d05e7a6"
}

        
                  <cardCheckEnrollmentResponse xmlns="urn:sips:cn:contract:office:checkout:v2">
         <output>
            <redirectionStatusCode>00</redirectionStatusCode>
            <redirectionUrl>https://payment-web.test.sips-services.com/paymentprovider/init</redirectionUrl>
            <paReqMessage>eJxVUctuwjAQ..../AVQptqQ=</paReqMessage>
            <redirectionData>RSs7cZyL1DqsVs...vceJKsC4lg</redirectionData>
            <messageVersion>0.1</messageVersion>
         </output>
      </cardCheckEnrollmentResponse>

        

This site uses trackers to improve your experience, perform analysis and researches on your use of Sogenactif documentation website.
You have several options:
Closing this banner you refuse the use of trackers on your device.

Configuration