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