Supported Processors
Request the activation service to activate a single gift card or activate a group of gift cards in bulk.
To create a card-present gift card activation request:
Step 1Do not include any other services in the request.
Step 2Include the required fields in the request:
ncard_accountNumber or pos_trackData
ncard_cardType
ngiftCard_extendedAccountNumber—required if defined in the promotion level.
ngiftCardActivationService_commerceIndicator—set to internet.
ngiftCardActivationService_run—set to true.
nmerchantID
nmerchantReferenceCode
nmerchantTransactionIdentifier—required only on ValueLink.
npurchaseTotals_currency
npurchaseTotals_grandTotalAmount—required only for non-denominated cards.
See API Fields for:
nDetailed descriptions of these required request fields
nOptional request fields
nResponse fields
To create a card-present gift card bulk activation request:
Step 1Do not include any other services in the request.
Step 2Include the required fields in the request:
ncard_accountNumber
ncard_cardType
ngiftCard_additionalAccountNumber
ngiftCard_count
ngiftCard_physicalCard
ngiftCard_returnExtendedAccountNumber
ngiftCardActivationService_commerceIndicator—set to retail.
ngiftCardActivationService_run—set to true.
nmerchantID
nmerchantReferenceCode
nmerchantTransactionIdentifier—required only on ValueLink.
npurchaseTotals_currency
npurchaseTotals_grandTotalAmount
See API Fields for:
nDetailed descriptions of these required request fields
nOptional request fields
nResponse fields
To create a card-not-present gift card activation request:
Step 1Do not include any other services in the request.
Step 2Include the required fields in the request:
ncard_cardType
ngiftCard_count—set to 1.
ngiftCard_physicalCard—set to false.
ngiftCard_promoCode
ngiftCard_returnExtendedAccountNumber
ngiftCardActivationService_commerceIndicator
ngiftCardActivationService_run—set to true.
nmerchantID
nmerchantReferenceCode
nmerchantTransactionIdentifier—required only on ValueLink.
npurchaseTotals_currency
See API Fields for:
nDetailed descriptions of these required request fields
nOptional request fields
nResponse fields
Request the balance inquiry service to obtain the balance of a gift card.
To create a gift card balance inquiry request:
Step 1Do not include any other services in the request.
Step 2Include the required fields in the request:
ncard_accountNumber or pos_trackData
ncard_cardType
ngiftCard_balanceCurrency
ngiftCard_extendedAccountNumber—required if defined in the promotion level.
ngiftCardBalanceInquiryService_commerceIndicator—set to internet.
ngiftCardBalanceInquiryService_run—set to true.
nmerchantID
nmerchantReferenceCode
See API Fields for:
nDetailed descriptions of these required request fields
nOptional request fields
nResponse fields