Updating Customer's Bonus Points Balance

Method Description

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

POST https://api.maestra.io/v3/operations/{synch/asynch operation}?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>
  <customer>
    <ids>
      <webSiteUserId>{customer ID}</webSiteUserId>
    </ids>
  </customer>
  <balanceChanges>
    <balanceChange>
      <changeAmount>{balance update}</changeAmount>
      <comment>{comment}</comment>
      <expirationDateTimeUtc>{points expiry date}</expirationDateTimeUtc>
    </balanceChange>
  </balanceChanges>
</operation>

Sample Operations

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

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


<operation>
  <customer>
    <ids>
      <webSiteUserId>5384275</webSiteUserId>
    </ids>
  </customer>
  <balanceChanges>
    <balanceChange>
      <changeAmount>200</changeAmount>
      <comment>For social media likes</comment>
      <expirationDateTimeUtc>2017-12-01 10:00:01.555</expirationDateTimeUtc>
    </balanceChange>
  </balanceChanges>
</operation>