update

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

This function makes it possible to update a list of PAN.

Endpoints

json
soap

PROD

https://office-server.sips-services.com/rs-services/v2/accountUpdate/update

method

POST
TEST

https://office-server.test.sips-services.com/rs-services/v2/accountUpdate/update

method

POST

PROD

https://office-server.sips-services.com/services/v2/accountUpdate?wsdl

method

POST
TEST

https://office-server.test.sips-services.com/services/v2/accountUpdate?wsdl

method

POST

Request

Required

cardScheme

presence

Required

Interface version

2.49

Format

ANS20(restricted values)

Network name associated with the card.

List of values

CB

Bank Card scheme
interfaceVersion
presence

Required

Interface version

2.49
Format
AN20(restricted String)
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

AU_WS_2.

AU_WS: Sips Office (SOAP/JSON) interface for the Worldline Sips account update services.
keyVersion

presence

Required

Interface version

2.49

Format

N10

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

Format

N15

Identifier of the shop, this value is provided to the merchant by Worldline Sips during the shop registration.
seal

presence

Required

Interface version

2.49

Format

ANS128

Message seal used to ensure the integrity of the request and the authentication of sender / receiver of the message.

Conditional

panList

presence

Conditional

Interface version

2.49

Format

N19 (list)

List of PAN to update.
tokenPanList
presence

Conditional

Interface version

2.50
Format
AN35(restricted String) (list)
List of tokenPan to update.
walletDataList

presence

Conditional

Interface version

2.50

Format

Composite list

List of walletData to update.
Contains
- merchantWalletId
  presence
  
  Required
  
  Interface version
  
  2.50
  Format
  
  AN21(restricted String)
  Customer’s Wallet identifier.
- paymentMeanId
  
  presence
  
  Required
  
  Interface version
  
  2.50
  
  Format
  
  N6
  
  Payment mean rank in Worldline Sips wallet.

Optional

intermediateServiceProviderId

presence

Optional

Interface version

2.49

Format

AN30

Identifier of the Service used by the merchant for the exchanges with the Worldline Sips platform.
sealAlgorithm

presence

Optional

Interface version

2.49

Format

ANS20(restricted values)

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

            {
  "cardScheme": "CB",
  "interfaceVersion": "AU_WS_2.49",
  "keyVersion": "1",
  "merchantId": "037000254447216",
  "panList":["5017671000001001", "5017671000001002"],
  "seal": "401b6465f99139500cfd49fe9aec513fd3dc5d106d795ec5d65b6b08d04e49d5"
}

            <urn:update>
  <urn:input>
    <urn:merchantId>037000254447216</urn:merchantId>
    <urn:interfaceVersion>AU_WS_2.49</urn:interfaceVersion>
    <urn:seal>401b6465f99139500cfd49fe9aec513fd3dc5d106d795ec5d65b6b08d04e49d5</urn:seal>
    <urn:keyVersion>1</urn:keyVersion>
    <urn:cardScheme>CB</urn:cardScheme>
    <urn:panList>5017671000001001</urn:panList>
    <urn:panList>5017671000001002</urn:panList>
  </urn:input>
</urn:update>

Response

Required

ausReturnCode

presence

Required

Interface version

2.49

Format

N2(restricted values)

Worldline Sips server return code.

List of values

00

Request correct and processed

03

Merchant contract invalid or not enrolled AccountUpdaterService

12

Invalid transaction. Please check the request parameters

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

90

Service temporarily not available

99

Temporarily problem with the AccountUpdaterService
seal

presence

Required

Interface version

2.49

Format

ANS128

Message seal used to ensure the integrity of the request and the authentication of sender / receiver of the message.

Optional

accountUpdateResultList

presence

Optional

Interface version

2.49

Format

Container

PAN update service result list.
Contains
- ausNativeAppCode
  
  presence
  
  Optional
  
  Interface version
  
  2.49
  
  Format
  
  N3
  
  Contains the native response code of the PAN update service (Depending on the cardScheme).
  
  List of values
  
  000
  
  OK
  
  203
  
  Format Invalid (Data element not in the required format or value is invalid) For example, not numeric or wrong length.
  
  301
  
  There is no new card available for this PAN
  
  302
  
  Data encryption/decryption failure (due to technical or other reason)
- ausResponseStatus
  
  presence
  
  Optional
  
  Interface version
  
  2.49
  
  Format
  
  ANS
  
  Response status of account update service.
  
  List of values
  
  ACCOUNT_NOT_UPDATED
  
  No update available for this PAN
  
  ACCOUNT_UPDATED
  
  PAN updated
  
  INVALID_ACCOUNT_NUMBER
  
  Invalid account number
  
  INVALID_PAYMENTMEAN_FOR_WALLET
  
  Invalid payment mean in wallet
  
  INVALID_TOKEN
  
  Invalid token
  
  INVALID_WALLET
  
  Invalid wallet
  
  SCHEME_INTERNAL_ERROR
  
  Internal error in Scheme System
  
  TOKEN_RENEWAL_ERROR
  
  Error during token update
  
  WALLET_RENEWAL_ERROR
  
  Error during wallet update
