Activate a token of a card

post

http://issuing:8080/issuing/cards/{cardReference}/tokenization/activate

Used to activate a token for a digitization that has been approved and provisioned, but requires additional cardholder authentication prior to activation. It is expected that a cardholder will complete the authentication process using an client's call center or using an client-supplied application, and only then should the client use this API to activate the token.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

cardReference

string

required

Unique ID of the card.

Body Params

Request body for activating a token of a card.

tokenUniqueReference

string

required

The unique reference of the token to be activated, 48 characters.

activationCode

string

Required when card scheme is VISA (empty string otherwise)

reasonCode

string

enum

Reason for the activation. Valid values A - Cardholder successfully authenticated prior to activation , B -Cardholder successfully authenticated with a customer service agent prior to activation

Allowed:

comment

string

length ≤ 500

Headers

X-Date

date-time

Header parameter that informs the date and time when the message was originated. It is used for basic message integrity checks, to ensure that the request is not stale. Note that the header was previously referenced as 'Date' in version 1.0 of the Mobile Money API.

X-CorrelationID

string

Header parameter to uniquely identifies the request. Must be supplied as an UUID.

X-User-Bearer

string

It is used to send the user's access token when OAuth 2.0/OIDC X-User-Bearer framework is used for end-user authentication.

X-API-Key

string

It is used to send the pre-shared client API key to the server.

X-Channel

string

length ≤ 256

String containing the channel used to originate the request. For example USSD, Web, App.

X-TenantID

string

String containing the tenant to use in the request.

Responses

204

Successful response. Token activated.

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

400Bad request.

401An unauthorized execution attempt was detected.

403The received token does not contain any of the required roles.

404There is no resource matching the requested ID or reference.

500An internal error occurred.

503service unavailable.