Create a house account transaction

curl --request POST \
  --url https://api.vori.com/v1/house-accounts/{id}/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "199.99",
  "idempotency_key": "<string>",
  "description": "<string>",
  "employee_id": "<string>",
  "metadata": {
    "order_source": "shopify",
    "fulfillment_id": "88213"
  },
  "order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "store_id": "<string>"
}
'

import requests

url = "https://api.vori.com/v1/house-accounts/{id}/transactions"

payload = {
    "amount": "199.99",
    "idempotency_key": "<string>",
    "description": "<string>",
    "employee_id": "<string>",
    "metadata": {
        "order_source": "shopify",
        "fulfillment_id": "88213"
    },
    "order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "store_id": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: '199.99',
    idempotency_key: '<string>',
    description: '<string>',
    employee_id: '<string>',
    metadata: {order_source: 'shopify', fulfillment_id: '88213'},
    order_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    store_id: '<string>'
  })
};

fetch('https://api.vori.com/v1/house-accounts/{id}/transactions', 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/house-accounts/{id}/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => '199.99',
    'idempotency_key' => '<string>',
    'description' => '<string>',
    'employee_id' => '<string>',
    'metadata' => [
        'order_source' => 'shopify',
        'fulfillment_id' => '88213'
    ],
    'order_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'store_id' => '<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/house-accounts/{id}/transactions"

	payload := strings.NewReader("{\n  \"amount\": \"199.99\",\n  \"idempotency_key\": \"<string>\",\n  \"description\": \"<string>\",\n  \"employee_id\": \"<string>\",\n  \"metadata\": {\n    \"order_source\": \"shopify\",\n    \"fulfillment_id\": \"88213\"\n  },\n  \"order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"store_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api.vori.com/v1/house-accounts/{id}/transactions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": \"199.99\",\n  \"idempotency_key\": \"<string>\",\n  \"description\": \"<string>\",\n  \"employee_id\": \"<string>\",\n  \"metadata\": {\n    \"order_source\": \"shopify\",\n    \"fulfillment_id\": \"88213\"\n  },\n  \"order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"store_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.vori.com/v1/house-accounts/{id}/transactions")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": \"199.99\",\n  \"idempotency_key\": \"<string>\",\n  \"description\": \"<string>\",\n  \"employee_id\": \"<string>\",\n  \"metadata\": {\n    \"order_source\": \"shopify\",\n    \"fulfillment_id\": \"88213\"\n  },\n  \"order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"store_id\": \"<string>\"\n}"

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

{
  "id": "<string>",
  "amount": "199.99",
  "api_client_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "effective_at": "2023-11-07T05:31:56Z",
  "employee_id": "<string>",
  "ending_balance": "199.99",
  "idempotency_key": "<string>",
  "metadata": {
    "order_source": "shopify",
    "fulfillment_id": "88213"
  },
  "order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "store_id": "<string>",
  "type": "manual_adjustment",
  "updated_at": "2023-11-07T05:31:56Z",
  "user_id": "<string>"
}

{
  "error_code": "duplicate_idempotency_key"
}

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

POST

house-accounts

{id}

transactions

Create a house account transaction

curl --request POST \
  --url https://api.vori.com/v1/house-accounts/{id}/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "199.99",
  "idempotency_key": "<string>",
  "description": "<string>",
  "employee_id": "<string>",
  "metadata": {
    "order_source": "shopify",
    "fulfillment_id": "88213"
  },
  "order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "store_id": "<string>"
}
'

import requests

url = "https://api.vori.com/v1/house-accounts/{id}/transactions"

payload = {
    "amount": "199.99",
    "idempotency_key": "<string>",
    "description": "<string>",
    "employee_id": "<string>",
    "metadata": {
        "order_source": "shopify",
        "fulfillment_id": "88213"
    },
    "order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "store_id": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: '199.99',
    idempotency_key: '<string>',
    description: '<string>',
    employee_id: '<string>',
    metadata: {order_source: 'shopify', fulfillment_id: '88213'},
    order_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    store_id: '<string>'
  })
};

