getCardMetaData

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

This function allows a merchant to retrieve informations linked to a scheme token thanks to its reference.

Endpoints

json
soap

PROD

https://office-server.mercanet.com/rs-services/v2/schemeToken/getCardMetaData

method

POST
TEST

https://office-server-mercanet.test.sips-services.com/rs-services/v2/schemeToken/getCardMetaData

method

POST

PROD

https://office-server.mercanet.com/services/v2/schemeToken?wsdl

method

POST
TEST

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

method

POST

Request

Required

interfaceVersion
presence

Required

Interface version

2.0
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

ST_WS_2.

Office (M2M) (SOAP/JSON) interface for scheme token functions.
keyVersion

presence

Required

Interface version

2.0

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

Format

N15

Identifier of the shop, this value is provided to the merchant by Mercanet during the shop registration.
schemeTokenReference

presence

Required

Interface version

2.0

Format

ANS64

Scheme token reference
seal

presence

Required

Interface version

2.0

Format

ANS128

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

Format

AN30

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

presence

Optional

Interface version

2.0

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

            {
  "interfaceVersion":"ST_WS_2.55",
  "keyVersion":"1",
  "merchantId":"029000254447216",
  "schemeTokenReference":"V:eba124454682acfe7e7c17cd06550555",
  "seal":"401b6465f99139500cfd49fe9aec513fd3dc5d106d795ec5d65b6b08d04e49d5"
}

            <urn:getCardMetaData>
  <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:schemeTokenReference>1</urn:schemeTokenReference>
  </urn:input>
</urn:getCardMetaData>

Response

Required

seal

presence

Required

Interface version

2.0

Format

ANS128

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

Optional

cardExpiryDate

presence

Optional

Interface version

2.0

Format

N6(YYYYMM)

Card expiry date. If the card does not have any expiry date, this field is empty.
cardSuffix

presence

Optional

Interface version

2.0

Format

N4

Last 4 digits of the card
errorFieldName

presence

Optional

Interface version

2.0

Format

ANS50

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

presence

Optional

Interface version

2.0

Format

ANS29

Reference of the bank account associated to the card used for the payment.
schemeTokenExpiryDate

presence

Optional

Interface version

2.0

Format

N6(YYYYMM)

Scheme token expiry date
schemeTokenResponseCode

presence

Optional

Interface version

2.0

Format

N2(restricted values)

Scheme token services specific response code

List of values

00

Operation success

03

Invalid scheme token option for the merchant

05

Operation failure

12

Invalid request

25

Unknown scheme token

90

Scheme token service error

99

Technical error
schemeTokenStatus

presence

Optional

Interface version

2.0

Format

ANS20(restricted values)

Current status of the scheme token

List of values

ACTIVE

Scheme token is active

DELETED

Scheme token is deleted

NOT_YET_ACTIVE

Scheme token is not yet active

SUSPENDED

Scheme token is suspended

Response sample

json
soap

            {
  "cardExpiryDate":"202512",
  "cardSuffix":"6387",
  "schemeTokenExpiryDate":"202710"
  "paymentAccountReference":"V0010013020027326564224144146",
  "schemeTokenResponseCode":"00",
  "schemeTokenStatus":"ACTIVE",
  "seal": "738f95f839b1a0a8bab6030d84e08d1cb6cc2513906f659ac07ba5a011c9bb76"
}

            <getCardMetaDataResponse xmlns="urn:sips:cn:contract:office:schemetoken:v2">
  <output>
    <schemeTokenStatus>ACTIVE</schemeTokenStatus>
    <paymentAccountReference>V0010013020027326564224144146</paymentAccountReference>
    <schemeTokenExpiryDate>202710</schemeTokenExpiryDate>
    <cardExpiryDate>202512</cardExpiryDate>
    <cardSuffix>6387</cardSuffix>
    <cardExpiryDate>00</cardExpiryDate>
    <cardSuffix>00</cardSuffix>
    <seal>097aff519313f6de4ee31212023038abc6d0ad5cffa9ac5fdf6982ae6dec17c0</seal>
    <schemeTokenResponseCode>00</schemeTokenResponseCode>
  </output>
</getCardMetaDataResponse>

Changelog

Filter

Interface version	Data	Attendance
2.0	`intermediateServiceProviderId`	Request
2.0	`sealAlgorithm`	Request
2.0	`interfaceVersion`	Request
2.0	`keyVersion`	Request
2.0	`merchantId`	Request
2.0	`schemeTokenReference`	Request
2.0	`seal`	Request/Response
2.0	`cardExpiryDate`	Response
2.0	`cardSuffix`	Response
2.0	`errorFieldName`	Response
2.0	`paymentAccountReference`	Response
2.0	`schemeTokenExpiryDate`	Response
2.0	`schemeTokenResponseCode`	Response
2.0	`schemeTokenStatus`	Response

getCardMetaData

Endpoints

Request

Required

`interfaceVersion`

`keyVersion`

`merchantId`

`schemeTokenReference`

`seal`

Optional

`intermediateServiceProviderId`

`sealAlgorithm`

Request sample

Response

Required

`seal`

Optional

`cardExpiryDate`

`cardSuffix`

`errorFieldName`

`paymentAccountReference`

`schemeTokenExpiryDate`

`schemeTokenResponseCode`

`schemeTokenStatus`

Response sample

Changelog

Need help?