AIM Web Services

<back to all web services

GetCustomerTokensRequest

GetCustomerTokens
Requires active-e Customer Service.

The following routes are available for this service:
POST, GET/api/GetCustomerTokens
GetCustomerTokensRequest Parameters:
NameParameterData TypeRequiredDescription
GetExpiredCardsbodybool?No
GetInactiveCardsbodybool?No
Acctbodyint?No
BaseSecureRequest Parameters:
NameParameterData TypeRequiredDescription
TokenHeaderstringNo
DeviceIdHeaderstringNo
AppIdHeaderstringYes
BaseRequest Parameters:
NameParameterData TypeRequiredDescription
ApiKeyheaderstringYesThis is your AIM API Key provided by Tri-Tech
OAuthTokenheaderstringNo
GetCustomerTokensResponse Parameters:
NameParameterData TypeRequiredDescription
CustomerTokensformList<CcInfo>No
AchformAchDetailNo
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
StatusbodyBaseResponseResultNo
BaseResponseResult Parameters:
NameParameterData TypeRequiredDescription
StatusCodebodystringNo
LoginbodystringNo
ErrorCodebodystringNo
ErrorDisplayTextbodystringNo
ErrorMessagebodystringNo
DomainNamebodystringNo
IpAddressbodystringNo
CcInfo Parameters:
NameParameterData TypeRequiredDescription
TokenStrquerystringYesToken returned from processor
CardTypequerystringYesCard Type (VISA, MCARD, AMEX, DSCVR)
LastFourquerystringYesLast four of the card
ExpirationquerystringNoExpiration Date of the Card. (MM/YY)
ReasonOnFilequerystringNoReason the card is on file.
TokenPkqueryintegerNoID of the existing Token Record in AIM, if applicable
PrimaryquerybooleanNoIs this the customer's primary card? Defaults to false.
AchDetail Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
BankNumberformstringNo
RoutingformstringNo
TypeformstringNo

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

HTTP + XML

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

POST /api/GetCustomerTokens HTTP/1.1 
Host: active-ewebservice.biz 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<GetCustomerTokensRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AIM.WebService">
  <ApiKey>String</ApiKey>
  <OAuthToken>String</OAuthToken>
  <AppId>String</AppId>
  <DeviceId>String</DeviceId>
  <Token>String</Token>
  <Acct>0</Acct>
  <GetExpiredCards>false</GetExpiredCards>
  <GetInactiveCards>false</GetInactiveCards>
</GetCustomerTokensRequest>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<GetCustomerTokensResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AIM.WebService">
  <Status>
    <DomainName>String</DomainName>
    <ErrorCode>String</ErrorCode>
    <ErrorDisplayText>String</ErrorDisplayText>
    <ErrorMessage>String</ErrorMessage>
    <IpAddress>String</IpAddress>
    <Login>String</Login>
    <StatusCode>String</StatusCode>
  </Status>
  <Ach>
    <BankNumber>String</BankNumber>
    <Name>String</Name>
    <Routing>String</Routing>
    <Type>String</Type>
  </Ach>
  <CustomerTokens>
    <CCInfo>
      <CardType>String</CardType>
      <Expiration>String</Expiration>
      <LastFour>String</LastFour>
      <Primary>false</Primary>
      <ReasonOnFile>String</ReasonOnFile>
      <TokenPk>0</TokenPk>
      <TokenStr>String</TokenStr>
    </CCInfo>
  </CustomerTokens>
</GetCustomerTokensResponse>