deleteCardData

Synopsis:

This API request deletes the card data from the card database given the ‘card-id’. The ‘card-id’ is the identifier from your system to identify the card or card data uniquely. All the delivered cards with this data are not affected but any future requests to deliver/update/generate Wallet Card with this data will result in failure. For more info see below for Mandatory/Optional fields and Error codes.

Request: JSON

{
	"action" : "deletecarddata",
	"api-key" : "API KEY",
	"card-id" : "CUSTOM CARD ID"
}

Request Parameters:

Mandatory: 
action - The API Action, 
api-key - The API Key assigned to your account. It's case sensitive, 
card-id - The custom card id unique per card data. Case-Sensitive, 

Optional: N/A

Response Parameters:

status, card-id, error-code, error-message

Request Example: JSON

{
	"action" : "deletecarddata",
	"api-key" : "qTFkykO9JTfahCOqJ0V2Wf5Cg1t8iWlZ",
	"card-id" : "EventTicket124"
}

Response Example: Success

{
	"status" : "Success",
	"card-id" : "EventTicket124"
}

Response Example: Failure

{
	"status" : "Failure",
	"error-code" : "E821",
	"error-message" : "Internal Error. The card was not deleted."
}

General Error Codes:

Code Description
E100 Invalid request. Make a valid request via JSON POST with all the required variables.
E104 Account Authentication Failed.
E105 This account does not have API access.
E107 This account is not allowed to use this action.
E108 Corrupt JSON in the request. $error.
E109 This account does not have API activated.
E112 API call rejected. IP is not white-listed.
E113 API call rejected. Set throughput exceeded for this API action.
E114 API call rejected. Phone number is blacklisted.
E120 This account has reached the API request limit.
E503 Internal error.


Code Description
E808 The card-id value is invalid.
E810 The card-id value is required.
E821 Internal Error. The card was not deleted.


Key Term Definitions:

Term Description
action This is the name of the function you want to execute with the API.
api-key Random key that is assigned to an account that can be used for authorization instead of USER/CARD. You can find and regenerate this key on the ‘API Settings’ page.
card-id The identifier from your system to identify the card or card data uniquely.