Update a gift card

curl --request PATCH \
  --url https://api.vori.com/v1/gift-cards/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "idempotency_key": "<string>",
  "employee_id": "<string>",
  "magstripe_account_numbers": [
    "<string>"
  ],
  "owner_phone_number": "<string>",
  "physical_barcodes": [
    "<string>"
  ]
}
'

import requests

url = "https://api.vori.com/v1/gift-cards/{id}"

payload = {
    "idempotency_key": "<string>",
    "employee_id": "<string>",
    "magstripe_account_numbers": ["<string>"],
    "owner_phone_number": "<string>",
    "physical_barcodes": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    idempotency_key: '<string>',
    employee_id: '<string>',
    magstripe_account_numbers: ['<string>'],
    owner_phone_number: '<string>',
    physical_barcodes: ['<string>']
  })
};

fetch('https://api.vori.com/v1/gift-cards/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.vori.com/v1/gift-cards/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'idempotency_key' => '<string>',
    'employee_id' => '<string>',
    'magstripe_account_numbers' => [
        '<string>'
    ],
    'owner_phone_number' => '<string>',
    'physical_barcodes' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vori.com/v1/gift-cards/{id}"

	payload := strings.NewReader("{\n  \"idempotency_key\": \"<string>\",\n  \"employee_id\": \"<string>\",\n  \"magstripe_account_numbers\": [\n    \"<string>\"\n  ],\n  \"owner_phone_number\": \"<string>\",\n  \"physical_barcodes\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.vori.com/v1/gift-cards/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"idempotency_key\": \"<string>\",\n  \"employee_id\": \"<string>\",\n  \"magstripe_account_numbers\": [\n    \"<string>\"\n  ],\n  \"owner_phone_number\": \"<string>\",\n  \"physical_barcodes\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.vori.com/v1/gift-cards/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"idempotency_key\": \"<string>\",\n  \"employee_id\": \"<string>\",\n  \"magstripe_account_numbers\": [\n    \"<string>\"\n  ],\n  \"owner_phone_number\": \"<string>\",\n  \"physical_barcodes\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "balance": "199.99",
  "barcodes": [
    "<string>"
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "deactivated_at": "2023-11-07T05:31:56Z",
  "deactivated_by_api_client_id": "<string>",
  "deactivated_by_employee_id": "<string>",
  "deactivated_by_user_id": "<string>",
  "deactivation_reason": "<string>",
  "last_order_at": "2023-11-07T05:31:56Z",
  "magstripe_account_numbers": [
    "<string>"
  ],
  "owner_id": "<string>",
  "printed_account_numbers": [
    "<string>"
  ],
  "purchaser_id": "<string>",
  "shopper_facing_id": "<string>",
  "status": "active",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error_code": "gift_card_deactivated"
}

{
  "error_code": "insufficient_permissions",
  "error_details": {
    "action": "*",
    "resource": "*"
  }
}

PATCH

gift-cards

{id}

Update a gift card

curl --request PATCH \
  --url https://api.vori.com/v1/gift-cards/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "idempotency_key": "<string>",
  "employee_id": "<string>",
  "magstripe_account_numbers": [
    "<string>"
  ],
  "owner_phone_number": "<string>",
  "physical_barcodes": [
    "<string>"
  ]
}
'

import requests

url = "https://api.vori.com/v1/gift-cards/{id}"

payload = {
    "idempotency_key": "<string>",
    "employee_id": "<string>",
    "magstripe_account_numbers": ["<string>"],
    "owner_phone_number": "<string>",
    "physical_barcodes": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    idempotency_key: '<string>',
    employee_id: '<string>',
    magstripe_account_numbers: ['<string>'],
    owner_phone_number: '<string>',
    physical_barcodes: ['<string>']
  })
};

