Sign in

v1

latestOpenAPI 3.0.02026-07-2352269214.0 KB

Request to create a digital card account

This method is used by TSH to request the creation of a digital card account to the TES.</br> This request can come with a payment order which comprises a payment instrument and either the identifier of wallet card used or the wallet account used for the payment</br> In this case, the TES is responsible for returning an order confirmation in the form of a purchase identifier in all cases where the user may be deducted money.</br> The TES shall also create a new card account associated to a unique identifier. In case of stored value account, the card account identifier shall be the card iedntifier.

post/createCardAccount

Headers

x-actor-idstring required

HTTP header identifying the actor initiating the request.

Request body

issuerIdstring required
walletProviderIdstring required

The Wallet Provider Identifier.<br/>For example:<li>APPLE_PAY<li>HUAWEI_PAY<li>XIAOMI_PAY

productIdstring required

The Product Identifier. Unique for each product.</br> It is used by TSH to find the right metadata (e.g. card arts) associated to the product.

opaqueServiceProviderDataOpaqueServiceProviderData

This object gives additional service provider data captured by the wallet provider during a payment.</br>The structure of this object is opaque to TSH.

Response

createCardAccount response payload

cardAccountIdstring

The Card Account Identifier. Unique for each card account.

purchaseIdstring
signaturestring

Signature covering the concatenation of the UTF-8 encoded bytes of orderId followed by purchaseId.</br> It is a ECDSA signature in PKCS7 format.