Mindbody · Schema

PurchaseGiftCardRequest

Implementation of the 'PurchaseGiftCardRequest' model.

FitnessWellnessBeautySchedulingBookingPoint of SaleStudiosSalonsSpasWebhooks

Properties

Name Type Description
LocationId integer The ID of the location where the gift card is being sold.
PurchaserClientId string The RSSID of the client who is purchasing the gift card.
GiftCardId integer The product ID of the gift card being purchased.
Test boolean When `true`, allows you to test the request without affecting the database.
When `false`, the request is carried out and the database is affected.
LayoutId integer The ID of the layout used for the gift card’s image.
SendEmailReceipt boolean When `true`, indicates that a purchase receipt email should be sent to the purchasing client, if all settings are correctly configured.
When `false`, no email is sent to the purchaser.
RecipientEmail string The email address to send the gift card image to. This parameter is required if the `LayoutId` is not 0.
Maximum length: **100**
RecipientName string The name of the person who is to receive the gift card. This parameter is required if the `LayoutId` is not 0.
Maximum length: **20**
Title string The text to use as the title of the gift card, for example: Happy Birthday, Maria! This parameter is required if the `LayoutId` is not 0.
Maximum length: **20**
GiftMessage string A personal message to include in the gift card.
Maximum length: **300**
DeliveryDate string The date that the gift card’s image is to be delivered to the recipient. This parameter cannot be set to a date in the past. This parameter is required if the `LayoutId` is not 0. Default: **today** M
PaymentInfo object Contains information about the payment.
SalesRepId integer The ID of the staff member who is to be marked as the sales rep for this gift card purchase.
ConsumerPresent boolean When `true`, indicates that the consumer is available to address any SCA challenge issued by the bank. EU Only.
Default: **false**
PaymentAuthenticationCallbackUrl string This is the Url the consumer will be redirected back to after completion of the Banks SCA challenge.
BarcodeId string Sets the barcode ID of the giftcard. When not provided, a barcode ID is automatically generated.
If a giftcard with the given barcode ID already exists and the site supports reloadable giftcards
SenderName string Overrides the name that would otherwise be populated by specifying PurchaserClientId.
Maximum length: **20**
View JSON Schema on GitHub

JSON Schema

public-api-v6-purchase-gift-card-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/mindbody/refs/heads/main/json-schema/public-api-v6-purchase-gift-card-request-schema.json",
  "title": "PurchaseGiftCardRequest",
  "description": "Implementation of the 'PurchaseGiftCardRequest' model.",
  "type": "object",
  "properties": {
    "LocationId": {
      "type": "integer",
      "format": "int32",
      "description": "The ID of the location where the gift card is being sold.",
      "example": 123456
    },
    "PurchaserClientId": {
      "type": "string",
      "description": "The RSSID of the client who is purchasing the gift card.",
      "example": "example-value"
    },
    "GiftCardId": {
      "type": "integer",
      "format": "int32",
      "description": "The product ID of the gift card being purchased.",
      "example": 123456
    },
    "Test": {
      "type": "boolean",
      "description": "When `true`, allows you to test the request without affecting the database.<br /> When `false`, the request is carried out and the database is affected.",
      "example": true
    },
    "LayoutId": {
      "type": "integer",
      "format": "int32",
      "description": "The ID of the layout used for the gift card\u2019s image.",
      "example": 123456
    },
    "SendEmailReceipt": {
      "type": "boolean",
      "description": "When `true`, indicates that a purchase receipt email should be sent to the purchasing client, if all settings are correctly configured.<br /> When `false`, no email is sent to the purchaser.",
      "example": true
    },
    "RecipientEmail": {
      "type": "string",
      "description": "The email address to send the gift card image to. This parameter is required if the `LayoutId` is not 0.<br /> Maximum length: **100**",
      "example": "[email protected]"
    },
    "RecipientName": {
      "type": "string",
      "description": "The name of the person who is to receive the gift card. This parameter is required if the `LayoutId` is not 0.<br /> Maximum length: **20**",
      "example": "example-value"
    },
    "Title": {
      "type": "string",
      "description": "The text to use as the title of the gift card, for example: Happy Birthday, Maria! This parameter is required if the `LayoutId` is not 0.<br /> Maximum length: **20**",
      "example": "example-value"
    },
    "GiftMessage": {
      "type": "string",
      "description": "A personal message to include in the gift card.<br /> Maximum length: **300**",
      "example": "example-value"
    },
    "DeliveryDate": {
      "type": "string",
      "format": "date-time",
      "description": "The date that the gift card\u2019s image is to be delivered to the recipient. This parameter cannot be set to a date in the past. This parameter is required if the `LayoutId` is not 0. Default: **today** Minimum: **today**",
      "example": "2026-05-28T14:30:00Z"
    },
    "PaymentInfo": {
      "$ref": "#/components/schemas/CheckoutPaymentInfo",
      "description": "Contains information about the payment."
    },
    "SalesRepId": {
      "type": "integer",
      "format": "int32",
      "description": "The ID of the staff member who is to be marked as the sales rep for this gift card purchase.",
      "example": 123456
    },
    "ConsumerPresent": {
      "type": "boolean",
      "description": "When `true`, indicates that the consumer is available to address any SCA challenge issued by the bank. EU Only.<br /> Default: **false**",
      "example": true
    },
    "PaymentAuthenticationCallbackUrl": {
      "type": "string",
      "description": "This is the Url the consumer will be redirected back to after completion of the Banks SCA challenge.",
      "example": "https://example.mindbodyonline.com/resource/abc123"
    },
    "BarcodeId": {
      "type": "string",
      "description": "Sets the barcode ID of the giftcard. When not provided, a barcode ID is automatically generated.<br /> If a giftcard with the given barcode ID already exists and the site supports reloadable giftcards, the existing giftcard is reloaded<br /> Maximum length: **100**",
      "example": "example-value"
    },
    "SenderName": {
      "type": "string",
      "description": "Overrides the name that would otherwise be populated by specifying PurchaserClientId.<br /> Maximum length: **20**",
      "example": "example-value"
    }
  }
}