Getting Discount Card Details

Method Description

Invoked with a POST request. Operation name is set up via Maestra framework. Details of method invocation can be found here.

POST https://api.maestra.io/v3/operations/sync?endpointId={unique ID of site/mobile app/etc.}&operation={operation name}&deviceUUID={unique device ID}


Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey {Secret Key, check with the manager if it's mandatory}

<operation>
  <discountCard>
    <ids>
      <number>{card number}</number>
    </ids>
  </discountCard>
</operation>

Sample Operation

POST https://api.maestra.io/v3/operations/sync?endpointId=Maestra&operation=GetDiscountCard

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey 2a4wVO


<operation>
  <discountCard>
    <ids>
      <number>231534554262</number>
    </ids>
  </discountCard>
</operation>

Response

<result>
  <status>Success</status>
  <discountCard>
    <processingStatus>{Found/NotFound}</processingStatus>
    <ids>
      <number>{card number}</number>
    </ids>
    <status>
      <ids>
        <systemName>{internal card status name}</systemName>
      </ids>
    </status>
    <type>
      <ids>
        <externalId>{external card type ID}</externalId>
      </ids>
      <name>{card type name}</name>
    </type>
    <customFields>
      <custom field>{custom field value}</custom field>
    </customFields>
  </discountCard>
</result>

Cards Status

By default, a project has three card types. Maestra also supports customization of card status.

Card Status	Card Status Internal Name
Not issued (in pool)	NotIssued
Issued (not in pool, status unknown)	Issued
Not activated	Inactive
Activated	Activated
Blocked	Blocked