WL SIPS DOCS

Release 24.1

go directly to content

Search by keywords

tokenToPan

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

This function makes it possible to transform a token to a pan.

Recommended interfaceVersion: TR_WS_2.53

  • PROD
    https://office-server.sips-services.com/rs-services/v2/token/tokenToPan
    method
    POST
  • TEST
    https://office-server.test.sips-services.com/rs-services/v2/token/tokenToPan
    method
    POST
  • PROD
    https://office-server.sips-services.com/services/v2/token?wsdl
    method
    POST
  • TEST
    https://office-server.test.sips-services.com/services/v2/token?wsdl
    method
    POST

Required

Optional

Request sample

            {
  "interfaceVersion": "TR_WS_2.0",
  "keyVersion": "1",
  "merchantId": "011223344550000",
  "panDataList": [
    {
      "pan": "490700h719850600",
      "panId": "1"
    }
  ],
  "userId": "uid",
  "seal": "e350c058e2be7a3686682587dfac89cd192cda1ad2c2f532e10f9d59b9ca0f13"
}

        
                  <urn:tokenToPan>
         <urn:input>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:interfaceVersion>TR_WS_2.0</urn:interfaceVersion>
            <urn:userId>uid</urn:userId>
            <urn:tokenPanDataList>
               <urn:tokenPanData>
                  <urn:tokenPanId>1</urn:tokenPanId>
                  <urn:tokenPan>510008g906c20016</urn:tokenPan>
               </urn:tokenPanData>
            </urn:tokenPanDataList>
         </urn:input>
      </urn:tokenToPan>

        

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

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

  • responseCode
    presence
    Optional
    Interface version
    2.0

    Worldline Sips 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 Worldline Sips
    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 Sips 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
  • responsePanDataList
    presence
    Optional
    Interface version
    2.0

    List of responses returned during the PAN conversion response.

    Contains

Response sample

            {
  "responseCode": "00",
  "responsePanDataList": [
    {
      "tokenResponseCode": "00",
      "tokenPanId": "1",
      "pan": "4907000000000600"
    }
  ]
}

        
                  <tokenToPanResponse xmlns="urn:sips:cn:contract:office:token:v2">
         <output>
            <responseCode>00</responseCode>
            <responsePanDataList>
               <responsePanData>
                  <tokenResponseCode>00</tokenResponseCode>
                  <tokenPanId>1</tokenPanId>
                  <pan>5100081000000016</pan>
               </responsePanData>
            </responsePanDataList>
         </output>
      </tokenToPanResponse>

        

Changelog


Interface version Data Attendance Container
2.12 intermediateServiceProviderId Request
2.12 sealAlgorithm Request
2.0 tokenPanDataList Request
2.0 tokenPanData Container
  • tokenPanDataList
  • 2.0 tokenPan Container
  • tokenPanData
  • 2.0 tokenPanId Container
  • tokenPanData
  • responsePanData
  • 2.0 interfaceVersion Request
    2.0 keyVersion Request
    2.0 merchantId Request
    2.0 seal Request/Response
    2.21 errorFieldName Response
    2.0 responseCode Response
    2.0 responsePanDataList Response
    2.0 responsePanData Container
  • responsePanDataList
  • 2.0 pan Container
  • responsePanData
  • 2.0 tokenResponseCode Container
  • responsePanData
  • This site uses trackers to improve your experience, perform analysis and researches on your use of WL Sips documentation website.
    You have several options:
    Closing this banner you refuse the use of trackers on your device.

    Configuration