# JPMC-PDP Documentation from https://developer.payments.jpmorgan.com

# Gift card transactions

Manage gift cards from beginning to end. Activate, redeem, and check the balance on gift cards, right from the payment terminal. 

## Supported transactions

Payment Terminal Application supports the following gift card transactions:

- Redemption

- Issuance

- Activation

- Balance Inquiry

- Force Redemption

- Force Issuance

- Force Activation

- Deactivation

- Reactivation

## Transaction request fields

The presence of each field in a gift card transaction request or response is mandatory, optional, conditional, or present:

**Mandatory **fields are required to be present.

**Optional** fields are not required and depend on the transaction context.

**Conditional** fields are required to support a specific feature or scenario.

**Present** fields are included by default in a response.

## Gift card transaction type

### Redemption

Use type `GC_REDEMPTION` to redeem a gift card payment.

Redemption transactions are always authorized online and, based on your configuration, support tips and partial redemptions.

 
**Properties of a gift card redemption transaction**

| Item | Description | 
| --- | --- | 
| Operation name displayed on a terminal | Redemption | 
| Operation name displayed on a receipt | REDEMPTION | 
| Merchant is requested to supply the following data | Password, Invoice number, Table number, Clerk or Server, Gift card transaction reference, Cash out | 
| Cardholder is requested to supply the following data | Card, tip, signature | 
| ISO transaction message | 1200 | 
| Can the operation be autoreversed? | Yes | 
| Does the operation use data supplied by the cardholder? | Yes | 
| Merchant copy of the receipt? | Yes | 
| Cardholder copy of the receipt? | Yes | 
| Is the receipt stored as “last receipt”? | Yes | 
| Can the receipt have a signature line? | Yes | 

**Request fields**

 
**Request fields for redemption**

| Field | Description | Presence | 
| --- | --- | --- | 
| operation | Contains the value Transaction | Mandatory | 
| type | Defines the transaction type of the gift card request. Must contain GC_REDEMPTION | Mandatory | 
| requestedAmount | The numeric amount for your request. No other characters are permitted. The amount value contains two implied decimal places. For example, the value 50000 represents $500.00 and the value 500 represents $5.00. | Mandatory | 
| reference | A POS-generated reference number. If you do not provide a value, Payment Terminal Application generates this value internally. Maximum of 12 alphanumeric characters. | Optional | 
| invoice | The invoice number associated with the transaction. Maximum of 6 numeric characters. | Optional | 
| customer | The customer number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| ticket | The ticket number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| purchase | The purchase number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| order | The order number associated to the transaction. Maximum of 9 alphanumeric characters. | Optional | 
| tipAmount | If you provide a tipAmount, Payment Terminal Application does not prompt for tip during the transaction flow. | Optional | 
| duplicateCheck | If you send a value of 1, Payment Terminal Application checks the last performed transaction for a matching card number and amount. If the previous transaction matches, Payment Terminal Application returns as error. Value: - 0 = ignore duplicates - 1 = check duplicates | Optional | 
| printReceipt | Applies to receipts printed by the payment terminal device or an attached printer. If you do not send this field, Payment Terminal Application does not print a receipt. Value: - 0 = do not print receipt (default) - 1 = print receipt (if supported) | Optional | 
| cashOutInd | Indicates your request to cash out the remaining balance of the gift card. Value: - 0 = do not request cash out. - 1 = request cash out. | Optional | 
| giftReference | Additional reference number on gift card transactions. When present, giftReference is included in host messages and printed on receipts. Maximum of 15 alphanumeric characters. | Optional | 
| paymentType | Provides information on the payment method used to support a gift card transaction. Value: - 0 = cash - 1 = credit card - 2 = debit card - 3 = complimentary | Optional | 

Refer to the following example of a gift card redemption request.

```json
{
  "operation": "Transaction",
  "type": "GC_REDEMPTION",
  "requestedAmount": "500"
}
```

Refer to the following example of a gift card redemption response.

```json
{
  "account": "603571*********5942",
  "approval": "approved",
  "authCode": "993048",
  "authorizedAmount": "500",
  "balance": "1500",
  "batchJulianDay": "120",
  "batchNumber": "1",
  "cardholderReceipt": "\n              Merchant Name\n\n\nRRN: 120105455268\nThu,Apr 30,2026         10:54:55\n\n           REDEMPTION\n\n            APPROVED\n\n       ***************5942\nGIFT CARD                 Swiped\n\nAMOUNT                     $5.00\nSUBTOTAL                   $5.00\n            ____________________\nTOTAL                      $5.00\n\nRemaining Balance:        $15.00\n\nTransaction ID:\n                1200000011000003\nBatch#:                  120-001\nApproval Code:            993048\n\n\n      *** Customer copy ***\n\n",
  "cashOutAmount": "0",
  "currencyCode": "USD",
  "cvm": "NO CVM",
  "dateTime": "04-30-2026 10:54:55",
  "demoMode": "no",
  "dueAmount": "0",
  "entryMode": "Swiped",
  "expDate": "4912",
  "merchantID": "",
  "merchantReceipt": "\n              Merchant Name\n\n\nRRN: 120105455268\nThu,Apr 30,2026         10:54:55\n\n           REDEMPTION\n\n            APPROVED\n\n       ***************5942\nGIFT CARD                 Swiped\n\nAMOUNT                     $5.00\nSUBTOTAL                   $5.00\n            ____________________\nTOTAL                      $5.00\n\nTransaction ID:\n                1200000011000003\nBatch#:                  120-001\nApproval Code:            993048\n\n\n\nX  ______________________________\n\n      *** Merchant copy ***\n\n",
  "operation": "Transaction",
  "processorLine1": "Merchant Name",
  "reference": "120105455268",
  "requestedAmount": "500",
  "responseCode": "00",
  "result": "0",
  "safState": "-1",
  "safSubmissionState": "0",
  "shift": "0",
  "signatureRequired": "yes",
  "table": "0",
  "terminalID": "008",
  "tipAmount": "0",
  "totalAmount": "500",
  "traceNumber": "00023059",
  "transactionID": "1200000011000003",
  "transactionType": "GIFT CARD REDEMPTION",
  "type": "GC_REDEMPTION",
  "uniqueTransactionId": "700000014312008177756089500000"
}
```