- newCardExpiryDate
  
  presence
  
  Optional
  
  Interface version
  
  2.49
  
  Format
  
  N6(YYYYMM)
  
  New PAN expiry date.
- newMerchantWalletId
  presence
  
  Conditional
  
  Interface version
  
  2.50
  Format
  
  AN21(restricted String)
  New customer’s Wallet identifier.
- newPan
  
  presence
  
  Conditional
  
  Interface version
  
  2.49
  
  Format
  
  N19
  
  New PAN (Primary Account Number).
- newPaymentMeanId
  
  presence
  
  Conditional
  
  Interface version
  
  2.50
  
  Format
  
  N6
  
  New payment mean rank in Worldline Sips wallet.
- newTokenPan
  presence
  
  Conditional
  
  Interface version
  
  2.50
  Format
  
  AN35(restricted String)
  New tokenPan.
- oldMerchantWalletId
  presence
  
  Conditional
  
  Interface version
  
  2.50
  Format
  
  AN21(restricted String)
  Old customer’s Wallet identifier.
- oldPan
  
  presence
  
  Conditional
  
  Interface version
  
  2.49
  
  Format
  
  N19
  
  Old PAN (Primary Account Number) provided in the request (panList).
- oldPaymentMeanId
  
  presence
  
  Conditional
  
  Interface version
  
  2.50
  
  Format
  
  N6
  
  Old payment mean rank in Worldline Sips wallet.
- oldTokenPan
  presence
  
  Conditional
  
  Interface version
  
  2.50
  Format
  
  AN35(restricted String)
  Old tokenPan provided in the request (tokenPanList).
cardScheme

presence

Optional

Interface version

2.49

Format

ANS20(restricted values)

Network name associated with the card.

List of values

CB

Bank Card scheme
errorFieldName

presence

Optional

Interface version

2.49

Format

ANS50

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

Response sample

json
soap

            {
  "accountUpdateResultList": [{
      "oldPan": "5017671000001001",
      "newPan": "5017671000002001",
      "newCardExpiryDate": "202301",
      "ausResponseStatus": "ACCOUNT_UPDATED",
      "ausNativeAppCode": "000"
    },{
      "oldPan": "5017671000001002",
      "newPan": "5017671000002002",
      "newCardExpiryDate": "202302",
      "ausResponseStatus": "ACCOUNT_UPDATED",
      "ausNativeAppCode": "000"
  }],
  "cardScheme": "CB",
  "ausReturnCode": "00",
  "seal": "2231a4786427728cb9fb1dea0c2b6d5ec7d52a635472c5d14877c15ec10d740d"
}

            <updateResponse xmlns="urn:sips:cn:contract:office:accountupdate:v2">
  <output>
    <accountUpdateResultList>
      <oldPan>5017671000001001</oldPan>
      <ausResponseStatus>ACCOUNT_NOT_UPDATED</ausResponseStatus>
      <ausNativeAppCode>301</ausNativeAppCode>
    </accountUpdateResultList>
    <accountUpdateResultList>
      <oldPan>5017671000001002</oldPan>
      <ausResponseStatus>ACCOUNT_NOT_UPDATED</ausResponseStatus>
      <ausNativeAppCode>301</ausNativeAppCode>
    </accountUpdateResultList>
    <cardScheme>CB</cardScheme>
    <ausReturnCode>00</ausReturnCode>
    <seal>097aff519313f6de4ee31212023038abc6d0ad5cffa9ac5fdf6982ae6dec17c0</seal>
  </output>
</updateResponse>

Changelog

Filter

Interface version	Data	Attendance	Container
2.49	`intermediateServiceProviderId`	Request
2.49	`sealAlgorithm`	Request
2.49	`cardScheme`	Request/Response
2.49	`interfaceVersion`	Request
2.49	`keyVersion`	Request
2.49	`merchantId`	Request
2.49	`seal`	Request/Response
2.49	`panList`	Request
2.50	`tokenPanList`	Request
2.50	`walletDataList`	Request
2.50	`merchantWalletId`	Container	`walletDataList`
2.50	`paymentMeanId`	Container	`walletDataList`
2.49	`accountUpdateResultList`	Response
2.49	`ausNativeAppCode`	Container	`accountUpdateResultList`
2.49	`ausResponseStatus`	Container	`accountUpdateResultList`
2.49	`newCardExpiryDate`	Container	`accountUpdateResultList`
2.50	`newMerchantWalletId`	Container	`accountUpdateResultList`
2.49	`newPan`	Container	`accountUpdateResultList`
2.50	`newPaymentMeanId`	Container	`accountUpdateResultList`
2.50	`newTokenPan`	Container	`accountUpdateResultList`
2.50	`oldMerchantWalletId`	Container	`accountUpdateResultList`
2.49	`oldPan`	Container	`accountUpdateResultList`
2.50	`oldPaymentMeanId`	Container	`accountUpdateResultList`
2.50	`oldTokenPan`	Container	`accountUpdateResultList`
2.49	`errorFieldName`	Response
2.49	`ausReturnCode`	Response

Need help?

Consulting the faq