Syntch Gateway API

<back to all web services

PostCheckToken

Tokenization - Checks
Requires Authentication
Requires the role:Merchant
The following routes are available for this service:
POST/merchants/{merchantKey}/tokens/checksCreates a check token for the merchant.
PostCheckToken Parameters:
NameParameterData TypeRequiredDescription
MerchantKeypathintegerYesThe key of the merchant.
CustomerKeypathintegerNoThe key of the customer.
AccountNumbermodelstringYesThe account number.
RoutingNumbermodelstringYesThe routing number.
NameOnCheckmodelstringYesThe name on the check.
AccountTypemodelCheckAccountTypeNoThe account type, checking or savings. Default is checking.

Allowable Values

  • Checking
  • Savings
CheckTypemodelCheckTypeNoThe check type, personal or business. Default is personal

Allowable Values

  • Personal
  • Business
TokenFormatmodelTokenFormat?NoThe token format for this card

Allowable Values

  • Uid
  • Integer
CheckAccountType Enum:
NameValue
Checking1
Savings2
CheckType Enum:
NameValue
Personal1
Business2
TokenFormat Enum:
NameValue
Uid1
Integer2
CardFormat3
CheckTokenDetail Parameters:
NameParameterData TypeRequiredDescription
MerchantKeymodelint?NoThe merchant key.
CustomerKeymodelint?NoThe customer key.
AccountNumbermodelstringNoThe account number.
RoutingNumbermodelstringNoThe routing number.
NameOnCheckmodelstringNoThe name on the check.
AccountTypemodelCheckAccountType?NoThe account type, checking or savings.

Allowable Values

  • Checking
  • Savings
CheckTypemodelCheckType?NoThe check type, personal or business.

Allowable Values

  • Personal
  • Business
TokenmodelstringNoThe token for this check.

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

POST /merchants/{merchantKey}/tokens/checks HTTP/1.1 
Host: syntch.simpay.net 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"MerchantKey":0,"CustomerKey":0,"AccountNumber":"String","RoutingNumber":"String","NameOnCheck":"String","AccountType":"Checking","CheckType":"Personal","TokenFormat":"0"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"MerchantKey":0,"CustomerKey":0,"AccountNumber":"String","RoutingNumber":"String","NameOnCheck":"String","AccountType":"0","CheckType":"0","Token":"String"}