### Issuance

Use type `GC_ISSUANCE` to issue or add value to a gift card.

Issuance operations are always performed online.

 
**Properties of a gift card issuance transaction**

| Item | Description | 
| --- | --- | 
| Operation name displayed on a terminal | Issuance | 
| Operation name displayed on a receipt | ISSUANCE / MULTIPLE ISSUANCE | 
| Merchant is requested to supply the following data | Password, Clerk/Server, Gift card transaction reference. | 
| Cardholder is requested to supply the following data | Card(s) | 
| ISO transaction message | 1200 | 
| Can the operation be autoreversed? | Yes | 
| Does the operation use data supplied by the cardholder? | Yes | 
| Merchant copy of the receipt? | Yes | 
| Cardholder copy of the receipt? | Yes | 
| Is the receipt stored as “last receipt”? | Yes | 
| Can the receipt have a signature line? | No | 

**Request fields**

 
**Request fields for issuance**

| Field | Description | Presence | 
| --- | --- | --- | 
| operation | Contains the value Transaction | Mandatory | 
| type | Defines the transaction type of the gift card request. Must contain GC_ISSUANCE | Mandatory | 
| requestedAmount | The numeric amount for your request. No other characters are permitted. The amount value contains two implied decimal places. For example, the value 50000 represents $500.00 and the value 500 represents $5.00. | Mandatory | 
| reference | A POS-generated reference number. If you do not provide a value, Payment Terminal Application generates this value internally. Maximum of 12 alphanumeric characters. | Optional | 
| invoice | The invoice number associated with the transaction. Maximum of 6 numeric characters. | Optional | 
| customer | The customer number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| ticket | The ticket number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| purchase | The purchase number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| order | The order number associated to the transaction. Maximum of 9 alphanumeric characters. | Optional | 
| printReceipt | Applies to receipts printed by the payment terminal device or an attached printer. If you do not send this field, Payment Terminal Application does not print a receipt. Value: - 0 = do not print receipt (default) - 1 = print receipt (if supported) | Optional | 
| giftReference | Additional reference number on gift card transactions. When present, giftReference is included in host messages and printed on receipts. Maximum of 15 alphanumeric characters. | Optional | 
| paymentType | Provides information on the payment method used to support a gift card transaction. Value: - 0 = cash - 1 = credit card - 2 = debit card - 3 = complimentary | Optional | 

Refer to the following example of a gift card issuance request.

```json
{
  "operation": "Transaction",
  "type": "GC_ISSUANCE",
  "requestedAmount": "1000"
}
```

Refer to the following example of a gift card issuance response.

```json
{
  "account": "603571*********5942",
  "approval": "approved",
  "authCode": "993049",
  "balance": "2500",
  "batchJulianDay": "120",
  "batchNumber": "1",
  "cardholderReceipt": "\n              Merchant Name\n\n\nRRN: 120105632088\nThu,Apr 30,2026         10:56:32\n\n            ISSUANCE\n\n            APPROVED\n\n       ***************5942\nGIFT CARD                 Swiped\n\nAMOUNT                    $10.00\nSUBTOTAL                  $10.00\n            ____________________\nTOTAL                     $10.00\n\nRemaining Balance:        $25.00\n\nTransaction ID:\n                1200000011000004\nBatch#:                  120-001\nApproval Code:            993049\n\n\n      *** Customer copy ***\n\n",
  "currencyCode": "USD",
  "cvm": "NO CVM",
  "dateTime": "04-30-2026 10:56:32",
  "demoMode": "no",
  "entryMode": "Swiped",
  "expDate": "4912",
  "merchantID": "",
  "merchantReceipt": "\n              Merchant Name\n\n\nRRN: 120105632088\nThu,Apr 30,2026         10:56:32\n\n            ISSUANCE\n\n            APPROVED\n\n       ***************5942\nGIFT CARD                 Swiped\n\nAMOUNT                    $10.00\nSUBTOTAL                  $10.00\n            ____________________\nTOTAL                     $10.00\n\nTransaction ID:\n                1200000011000004\nBatch#:                  120-001\nApproval Code:            993049\n\n\n\nX  ______________________________\n\n      *** Merchant copy ***\n\n",
  "operation": "Transaction",
  "processorLine1": "Merchant Name",
  "reference": "120105632088",
  "requestedAmount": "1000",
  "responseCode": "00",
  "result": "0",
  "safState": "-1",
  "safSubmissionState": "0",
  "shift": "0",
  "signatureRequired": "yes",
  "terminalID": "008",
  "totalAmount": "1000",
  "traceNumber": "00023060",
  "transactionID": "1200000011000004",
  "transactionType": "GIFT CARD ISSUANCE",
  "type": "GC_ISSUANCE",
  "uniqueTransactionId": "700000014312008177756099200000"
}
```

