Syntch Gateway API

<back to all web services

PatchCardToken

Tokenization - Cards
Requires Authentication
Requires the role:Merchant
The following routes are available for this service:
PATCH/merchants/{merchantKey}/tokens/cards/{token}Updates a card token for the merchant.
PatchCardToken Parameters:
NameParameterData TypeRequiredDescription
MerchantKeypathintegerYesThe key of the merchant.
TokenpathstringYesThe card token.
CardNumbermodelstringNoThe card number.
ExpirationDatemodelstringNoThe expiration date, formatted as MMYY.
NameOnCardmodelstringNoThe name on the card.
StreetAddressmodelstringNoThe street address for the card.
PostalCodemodelstringNoThe postal code for the card.
CardTokenDetail Parameters:
NameParameterData TypeRequiredDescription
MerchantKeymodelint?NoThe merchant key.
CustomerKeymodelint?NoThe customer key.
CardNumbermodelstringNoThe card number.
ExpirationDatemodelstringNoThe expiration date, formatted as MMYY.
CardTypemodelstringNoThe card type.
NameOnCardmodelstringNoThe name on the card.
StreetAddressmodelstringNoThe street address for the card.
PostalCodemodelstringNoThe postal code for the card.
TokenmodelstringNoThe token for the card.

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

PATCH /merchants/{merchantKey}/tokens/cards/{token} HTTP/1.1 
Host: syntch.simpay.net 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	MerchantKey: 0,
	Token: String,
	CardNumber: String,
	ExpirationDate: String,
	NameOnCard: String,
	StreetAddress: String,
	PostalCode: String
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	MerchantKey: 0,
	CustomerKey: 0,
	CardNumber: String,
	ExpirationDate: String,
	CardType: String,
	NameOnCard: String,
	StreetAddress: String,
	PostalCode: String,
	Token: String
}