Reload Gift Card

Reloads a gift card with a specified amount, adding funds to the existing balance. This is typically used when a customer wants to add more money to their gift card for future use, allowing the merchant to process the reload and update the card balance accordingly.

Headers

x-applicationSource
Type: string
required

A custom HTTP header that accepts a free-form string value. It is used to identify the application making the API request. For example, if Punchh invokes the API, the value could be "punchh".
X-LocationId
Type: string
required

The unique location identifier for the store or business location processing the transaction.
Content-Type
Type: string
required

The media type of the request body. Must be set to application/json.
Authorization
Type: string
required

Bearer token for API authorization. Send in the format: Bearer ACCESS_TOKEN_GOES_HERE.

Body·

application/json

Request details to reload the gift card.

amount
Type: number Format: double
required

The amount for which the gift card is reloaded. Pattern: ^\d+(\.\d{0,2})?$ (up to 2 decimal places).
cardNumber
Type: string
max length:
30Pattern: ^\d+$
required

Gift Card number which will be reloaded
referenceNumber
Type: string
min length:
1
max length:
40Pattern: ^[0-9]+$
required

A unique reference number for the transaction.
transactionDateTimeUTC
Type: string Format: date-time
required

The transaction date and time in UTC format.
channel
Type: string · enum
values
- None
- POS
- Kiosk
giftCardPassCode
Type: string | null

The passcode associated with the Gift Card.
paymentSource
Type: string · enum
values
- ScanToPay
- Online
- None
transactionDateTimeLocal
Type: string | null Format: date-time

The transaction date and time in local format.

Responses

application/json
application/json
application/json
application/json
application/json
application/json
application/json

post/giftcard/v1/reload

curl https://SERVER_NAME_GOES_HERE.partech.com/giftcard/v1/reload \
  --request POST \
  --header 'x-applicationSource: ' \
  --header 'X-LocationId: ' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer ACCESS_TOKEN_GOES_HERE' \
  --data '{
  "cardNumber": "GIFT_CARD_NUMBER_GOES_HERE",
  "giftCardPassCode": "GIFT_CARD_PASSCODE_GOES_HERE",
  "amount": 100,
  "referenceNumber": "258",
  "transactionDateTimeUTC": "2026-03-06T11:28:29.7340276Z",
  "transactionDateTimeLocal": "2026-03-06T11:28:29.734",
  "paymentSource": "ScanToPay",
  "channel": null
}'

Show Schema

{
  "parPayTransactionId": "TRANSACTION_ID_GOES_HERE",
  "statusMessage": "APPROVAL",
  "balanceAmount": "600",
  "amount": "100",
  "transactionDateTimeUTC": "2026-03-06T11:28:29.7339913Z",
  "status": "Success"
}

Balance of gift card is reloaded successfully