### Activation

Use type `GC_ACTIVATION` to activate a new gift card.

 
**Properties of a gift card activation transaction**

| Item | Description | 
| --- | --- | 
| Operation name displayed on a terminal | Activation | 
| Operation name displayed on a receipt | ACTIVATION / MULTIPLE ACTIVATION | 
| Merchant is requested to supply the following data | Password, Clerk/Server, Gift card transaction reference. | 
| Cardholder is requested to supply the following data | Card(s) | 
| ISO transaction message | 1200 | 
| Can the operation be autoreversed? | Yes | 
| Does the operation use data supplied by the cardholder? | Yes | 
| Merchant copy of the receipt? | Yes | 
| Cardholder copy of the receipt? | Yes | 
| Is the receipt stored as “last receipt”? | Yes | 
| Can the receipt have a signature line? | No | 

**Request fields**

 
**Request fields for activation**

| Field | Description | Presence | 
| --- | --- | --- | 
| operation | Contains the value Transaction | Mandatory | 
| type | Defines the transaction type of the gift card request. Must contain GC_ACTIVATION | Mandatory | 
| requestedAmount | The numeric amount for your request. No other characters are permitted. The amount value contains two implied decimal places. For example, the value 50000 represents $500.00 and the value 500 represents $5.00. | Mandatory | 
| reference | A POS-generated reference number. If you do not provide a value, Payment Terminal Application generates this value internally. Maximum of 12 alphanumeric characters. | Optional | 
| invoice | The invoice number associated with the transaction. Maximum of 6 numeric characters. | Optional | 
| customer | The customer number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| ticket | The ticket number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| purchase | The purchase number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| order | The order number associated to the transaction. Maximum of 9 alphanumeric characters. | Optional | 
| printReceipt | Applies to receipts printed by the payment terminal device or an attached printer. If you do not send this field, Payment Terminal Application does not print a receipt. Value: - 0 = do not print receipt (default) - 1 = print receipt (if supported) | Optional | 
| giftReference | Additional reference number on gift card transactions. When present, giftReference is included in host messages and printed on receipts. Maximum of 15 alphanumeric characters. | Optional | 
| paymentType | Provides information on the payment method used to support a gift card transaction. Value: - 0 = cash - 1 = credit card - 2 = debit card - 3 = complimentary | Optional | 

Refer to the following example of a gift card activation request.

```json
{
  "operation": "Transaction",
  "type": "GC_ACTIVATION",
  "requestedAmount": "2000"
}
```

Refer to the following example of a gift card activation response.

```json
{
  "account": "603571*********5942",
  "approval": "approved",
  "authCode": "993047",
  "balance": "2000",
  "batchJulianDay": "120",
  "batchNumber": "1",
  "cardholderReceipt": "\n              Merchant Name\n\n\nRRN: 120105213377\nThu,Apr 30,2026         10:52:13\n\n           ACTIVATION\n\n            APPROVED\n\n       ***************5942\nGIFT CARD                 Swiped\n\nAMOUNT                    $20.00\nSUBTOTAL                  $20.00\n            ____________________\nTOTAL                     $20.00\n\nRemaining Balance:        $20.00\n\nTransaction ID:\n                1200000011000002\nBatch#:                  120-001\nApproval Code:            993047\n\n\n      *** Customer copy ***\n\n",
  "currencyCode": "USD",
  "cvm": "NO CVM",
  "dateTime": "04-30-2026 10:52:13",
  "demoMode": "no",
  "entryMode": "Swiped",
  "expDate": "4912",
  "merchantID": "",
  "merchantReceipt": "\n              Merchant Name\n\n\nRRN: 120105213377\nThu,Apr 30,2026         10:52:13\n\n           ACTIVATION\n\n            APPROVED\n\n       ***************5942\nGIFT CARD                 Swiped\n\nAMOUNT                    $20.00\nSUBTOTAL                  $20.00\n            ____________________\nTOTAL                     $20.00\n\nTransaction ID:\n                1200000011000002\nBatch#:                  120-001\nApproval Code:            993047\n\n\n\nX  ______________________________\n\n      *** Merchant copy ***\n\n",
  "operation": "Transaction",
  "processorLine1": "Merchant Name",
  "reference": "120105213377",
  "requestedAmount": "2000",
  "responseCode": "00",
  "result": "0",
  "safState": "-1",
  "safSubmissionState": "0",
  "shift": "0",
  "signatureRequired": "yes",
  "terminalID": "008",
  "totalAmount": "2000",
  "traceNumber": "00023058",
  "transactionID": "1200000011000002",
  "transactionType": "GIFT CARD ACTIVATION",
  "type": "GC_ACTIVATION",
  "uniqueTransactionId": "700000014312008177756073300000"
}
```

### Balance Inquiry

Use type `GC_BALANCE_INQUIRY` to perform a balance inquiry and verify the remaining balance on a gift card.

Balance Inquiry transactions are authorized online.

 
**Properties of a gift card balance inquiry transaction**

