Consolidate Gift Cards

Enables a user to transfer the entire balance of a gift card to another gift card.

Note: After the balance transfer, the system removes the source gift card from the user's timeline and changes its status to 'closed' for the owner. Additionally, access is revoked for all users with whom the gift card was shared. Currently, this is applicable only to Givex and Heartland gift card providers.

Path Parameters

uuid
Type: string
required

Unique ID of the destination gift card to which the entire balance will be transferred

Headers

x-pch-digest
Type: string
required

The signature for the API call
Content-Type
Type: string
required

Set this header to application/json.
Accept-Language
Type: string

Preferred language
User-Agent
Type: string
required

Used to identify the software, device, and application initiating the request, providing information about the client to the server. For details, see User Agent.
Authorization
Type: string
required

Used to authorize the request with access_token. It should be supplied as Bearer ACCESS_TOKEN_GOES_HERE.

Body

application/json

access_token
Type: string
required

Access token of the user
client
Type: string
required

OAuth client ID provided by the business
source_card
Type: string
required

UUID of the source gift card from which the entire balance will be transferred

Responses

application/json
application/json

patch/api2/mobile/gift_cards/{uuid}/consolidate

curl 'https://SERVER_NAME_GOES_HERE.punchh.com/api2/mobile/gift_cards/{uuid}/consolidate' \
  --request PATCH \
  --header 'x-pch-digest: {{$$.env.signature}}' \
  --header 'Content-Type: application/json' \
  --header 'Accept-Language: en' \
  --header 'User-Agent: AppName/AppVersion/BuildNumber (OS; Model; MANUFACTURER; MODEL; OS Version)' \
  --header 'Authorization: Bearer ACCESS_TOKEN_GOES_HERE' \
  --data '{
  "client": "CLIENT_GOES_HERE",
  "access_token": "ACCESS_TOKEN_GOES_HERE",
  "source_card": "CARD_GOES_HERE"
}'

Show Schema

{
  "source_card": {},
  "destination_card": {}
}