updatePaymentMean
To search in the page use Ctrl+F on your keyboard
This function allows you to update one of the payment means contained in the client’s wallet. If the account or the payment mean do not exist, a 01 response code is returned. If the update works, 00 response code is returned and the date of update.
Recommended interfaceVersion: WR_WS_2.49
Endpoints
-
- PROD
-
https://office-server.sogenactif.com/rs-services/v2/wallet/updatePaymentMean
- method
- POST
-
- TEST
-
https://office-server-sogenactif.test.sips-services.com/rs-services/v2/wallet/updatePaymentMean
- method
- POST
-
- PROD
-
https://office-server.sogenactif.com/services/v2/wallet?wsdl
- method
- POST
-
- TEST
-
https://office-server-sogenactif.test.sips-services.com/services/v2/wallet?wsdl
- method
- POST
Request
Required
-
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
WR_WS_2.
- WR_WS: Sogenactif Office Serveur (SOAP/JSON) interface for Wallet functions.
-
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.
-
merchantWalletId
- presence
- Required
- Interface version
- 2.0
Customer’s Wallet identifier.
-
paymentMeanId
- presence
- Required
- Interface version
- 2.0
Payment mean rank in Sogenactif wallet.
-
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
-
intermediateServiceProviderId
- presence
- Optional
- Interface version
- 2.12
Identifier of the Service used by the merchant for the exchanges with the Sogenactif platform.
-
paymentMeanAlias
- presence
- Optional
- Interface version
- 2.0
Payment mean alias defined by the Buyer and used in the Buyer’s wallet.
Attention: use this free field only for the intended purpose, and therefore do not insert any personal data, especially cardholder data.
-
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
Request sample
{
"interfaceVersion": "WR_WS_2.3",
"keyVersion": "1",
"merchantId": "011223344550000",
"merchantWalletId": "walId011",
"paymentMeanAlias": "myAlias",
"paymentMeanId": "2",
"seal": "1e26289499d5f6104e6300291f272d7b994a111eecf8feedccf934560de26e5d"
}
<urn:updatePaymentMean>
<urn:input>
<urn:merchantId>011223344550000</urn:merchantId>
<urn:interfaceVersion>WR_WS_2.2</urn:interfaceVersion>
<urn:merchantWalletId>walId011</urn:merchantWalletId>
<urn:paymentMeanId>2</urn:paymentMeanId>
<urn:paymentMeanAlias>myAlias</urn:paymentMeanAlias>
</urn:input>
</urn:updatePaymentMean>
Response
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.
-
walletActionDateTime
- presence
- Optional
- Interface version
- 2.0
Date and time of the action on the wallet, in Sogenactif system at the merchant’s local time (in the merchant’s time zone)
-
walletResponseCode
- presence
- Optional
- Interface version
- 2.0
Sogenactif server response code for wallet Management.
List of values
00
- Successful operation
03
- Invalid Merchant contract
12
- Invalid data, verify the request
25
- Wallet / payment mean unknown by Sogenactif
30
- Format error
40
- merchantId not allowed to access this wallet service
94
- Duplicated wallet / payment mean
99
- Temporary problem at the Sogenactif server level
Response sample
{
"walletActionDateTime": "2014-05-19T23:19:54-12:00",
"walletResponseCode": "00",
"seal": "4d40a4af0fe8ceaf1370ab5e434c6ba939973bcacf33f202c72c47a8ab622c19"
}
<updatePaymentMeanResponse xmlns="urn:sips:cn:contract:office:wallet:v2">
<output>
<walletActionDateTime>2012-10-17T23:50:44-12:00</walletActionDateTime>
<walletResponseCode>00</walletResponseCode>
<errorFieldName />
</output>
</updatePaymentMeanResponse>