| Item | Description | 
| --- | --- | 
| Operation name displayed on a terminal | Balance Inquiry | 
| Operation name displayed on a receipt | BALANCE INQUIRY | 
| Merchant is requested to supply the following data | Password, Clerk/Server. | 
| Cardholder is requested to supply the following data | Card | 
| ISO transaction message | 1100 | 
| Can the operation be autoreversed? | No | 
| Does the operation use data supplied by the cardholder? | Yes | 
| Merchant copy of the receipt? | No | 
| Cardholder copy of the receipt? | Yes | 
| Is the receipt stored as “last receipt”? | Yes | 
| Can the receipt have a signature line? | No | 

**Request fields**

 
**Request fields for balance inquiry**

| Field | Description | Presence | 
| --- | --- | --- | 
| operation | Contains the value Transaction | Mandatory | 
| type | Defines the transaction type of the gift card request. Must contain GC_BALANCE_INQUIRY | Mandatory | 
| reference | A POS-generated reference number. If you do not provide a value, Payment Terminal Application generates this value internally. Maximum of 12 alphanumeric characters. | Optional | 
| printReceipt | Applies to receipts printed by the payment terminal device or an attached printer. If you do not send this field, Payment Terminal Application does not print a receipt. Value: - 0 = do not print receipt (default) - 1 = print receipt (if supported) | Optional | 

Refer to the following example of a gift card balance inquiry request.

```json
{
  "operation": "Transaction",
  "type": "GC_BALANCE_INQUIRY"
}
```

Refer to the following example of a gift card balance inquiry response.

```json
{
  "account": "603571*********5942",
  "approval": "approved",
  "authCode": "000000",
  "balance": "2500",
  "batchJulianDay": "120",
  "batchNumber": "1",
  "cardholderReceipt": "\n              Merchant Name\n\n\nRRN: 120105848737\nThu,Apr 30,2026         10:58:48\n\n         BALANCE INQUIRY\n\n            APPROVED\n\n       ***************5942\nGIFT CARD                 Swiped\n\nAMOUNT                     $0.00\nSUBTOTAL                   $0.00\n            ____________________\nTOTAL                      $0.00\n\nRemaining Balance:        $25.00\n\nTransaction ID:\n                1200000012000001\nBatch#:                  120-001\nApproval Code:            000000\n\n\n      *** Customer copy ***\n\n",
  "currencyCode": "USD",
  "dateTime": "04-30-2026 10:58:48",
  "demoMode": "no",
  "entryMode": "Swiped",
  "merchantID": "",
  "merchantReceipt": "\n              Merchant Name\n\n\nRRN: 120105848737\nThu,Apr 30,2026         10:58:48\n\n         BALANCE INQUIRY\n\n            APPROVED\n\n       ***************5942\nGIFT CARD                 Swiped\n\nAMOUNT                     $0.00\nSUBTOTAL                   $0.00\n            ____________________\nTOTAL                      $0.00\n\nTransaction ID:\n                1200000012000001\nBatch#:                  120-001\nApproval Code:            000000\n\n\n\nX  ______________________________\n\n      *** Merchant copy ***\n\n",
  "operation": "Transaction",
  "processorLine1": "Merchant Name",
  "reference": "120105848737",
  "responseCode": "00",
  "result": "0",
  "safState": "-1",
  "safSubmissionState": "0",
  "shift": "0",
  "terminalID": "008",
  "traceNumber": "00023061",
  "transactionID": "1200000012000001",
  "transactionType": "GIFT CARD BALANCE INQUIRY",
  "type": "GC_BALANCE_INQUIRY"
}
```

### Force Redemption

Use type `GC_FORCE_REDEMPTION` to capture a gift card redemption transaction that has been authorized over the phone.

Force redemption transactions are authorized online and cannot be canceled.

 
**Properties of a gift card force redemption transaction**

| Item | Description | 
| --- | --- | 
| Operation name displayed on a terminal | Force Redemption | 
| Operation name displayed on a receipt | FORCE REDEMPTION | 
| Merchant is requested to supply the following data | Password, Invoice Number, Table Number, Clerk/Server, Gift card transaction reference, authorization code. | 
| Cardholder is requested to supply the following data | Card. | 
| ISO transaction message | 1200 | 
| Can the operation be autoreversed? | Yes | 
| Does the operation use data supplied by the cardholder? | Yes | 
| Merchant copy of the receipt? | Yes | 
| Cardholder copy of the receipt? | Yes | 
| Is the receipt stored as “last receipt”? | Yes | 
| Can the receipt have a signature line? | No | 

**Request fields**

 
**Request fields for force redemption**

| Field | Description | Presence | 
| --- | --- | --- | 
| operation | Contains the value Transaction | Mandatory | 
| type | Defines the transaction type of the gift card request. Must contain GC_FORCE_REDEMPTION | Mandatory | 
| requestedAmount | The numeric amount for your request. No other characters are permitted. The amount value contains two implied decimal places. For example, the value 50000 represents $500.00 and the value 500 represents $5.00. | Mandatory | 
| reference | A POS-generated reference number. If you do not provide a value, Payment Terminal Application generates this value internally. Maximum of 12 alphanumeric characters. | Optional | 
| invoice | The invoice number associated with the transaction. Maximum of 6 numeric characters. | Optional | 
| customer | The customer number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| ticket | The ticket number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| purchase | The purchase number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| order | The order number associated to the transaction. Maximum of 9 alphanumeric characters. | Optional | 
| originalAuthCode | Send the authorization code from the authorization. This field is alphanumeric. | Mandatory | 
| duplicateCheck | If you send a value of 1, Payment Terminal Application checks the last performed transaction for a matching card number and amount. If the previous transaction matches, Payment Terminal Application returns as error. Value: - 0 = ignore duplicates - 1 = check duplicates | Optional | 
| printReceipt | Applies to receipts printed by the payment terminal device or an attached printer. If you do not send this field, Payment Terminal Application does not print a receipt. Value: - 0 = do not print receipt (default) - 1 = print receipt (if supported) | Optional | 
| paymentType | Provides information on the payment method used to support a gift card transaction. Value: - 0 = cash - 1 = credit card - 2 = debit card - 3 = complimentary | Optional | 