fetch('https://api.vori.com/v1/gift-cards/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.vori.com/v1/gift-cards/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'idempotency_key' => '<string>',
    'employee_id' => '<string>',
    'magstripe_account_numbers' => [
        '<string>'
    ],
    'owner_phone_number' => '<string>',
    'physical_barcodes' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vori.com/v1/gift-cards/{id}"

	payload := strings.NewReader("{\n  \"idempotency_key\": \"<string>\",\n  \"employee_id\": \"<string>\",\n  \"magstripe_account_numbers\": [\n    \"<string>\"\n  ],\n  \"owner_phone_number\": \"<string>\",\n  \"physical_barcodes\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.vori.com/v1/gift-cards/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"idempotency_key\": \"<string>\",\n  \"employee_id\": \"<string>\",\n  \"magstripe_account_numbers\": [\n    \"<string>\"\n  ],\n  \"owner_phone_number\": \"<string>\",\n  \"physical_barcodes\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.vori.com/v1/gift-cards/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"idempotency_key\": \"<string>\",\n  \"employee_id\": \"<string>\",\n  \"magstripe_account_numbers\": [\n    \"<string>\"\n  ],\n  \"owner_phone_number\": \"<string>\",\n  \"physical_barcodes\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "balance": "199.99",
  "barcodes": [
    "<string>"
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "deactivated_at": "2023-11-07T05:31:56Z",
  "deactivated_by_api_client_id": "<string>",
  "deactivated_by_employee_id": "<string>",
  "deactivated_by_user_id": "<string>",
  "deactivation_reason": "<string>",
  "last_order_at": "2023-11-07T05:31:56Z",
  "magstripe_account_numbers": [
    "<string>"
  ],
  "owner_id": "<string>",
  "printed_account_numbers": [
    "<string>"
  ],
  "purchaser_id": "<string>",
  "shopper_facing_id": "<string>",
  "status": "active",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error_code": "gift_card_deactivated"
}

{
  "error_code": "insufficient_permissions",
  "error_details": {
    "action": "*",
    "resource": "*"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string<uuid>

required

Body

application/json

idempotency_key

string

required

Idempotency key to avoid duplicate transactions.

employee_id

string

ID of the employee responsible. Only a register sends one, and it is required there; a back-office session records the signed-in user, and an API credential records itself.

magstripe_account_numbers

string[]

The desired end state of which magnetic-stripe account numbers (physical gift cards) are associated with the specified gift card. If this field is not provided, no account numbers will be modified.

owner_phone_number

string<phone>

Phone number of the Shopper who will own this gift card. This shopper will receive messages about this and future transactions.

Pattern: ^\+[1-9]\d{1,14}$

physical_barcodes

string[]

The desired end state of which barcodes (physical gift cards) are associated with the specified gift card. If this field is not provided, no barcodes will be modified.

Response

A prepaid balance a shopper spends at the register. It can be digital, tied to a shopper, or backed by one or more physical cards. A gift card belongs to the banner rather than to any one store, and can be sold, redeemed, or reloaded at any of its registers.

string

required

Unique identifier for the record.

balance

string<monetary>

required

Current balance on the gift card.

Pattern: ^-?[0-9]+(\.[0-9]+)?$

Example:

"199.99"

barcodes

string[]

required

Barcodes on the physical cards backing this gift card, across the card and any cards merged into it.

created_at

string<date-time>

required

When the record was created.

deactivated_at

string<date-time> | null

required

When the gift card was deactivated, or null when it is active.

deactivated_by_api_client_id

string | null

required

ID of the API credential that deactivated the gift card, or null when it is active or was deactivated by a person.

deactivated_by_employee_id

string | null

required

ID of the employee who deactivated the gift card, or null when it is active or was deactivated by another actor.

deactivated_by_user_id

string | null

required

ID of the back-office user who deactivated the gift card, or null when it is active or was deactivated by another actor.

deactivation_reason

string | null

required

Reason recorded when the gift card was deactivated, or null when it is active.

last_order_at

string<date-time> | null

required

When the gift card was last used in a sale or refund, or null when it has not been used yet.

magstripe_account_numbers

string[]

required

Account numbers encoded on the magnetic stripe of the physical cards.

owner_id

string | null

required

ID of the shopper who owns the gift card, or null when it has no owner.

printed_account_numbers

string[]

required

Account numbers printed on the physical cards.

purchaser_id

string | null

required

ID of the shopper who purchased the gift card, or null when unknown.

shopper_facing_id

string

required

Short human-readable ID for the gift card, shown to shoppers on receipts and messages.

status

enum<string>

required

Whether the gift card is active and can be used, or has been deactivated.

Available options:

active,

deactivated

updated_at

string<date-time>

required

When the record was last changed.