logo Sogenactif

Release 23.3

go directly to content

Search by keywords

walletCheckEnrollment

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

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

This request initializes a transaction on Sogenactif platform and checks the card enrollment retrieved from the wallet. If the enrollment step is successful, 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.

Recommended interfaceVersion: IR_WS_2.49

  • PROD
    https://office-server.sogenactif.com/rs-services/v2/checkout/walletCheckEnrollment
    method
    POST
  • TEST
    https://office-server-sogenactif.test.sips-services.com/rs-services/v2/checkout/walletCheckEnrollment
    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

Optional

Request sample

            {
  "amount": "1000",
  "captureDay": "0",
  "captureMode": "AUTHOR_CAPTURE",
  "cardCSCValue": "123",
  "currencyCode": "978",
  "interfaceVersion": "IR_WS_2.9",
  "keyVersion": "1",
  "merchantId": "011223344550000",
  "merchantTransactionDateTime": "2015-05-28T11:30:14.232+02:00",
  "merchantWalletId": "WALLET01",
  "orderChannel": "INTERNET",
  "orderId": "1234",
  "paymentMeanId": "10",
  "transactionReference": "TREFEXA2015",
  "seal": "3bfc4e958ba4ea43090db3c0c0bdba7162c92727ca1338b2111b28ddd91056a1"
}

        
                  <urn:walletCheckEnrollment>
         <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:currencyCode>978</urn:currencyCode>
            <urn:merchantTransactionDateTime>2015-04-27T19:21:22.405+02:00</urn:merchantTransactionDateTime>
            <urn:merchantWalletId>WALLET01</urn:merchantWalletId>
            <urn:orderChannel>INTERNET</urn:orderChannel>
            <urn:orderId>123456</urn:orderId>
            <paymentMeanId>10</paymentMeanId>
         </urn:input>
      </urn:walletCheckEnrollment>

        

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.

  • 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.

  • 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
    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

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

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

        

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