### Force Issuance

Use type `GC_FORCE_ISSUANCE` to perform a gift card issuance transaction that has been authorized over the phone.

Force issuance transactions are authorized online and cannot be canceled.

 
**Properties of a gift card force issuance transaction**

| Item | Description | 
| --- | --- | 
| Operation name displayed on a terminal | Force Issuance | 
| Operation name displayed on a receipt | FORCE ISSUANCE | 
| Merchant is requested to supply the following data | Password, Clerk/Server, Gift card transaction reference, authorization code. | 
| Cardholder is requested to supply the following data | Card | 
| ISO transaction message | 1200 | 
| Can the operation be autoreversed? | Yes | 
| Does the operation use data supplied by the cardholder? | Yes | 
| Merchant copy of the receipt? | Yes | 
| Cardholder copy of the receipt? | Yes | 
| Is the receipt stored as “last receipt”? | Yes | 
| Can the receipt have a signature line? | No | 

**Request fields**

 
**Request fields for force issuance**

| Field | Description | Presence | 
| --- | --- | --- | 
| operation | Contains the value Transaction | Mandatory | 
| type | Defines the transaction type of the gift card request. Must contain GC_FORCE_ISSUANCE | Mandatory | 
| requestedAmount | The numeric amount for your request. No other characters are permitted. The amount value contains two implied decimal places. For example, the value 50000 represents $500.00 and the value 500 represents $5.00. | Mandatory | 
| reference | A POS-generated reference number. If you do not provide a value, Payment Terminal Application generates this value internally. Maximum of 12 alphanumeric characters. | Optional | 
| invoice | The invoice number associated with the transaction. Maximum of 6 numeric characters. | Optional | 
| customer | The customer number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| ticket | The ticket number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| purchase | The purchase number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| order | The order number associated to the transaction. Maximum of 9 alphanumeric characters. | Optional | 
| originalAuthCode | Send the authorization code from the authorization. This field is alphanumeric. | Mandatory | 
| duplicateCheck | If you send a value of 1, Payment Terminal Application checks the last performed transaction for a matching card number and amount. If the previous transaction matches, Payment Terminal Application returns as error. Value: - 0 = ignore duplicates - 1 = check duplicates | Optional | 
| printReceipt | Applies to receipts printed by the payment terminal device or an attached printer. If you do not send this field, Payment Terminal Application does not print a receipt. Value: - 0 = do not print receipt (default) - 1 = print receipt (if supported) | Optional | 
| giftReference | Additional reference number on gift card transactions. When present, giftReference is included in host messages and printed on receipts. Maximum of 15 alphanumeric characters. | Optional | 
| paymentType | Provides information on the payment method used to support a gift card transaction. Value: - 0 = cash - 1 = credit card - 2 = debit card - 3 = complimentary | Optional | 

### Force Activation

Use type `GC_FORCE_ACTIVATION` to activate a new gift card that has been authorized over the phone.

Force activation transactions are authorized online and cannot be canceled.

 
**Properties of a gift card force activation transaction**

| Item | Description | 
| --- | --- | 
| Operation name displayed on a terminal | Force Activation | 
| Operation name displayed on a receipt | FORCE ACTIVATION | 
| Merchant is requested to supply the following data | Password, Clerk/Server, Gift card transaction reference, authorization code. | 
| Cardholder is requested to supply the following data | Card | 
| ISO transaction message | 1200 | 
| Can the operation be autoreversed? | Yes | 
| Does the operation use data supplied by the cardholder? | Yes | 
| Merchant copy of the receipt? | Yes | 
| Cardholder copy of the receipt? | Yes | 
| Is the receipt stored as “last receipt”? | Yes | 
| Can the receipt have a signature line? | No | 

**Request fields**

 
**Request fields for force activation**

| Field | Description | Presence | 
| --- | --- | --- | 
| operation | Contains the value Transaction | Mandatory | 
| type | Defines the transaction type of the gift card request. Must contain GC_FORCE_ACTIVATION | Mandatory | 
| requestedAmount | The numeric amount for your request. No other characters are permitted. The amount value contains two implied decimal places. For example, the value 50000 represents $500.00 and the value 500 represents $5.00. | Mandatory | 
| reference | A POS-generated reference number. If you do not provide a value, Payment Terminal Application generates this value internally. Maximum of 12 alphanumeric characters. | Optional | 
| invoice | The invoice number associated with the transaction. Maximum of 6 numeric characters. | Optional | 
| customer | The customer number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| ticket | The ticket number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| purchase | The purchase number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| order | The order number associated to the transaction. Maximum of 9 alphanumeric characters. | Optional | 
| originalAuthCode | Send the authorization code from the authorization. This field is alphanumeric. | Mandatory | 
| duplicateCheck | If you send a value of 1, Payment Terminal Application checks the last performed transaction for a matching card number and amount. If the previous transaction matches, Payment Terminal Application returns as error. Value: - 0 = ignore duplicates - 1 = check duplicates | Optional | 
| printReceipt | Applies to receipts printed by the payment terminal device or an attached printer. If you do not send this field, Payment Terminal Application does not print a receipt. Value: - 0 = do not print receipt (default) - 1 = print receipt (if supported) | Optional | 
| giftReference | Additional reference number on gift card transactions. When present, giftReference is included in host messages and printed on receipts. Maximum of 15 alphanumeric characters. | Optional | 
| paymentType | Provides information on the payment method used to support a gift card transaction. Value: - 0 = cash - 1 = credit card - 2 = debit card - 3 = complimentary | Optional | 