fetch('https://api.vori.com/v1/house-accounts/{id}/transactions', 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/house-accounts/{id}/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => '199.99',
    'idempotency_key' => '<string>',
    'description' => '<string>',
    'employee_id' => '<string>',
    'metadata' => [
        'order_source' => 'shopify',
        'fulfillment_id' => '88213'
    ],
    'order_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'store_id' => '<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/house-accounts/{id}/transactions"

	payload := strings.NewReader("{\n  \"amount\": \"199.99\",\n  \"idempotency_key\": \"<string>\",\n  \"description\": \"<string>\",\n  \"employee_id\": \"<string>\",\n  \"metadata\": {\n    \"order_source\": \"shopify\",\n    \"fulfillment_id\": \"88213\"\n  },\n  \"order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"store_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", 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.post("https://api.vori.com/v1/house-accounts/{id}/transactions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": \"199.99\",\n  \"idempotency_key\": \"<string>\",\n  \"description\": \"<string>\",\n  \"employee_id\": \"<string>\",\n  \"metadata\": {\n    \"order_source\": \"shopify\",\n    \"fulfillment_id\": \"88213\"\n  },\n  \"order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"store_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.vori.com/v1/house-accounts/{id}/transactions")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": \"199.99\",\n  \"idempotency_key\": \"<string>\",\n  \"description\": \"<string>\",\n  \"employee_id\": \"<string>\",\n  \"metadata\": {\n    \"order_source\": \"shopify\",\n    \"fulfillment_id\": \"88213\"\n  },\n  \"order_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"store_id\": \"<string>\"\n}"

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

{
  "id": "<string>",
  "amount": "199.99",
  "api_client_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "effective_at": "2023-11-07T05:31:56Z",
  "employee_id": "<string>",
  "ending_balance": "199.99",
  "idempotency_key": "<string>",
  "metadata": {
    "order_source": "shopify",
    "fulfillment_id": "88213"
  },
  "order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "store_id": "<string>",
  "type": "manual_adjustment",
  "updated_at": "2023-11-07T05:31:56Z",
  "user_id": "<string>"
}

{
  "error_code": "duplicate_idempotency_key"
}

{
  "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

Records a charge or payment against a house account, either a sale tendered to the account or an adjustment such as a customer settling what they owe.

amount

string<monetary>

required

Money the transaction moved. A negative amount is a charge, which grows what the customer owes; a positive amount is a payment or refund, which reduces it.

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

Example:

"199.99"

idempotency_key

string

required

Key supplied when the transaction was created, unique within the banner. Sending the same key again returns the transaction already recorded rather than charging the account twice.

type

enum<string>

required

What produced the transaction: a sale or refund rung up at a register, or an adjustment made in the back office.

Available options:

manual_adjustment,

order_payment

description

string

Note to write alongside the transaction, such as why the adjustment was made.

employee_id

string

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

Pattern: ^[0-9]+$

metadata

object | null

Your own key/value pairs, stored with the transaction and returned unchanged. Vori never interprets them. Up to 50 keys; key names up to 40 characters of letters, numbers, underscores, and hyphens; values up to 500 characters. Keys beginning with "vori" are reserved. Do not put personal or sensitive information here — these values flow into reporting and data exports.

Show child attributes

Example:

{
  "order_source": "shopify",
  "fulfillment_id": "88213"
}

order_id

string<uuid>

ID of the checkout this settles, from the transactions resource. Required on an order_payment and rejected on a manual_adjustment.

store_id

string

ID of the store the transaction belongs to. Required, except from a register, which posts against the store it is installed in.

Pattern: ^[0-9]+$

Response

House account transaction created successfully.

One charge or payment on a house account. The ledger is append-only, so a transaction is never edited or removed once recorded; a correction is another transaction.

string

required

Unique identifier for the record.

amount

string<monetary>

required

Money the transaction moved. A negative amount is a charge, which grows what the customer owes; a positive amount is a payment or refund, which reduces it.

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

Example:

"199.99"

api_client_id

string | null

required

ID of the API credential that recorded the transaction. Null when a person did.

created_at

string<date-time>

required

When the record was created.

description

string | null

required

Note written alongside the transaction, such as why an adjustment was made.

effective_at

string<date-time>

required

When the transaction took effect. A sale carries the time it was completed at the register, which can be earlier than when it reached the ledger.

employee_id

string | null

required

ID of the employee who took the transaction at a register, or null when it was made in the back office.

Pattern: ^[0-9]+$

ending_balance

string<monetary>

required

The account balance after this transaction. A negative balance is what the customer owes the store. A positive balance is credit the customer can spend.

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

Example:

"199.99"

idempotency_key

string

required

Key supplied when the transaction was created, unique within the banner. Sending the same key again returns the transaction already recorded rather than charging the account twice.

metadata

object | null

required

Your own key/value pairs, exactly as supplied when the transaction was recorded.

Show child attributes

Example:

{
  "order_source": "shopify",
  "fulfillment_id": "88213"
}

order_id

string<uuid> | null

required

ID of the checkout this settled, from the transactions resource. Null when the ledger entry is not tied to a checkout.

store_id

string

required

ID of the store where the transaction took place.

Pattern: ^[0-9]+$

type

enum<string>

required

What produced the transaction: a sale or refund rung up at a register, or an adjustment made in the back office.

Available options:

manual_adjustment,

order_payment

updated_at

string<date-time>

required

When the record was last changed.

user_id

string | null

required

ID of the back-office user who made the adjustment. Null for a transaction taken at a register.

Pattern: ^[0-9]+$