GiftCertificate document (Data API 23.2)
(supports custom properties)
Document representing a gift certificate
Property | Type | Constraints | Description |
---|---|---|---|
amount |
Money | The gift certificate amount. The user cannot change the gift certificate amount after the creation of the gift certificate. | |
balance |
Money | The gift certificate balance. This is a computed attribute and cannot be modified. | |
creation_date |
Date | Returns the value of attribute 'creationDate'. | |
description |
String | maxLength=4000 | The description of the gift certificate. |
enabled |
Boolean | The enabled flag of the gift certificate. | |
last_modified |
Date | Returns the value of attribute 'lastModified'. | |
link |
String | The URL to get the gift certificate. This is a computed attribute and cannot be modified. | |
masked_gift_certificate_code |
String | The masked gift certificate code with all but the last 4 characters replaced with a '*' character. This is a computed attribute and cannot be modified. | |
merchant_id |
String | The merchant ID of the gift certificate. This is a unique attribute. This is a computed attribute and cannot be modified. This is used to get, update and the delete gift certificates. | |
message |
String | maxLength=4000 | The message to the recipient of the gift certificate. |
order_no |
String | The order number of the gift certificate. | |
recipient_email |
String | The email address of the recipient of the gift certificate. | |
recipient_name |
String | maxLength=256 | The recipient of the gift certificate. |
sender_name |
String | maxLength=256 | The sender of the gift certificate. |
status |
Enum {issued, partially_redeemed, pending, redeemed} | The status of the gift certificate. While creating a gift certificate, user can set the status to either "pending" or "issued" only. | |
transactions |
[AccountTransaction] | The transactions of the gift certificate. This attribute is only available as part of the response. |
X
OCAPI versions 15.x and 16.x will be retired on March 31, 2021. For dates and more information, see the OCAPI versioning and deprecation policy and this Knowledge Article.