### Deactivation

Use type `GC_DEACTIVATION` to deactivate a gift card and cash out the remaining balance.

Deactivation transactions are authorized online.

 
**Properties of a gift card deactivation transaction**

| Item | Description | 
| --- | --- | 
| Operation name displayed on a terminal | Deactivation | 
| Operation name displayed on a receipt | DEACTIVATION | 
| Merchant is requested to supply the following data | Password, Clerk/Server, Gift card transaction reference. | 
| Cardholder is requested to supply the following data | Card | 
| ISO transaction message | 1200 | 
| Can the operation be autoreversed? | Yes | 
| Does the operation use data supplied by the cardholder? | Yes | 
| Merchant copy of the receipt? | Yes | 
| Cardholder copy of the receipt? | Yes | 
| Is the receipt stored as “last receipt”? | Yes | 
| Can the receipt have a signature line? | No | 

**Request fields**

 
**Request fields for deactivation**

| Field | Description | Presence | 
| --- | --- | --- | 
| operation | Contains the value Transaction | Mandatory | 
| type | Defines the transaction type of the gift card request. Must contain GC_DEACTIVATION | Mandatory | 
| reference | A POS-generated reference number. If you do not provide a value, Payment Terminal Application generates this value internally. Maximum of 12 alphanumeric characters. | Optional | 
| invoice | The invoice number associated with the transaction. Maximum of 6 numeric characters. | Optional | 
| customer | The customer number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| ticket | The ticket number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| purchase | The purchase number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| order | The order number associated to the transaction. Maximum of 9 alphanumeric characters. | Optional | 
| printReceipt | Applies to receipts printed by the payment terminal device or an attached printer. If you do not send this field, Payment Terminal Application does not print a receipt. Value: - 0 = do not print receipt (default) - 1 = print receipt (if supported) | Optional | 
| paymentType | Provides information on the payment method used to support a gift card transaction. Value: - 0 = cash - 1 = credit card - 2 = debit card - 3 = complimentary | Optional | 

Refer to the following example of a gift card deactivation request.

```json
{
  "operation": "Transaction",
  "type": "GC_DEACTIVATION"
}
```

Refer to the following example of a gift card deactivation response.

```json
{
  "account": "603571*********5942",
  "approval": "approved",
  "authCode": "993050",
  "balance": "0",
  "batchJulianDay": "120",
  "batchNumber": "1",
  "cardholderReceipt": "\n              Merchant Name\n\n\nRRN: 120110030409\nThu,Apr 30,2026         11:00:30\n\n          DEACTIVATION\n\n            APPROVED\n\n       ***************5942\nGIFT CARD                 Swiped\n\nAMOUNT                     $0.00\nSUBTOTAL                  $25.00\n            ____________________\nTOTAL                     $25.00\n\nRemaining Balance:         $0.00\n\nTransaction ID:\n                1200000011000005\nBatch#:                  120-001\nApproval Code:            993050\n\n\n      *** Customer copy ***\n\n",
  "cashOutAmount": "0",
  "currencyCode": "USD",
  "cvm": "NO CVM",
  "dateTime": "04-30-2026 11:00:30",
  "demoMode": "no",
  "entryMode": "Swiped",
  "expDate": "4912",
  "merchantID": "",
  "merchantReceipt": "\n              Merchant Name\n\n\nRRN: 120110030409\nThu,Apr 30,2026         11:00:30\n\n          DEACTIVATION\n\n            APPROVED\n\n       ***************5942\nGIFT CARD                 Swiped\n\nAMOUNT                     $0.00\nSUBTOTAL                  $25.00\n            ____________________\nTOTAL                     $25.00\n\nTransaction ID:\n                1200000011000005\nBatch#:                  120-001\nApproval Code:            993050\n\n\n\nX  ______________________________\n\n      *** Merchant copy ***\n\n",
  "operation": "Transaction",
  "processorLine1": "Merchant Name",
  "reference": "120110030409",
  "responseCode": "00",
  "result": "0",
  "safState": "-1",
  "safSubmissionState": "0",
  "shift": "0",
  "signatureRequired": "yes",
  "terminalID": "008",
  "totalAmount": "2500",
  "traceNumber": "00023062",
  "transactionID": "1200000011000005",
  "transactionType": "GIFT CARD DEACTIVATION",
  "type": "GC_DEACTIVATION",
  "uniqueTransactionId": "700000014312008177756123000000"
}
```

### Reactivation

Use type `GC_REACTIVATION` to reactivate a gift card that has been deactivated.

Reactivation transactions are authorized online.

 
**Properties of a gift card reactivation transaction**

