v1

latestOpenAPI 3.0.02026-07-2352269214.0 KB

Request to check digital card account eligibility

This method is used by wallet server to check that a card account is eligible for provisioning.

post/checkCardAccount

Headers

x-podstring required

HTTP header identifying the pod and corresponding DNS hostname of the load balancer from which traffic is coming.</br> Subsequent API calls should be sent to this pod.

Request body

issuerIdstring required
cardAccountDescriptorCardAccountDescriptor required

The Card Account Descriptor.<br/>Depending on cardSource, it shall be formatted as follows:

  • For ON-FILE:<br/>"cardAccountDescriptor" : {"walletCardAccountId" : "1234"}
  • For USER-INPUT, CLIENT-SDK and READER-MODE:<br/>"cardAccountDescriptor" : {"opaqueCardAccountData" : "data returned by Issuer backend to Wallet"}
cardSource'ON-FILE' | 'CLIENT-SDK' | 'USER-INPUT' | 'READER-MODE'

Response

checkCardAccount response payload

termsAndConditionsIdstring

Unique identifier of the T&C to be presented to the end user.</br> If T&Cs are not required, all 0's should be returned.</br> getAsset API will be used to retrieve the T&Cs content.

cardArtManifeststring[]

Array of GUIDs required to build card art.</br> Each cart art can be retrieved using getAsset API with corresponding GUID.