Gift Cards Status Update Bulk Import
Method Description
Invoked with a POST request. Request address and parameters are set up via Maestra framework.
POST https://api.maestra.io/v3/operations/bulk?endpointId={API endpoint ID}&operation=DirectCrm.GiftCards.Import&csvCodePage=65001
HTTP/1.1
Authorization: SecretKey {Secret Key}
Accept: application/xml
Content-Type: text/csv- csvCodePage: Windows codepage ID for CSV file. 65001 (UTF-8) is preferred.
- csvColumnDelimiter: Column delimiter character in CSV file.
- csvTextQualifier: Optional start/end character in column value, masking otherwise invalid characters.
- Authorization key: The value is obtained via Maestra.
- The service allows up to 60 imports per hour. If the limit is exceeded, you’ll receive 429 Too Many Requests until the ratio of tasks queued/hour drops below 60.
Field Descriptions
| Title | Description |
|---|---|
| CustomFieldNumber | Gift card number |
| Amount | Card balance |
| ActivationDateTimeUtc | Card purchase (activation) date in UTC+0 |
| ActivatedPointOfContact | Point of contact where the card was purchased |
| ActivatedCustomerId | Purchasing customer ID |
| UsedDateTimeUtc | Card redemption date and time in UTC+0 |
| UsedPointOfContact | Point of contact where the card was redeemed |
| UsedCustomerId | Redeeming customer ID |
| BlockedDateTimeUtc | Card blocking date and time in UTC+0 |
Sample Request
POST https://api.maestra.io/v3/operations/bulk?endpointId=Maestra&operation=DirectCrm.GiftCards.Import&csvCodePage=65001
Authorization: SecretKey mDdO
Accept: application/xml
Content-Type: text/csv
CustomFieldNumber;Amount;ActivationDateTimeUtc;ActivatedPointOfContact;ActivatedMaestraId
6768953;5000;18.10.2016 20:02;Shop123;2342357Updated about 1 year ago