| Item | Description | 
| --- | --- | 
| Operation name displayed on a terminal | Reactivation | 
| Operation name displayed on a receipt | REACTIVATION | 
| Merchant is requested to supply the following data | Password, Clerk/Server, Gift card transaction reference. | 
| Cardholder is requested to supply the following data | Card | 
| ISO transaction message | 1200 | 
| Can the operation be autoreversed? | Yes | 
| Does the operation use data supplied by the cardholder? | Yes | 
| Merchant copy of the receipt? | Yes | 
| Cardholder copy of the receipt? | Yes | 
| Is the receipt stored as “last receipt”? | Yes | 
| Can the receipt have a signature line? | No | 

**Request fields**

 
**Request fields for reactivation**

| Field | Description | Presence | 
| --- | --- | --- | 
| operation | Contains the value Transaction | Mandatory | 
| type | Defines the transaction type of the gift card request. Must contain GC_REACTIVATION | Mandatory | 
| requestedAmount | The numeric amount for your request. No other characters are permitted. The amount value contains two implied decimal places. For example, the value 50000 represents $500.00 and the value 500 represents $5.00. | Mandatory | 
| reference | A POS-generated reference number. If you do not provide a value, Payment Terminal Application generates this value internally. Maximum of 12 alphanumeric characters. | Optional | 
| invoice | The invoice number associated with the transaction. Maximum of 6 numeric characters. | Optional | 
| customer | The customer number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| ticket | The ticket number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| purchase | The purchase number associated with the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| order | The order number associated to the transaction. Maximum of 9 alphanumeric characters. | Optional | 
| duplicateCheck | If you send a value of 1, Payment Terminal Application checks the last performed transaction for a matching card number and amount. If the previous transaction matches, Payment Terminal Application returns as error. Value: - 0 = ignore duplicates - 1 = check duplicates | Optional | 
| printReceipt | Applies to receipts printed by the payment terminal device or an attached printer. If you do not send this field, Payment Terminal Application does not print a receipt. Value: - 0 = do not print receipt (default) - 1 = print receipt (if supported) | Optional | 
| giftReference | Additional reference number on gift card transactions. When present, giftReference is included in host messages and printed on receipts. Maximum of 15 alphanumeric characters. | Optional | 
| paymentType | Provides information on the payment method used to support a gift card transaction. Value: - 0 = cash - 1 = credit card - 2 = debit card - 3 = complimentary | Optional | 

Refer to the following example of a gift card reactivation request.

```json
{
  "operation": "Transaction",
  "type": "GC_REACTIVATION",
  "requestedAmount": "1000"
}
```

Refer to the following example of a gift card reactivation response.

```json
{
  "account": "603571*********5942",
  "approval": "approved",
  "authCode": "993051",
  "balance": "1000",
  "batchJulianDay": "120",
  "batchNumber": "1",
  "cardholderReceipt": "\n              Merchant Name\n\n\nRRN: 120110141890\nThu,Apr 30,2026         11:01:41\n\n          REACTIVATION\n\n            APPROVED\n\n       ***************5942\nGIFT CARD                 Swiped\n\nAMOUNT                    $10.00\nSUBTOTAL                  $10.00\n            ____________________\nTOTAL                     $10.00\n\nRemaining Balance:        $10.00\n\nTransaction ID:\n                1200000011000006\nBatch#:                  120-001\nApproval Code:            993051\n\n\n      *** Customer copy ***\n\n",
  "currencyCode": "USD",
  "dateTime": "04-30-2026 11:01:41",
  "demoMode": "no",
  "entryMode": "Swiped",
  "expDate": "4912",
  "merchantID": "",
  "merchantReceipt": "\n              Merchant Name\n\n\nRRN: 120110141890\nThu,Apr 30,2026         11:01:41\n\n          REACTIVATION\n\n            APPROVED\n\n       ***************5942\nGIFT CARD                 Swiped\n\nAMOUNT                    $10.00\nSUBTOTAL                  $10.00\n            ____________________\nTOTAL                     $10.00\n\nTransaction ID:\n                1200000011000006\nBatch#:                  120-001\nApproval Code:            993051\n\n\n\nX  ______________________________\n\n      *** Merchant copy ***\n\n",
  "operation": "Transaction",
  "processorLine1": "Merchant Name",
  "reference": "120110141890",
  "requestedAmount": "1000",
  "responseCode": "00",
  "result": "0",
  "safState": "-1",
  "safSubmissionState": "0",
  "shift": "0",
  "signatureRequired": "yes",
  "terminalID": "008",
  "totalAmount": "1000",
  "traceNumber": "00023063",
  "transactionID": "1200000011000006",
  "transactionType": "GIFT CARD REACTIVATION",
  "type": "GC_REACTIVATION",
  "uniqueTransactionId": "700000014312008177756130100000"
}
```

## Gift card transaction response

### Response fields

When unspecified, the presence of a field applies to all gift card transaction types.

 
**Gift card response fields**

| Field | Description | Presence | 
| --- | --- | --- | 
| processorLine1 |  | Conditional | 
| headerLine1 |  | Present | 
| headerLine2 |  | Present | 
| headerLine3 |  | Present | 
| headerLine4 |  | Present | 
| headerLine5 |  | Present | 
| headerLine6 |  | Present | 
| processorLine2 |  | Conditional | 
| terminalID | Terminal ID value configured for your merchant account. | Present | 
| reference | Echo of the POS-generated reference number in the transaction request or, if you do not send a value, the reference number generated by Payment Terminal Application. Maximum of 12 alphanumeric characters. | Present | 
| merchantID | Merchant ID value for your merchant account. Configure the value of merchantID with the parameter BMERCID. | Present | 
| storeID | Store identification. | Present | 
| dateTime | Print the local date and time of the transaction on the receipt. The dateTime value has a custom format of [MM]-[DD]-[YYYY] [hh]:[mm]:[ss]. For example: 12-31-2024 13:59:59 | Present | 
| invoice | Echo of the invoice number in the request. Maximum of 6 numeric characters. | Optional | 
| customer | The customer number associated to the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| ticket | The ticket number associated to the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| purchase | The purchase number associated to the transaction. Maximum of 8 alphanumeric characters. | Optional | 
| operation | Echo of the operation value Transaction | Present | 
| transactionType | The transaction type in printable form. Value: - GIFT CARD REDEMPTION - GIFT CARD ISSUANCE - GIFT CARD ACTIVATION - GIFT CARD BALANCE INQUIRY - GIFT CARD ADD TIP - GIFT CARD DEACTIVATION - GIFT CARD REACTIVATION | Present | 
| account | The account number masked according to PCI and card brand requirements. | Present | 
| cardholderLanguage | The cardholder preferred language according to ISO 639. This field is an alphanumeric 2 character. Example: “en” for English language. | Optional for: - Redemption - Balance Inquiry | 
| entryMode | Indicates the interface used to capture the card data. Value: - Manual - Swiped - Chip_Swiped - Chip - Contactless - COF | Present | 
| requestedAmount | Echo of the amount of the transaction in the request. | Present for: - Redemption - Issuance - Activation - Reactivation | 
| tipAmount | The tip amount as entered during the transaction. This amount field has the same format as requestedAmount. | Optional for: - Redemption | 
| totalAmount | The sum of all the amounts in the transaction. This amount field has the same format as requestedAmount. | Present for: - Redemption - Issuance - Activation - Reactivation | 
| dueAmount | If the transaction is partially authorized, dueAmount contains the difference between the totalAmount and the amount approved by the issuer. | Optional for: - Redemption | 
| cashOutAmount | Contains the cash out amount returned by the payment host. This amount field has the same format as requestedAmount. | Optional for: - Redemption | 
| giftReference | Echo of giftReference from your request. | Optional for: - Redemption - Issuance - Activation - Reactivation | 
| paymentType | Echo of paymentType from your request. | Optional for: - Redemption - Issuance - Activation - Deactivation - Reactivation | 
| Cvd2Result | Indicates the verification result of the CVD2 value on a manually entered gift card. | Optional | 
| currency | Contains the currency code expressed according to ISO 4217. Example “USD”. | Present | 
| balance | Contains the account balance provided by the issuer (if available). This amount field has the same format as requestedAmount. | Optional | 
| transactionID | Transaction ID number. | Optional | 
| batchNumber | Indicates the current batch number. The number is locally initialized with 0 and is updated by our payment host responses. | Present | 
| batchJulianDay | Indicates the Julian day associated to the batch as informed by the payment host. | Present | 
| traceNumber | Contains the trace number returned by the host for EBT and debit transactions. | Optional | 
| result | The result code from Payment Terminal Application. Refer to the table of [result codes](/docs/commerce/in-store-payments/capabilities/payment-terminal-application/card-transactions#result-codes) for defined values. | Present | 
| approval | Whether the transaction is approved or declined. For errors and cancellations, this field contains the value declined. Use result, responseCode, or hostMessage to determine specific information about the cause of a decline. | Present | 
| errorMessage | The display message from the host containing the description of the transaction decline. Applies to declined transactions. | Optional | 
| hostError | The payment host numeric code for the decline. Only applies to declined transactions. Approved transactions contain 00000. | Optional | 
| authCode | The authorization approval code returned from our payment host. authCode applies to approved transactions and is optional. | Optional | 
| responseCode | The response code returned from our payment host. Only present when provided by our payment host. | Optional | 
| cvm | Indicates the cardholder verification method. Present on approved transactions. Value: - NO CVM - Signature - PIN Verified - PIN and Signature | Present for: - Redemption - Issuance - Activation - Deactivation - Reactivation | 
| signatureRequired | Indicates if a signature is required. Present on approved transactions. Only present if the signature is required and not electronically captured at the payment terminal device. Value: - yes - no | Present for: - Redemption - Issuance - Activation - Deactivation - Reactivation | 
| footerLine1 | Payment card transactions and gift card transactions use different footer lines. Refer to [Receipt Parameters](/docs/commerce/in-store-payments/capabilities/payment-terminal-application/configuration-parameters#receipt-parameters) for additional information. | Present | 
| footerLine2 | Payment card transactions and gift card transactions use different footer lines. Refer to [Receipt Parameters](/docs/commerce/in-store-payments/capabilities/payment-terminal-application/configuration-parameters#receipt-parameters) for additional information. | Present | 
| footerLine3 | Payment card transactions and gift card transactions use different footer lines. Refer to [Receipt Parameters](/docs/commerce/in-store-payments/capabilities/payment-terminal-application/configuration-parameters#receipt-parameters) for additional information. | Present | 
| demoMode | Indicates if the Payment Terminal Application is running in demo mode. Value: - yes - no | Present |