Update transaction
curl --request PATCH \
--url https://api.sandbox.tesouro.com/finops/v1/transactions/{transaction_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-finops-version: <x-finops-version>' \
--header 'x-organization-id: <x-organization-id>' \
--data '
{
"amount": 123,
"currency": "USD",
"department_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"entity_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "<string>",
"ledger_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"merchant_amount": 123,
"merchant_location": "New York, US",
"merchant_name": "Acme Inc.",
"partner_metadata": {},
"payment_method": {
"details": {
"expiry_month": 6,
"expiry_year": 123,
"last4": 1234
},
"type": "card"
},
"payment_processing_status": "created",
"started_at": "2023-11-07T05:31:56Z"
}
'import requests
url = "https://api.sandbox.tesouro.com/finops/v1/transactions/{transaction_id}"
payload = {
"amount": 123,
"currency": "USD",
"department_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"entity_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "<string>",
"ledger_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"merchant_amount": 123,
"merchant_location": "New York, US",
"merchant_name": "Acme Inc.",
"partner_metadata": {},
"payment_method": {
"details": {
"expiry_month": 6,
"expiry_year": 123,
"last4": 1234
},
"type": "card"
},
"payment_processing_status": "created",
"started_at": "2023-11-07T05:31:56Z"
}
headers = {
"x-finops-version": "<x-finops-version>",
"x-organization-id": "<x-organization-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
'x-finops-version': '<x-finops-version>',
'x-organization-id': '<x-organization-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 123,
currency: 'USD',
department_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
description: '<string>',
entity_user_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
external_id: '<string>',
ledger_account_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
location_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
merchant_amount: 123,
merchant_location: 'New York, US',
merchant_name: 'Acme Inc.',
partner_metadata: {},
payment_method: {details: {expiry_month: 6, expiry_year: 123, last4: 1234}, type: 'card'},
payment_processing_status: 'created',
started_at: '2023-11-07T05:31:56Z'
})
};
fetch('https://api.sandbox.tesouro.com/finops/v1/transactions/{transaction_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.sandbox.tesouro.com/finops/v1/transactions/{transaction_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([
'amount' => 123,
'currency' => 'USD',
'department_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'description' => '<string>',
'entity_user_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'external_id' => '<string>',
'ledger_account_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'location_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'merchant_amount' => 123,
'merchant_location' => 'New York, US',
'merchant_name' => 'Acme Inc.',
'partner_metadata' => [
],
'payment_method' => [
'details' => [
'expiry_month' => 6,
'expiry_year' => 123,
'last4' => 1234
],
'type' => 'card'
],
'payment_processing_status' => 'created',
'started_at' => '2023-11-07T05:31:56Z'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-finops-version: <x-finops-version>",
"x-organization-id: <x-organization-id>"
],
]);
$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.sandbox.tesouro.com/finops/v1/transactions/{transaction_id}"
payload := strings.NewReader("{\n \"amount\": 123,\n \"currency\": \"USD\",\n \"department_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"entity_user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"external_id\": \"<string>\",\n \"ledger_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"location_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"merchant_amount\": 123,\n \"merchant_location\": \"New York, US\",\n \"merchant_name\": \"Acme Inc.\",\n \"partner_metadata\": {},\n \"payment_method\": {\n \"details\": {\n \"expiry_month\": 6,\n \"expiry_year\": 123,\n \"last4\": 1234\n },\n \"type\": \"card\"\n },\n \"payment_processing_status\": \"created\",\n \"started_at\": \"2023-11-07T05:31:56Z\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-finops-version", "<x-finops-version>")
req.Header.Add("x-organization-id", "<x-organization-id>")
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.sandbox.tesouro.com/finops/v1/transactions/{transaction_id}")
.header("x-finops-version", "<x-finops-version>")
.header("x-organization-id", "<x-organization-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 123,\n \"currency\": \"USD\",\n \"department_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"entity_user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"external_id\": \"<string>\",\n \"ledger_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"location_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"merchant_amount\": 123,\n \"merchant_location\": \"New York, US\",\n \"merchant_name\": \"Acme Inc.\",\n \"partner_metadata\": {},\n \"payment_method\": {\n \"details\": {\n \"expiry_month\": 6,\n \"expiry_year\": 123,\n \"last4\": 1234\n },\n \"type\": \"card\"\n },\n \"payment_processing_status\": \"created\",\n \"started_at\": \"2023-11-07T05:31:56Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.tesouro.com/finops/v1/transactions/{transaction_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-finops-version"] = '<x-finops-version>'
request["x-organization-id"] = '<x-organization-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 123,\n \"currency\": \"USD\",\n \"department_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"entity_user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"external_id\": \"<string>\",\n \"ledger_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"location_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"merchant_amount\": 123,\n \"merchant_location\": \"New York, US\",\n \"merchant_name\": \"Acme Inc.\",\n \"partner_metadata\": {},\n \"payment_method\": {\n \"details\": {\n \"expiry_month\": 6,\n \"expiry_year\": 123,\n \"last4\": 1234\n },\n \"type\": \"card\"\n },\n \"payment_processing_status\": \"created\",\n \"started_at\": \"2023-11-07T05:31:56Z\"\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"amount": 123,
"currency": "USD",
"entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"expense_status": "new",
"has_validation_errors": true,
"merchant_amount": 123,
"merchant_currency": "AED",
"merchant_location": "New York, US",
"merchant_name": "Acme Inc.",
"payment_method": {
"details": {
"brand": "visa",
"card_type": "credit",
"expiry_month": 6,
"expiry_year": 123,
"last4": 1234
},
"type": "card"
},
"started_at": "<string>",
"type": "capture",
"applied_policy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"department_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"entity_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "<string>",
"ledger_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"no_receipt_reason": "<string>",
"partner_metadata": {},
"payment_processing_status": "created",
"receipt_file_url": "<string>",
"receipt_id": "<string>",
"reject_reason": "<string>",
"source_of_data": {
"department_id": "user",
"description": "user",
"ledger_account_id": "user",
"location_id": "user",
"receipt_id": "user"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"ctx": {},
"input": "<unknown>"
}
]
}{
"error": {
"message": "<string>"
}
}Transactions
Update transaction
PATCH
/
transactions
/
{transaction_id}
Update transaction
curl --request PATCH \
--url https://api.sandbox.tesouro.com/finops/v1/transactions/{transaction_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-finops-version: <x-finops-version>' \
--header 'x-organization-id: <x-organization-id>' \
--data '
{
"amount": 123,
"currency": "USD",
"department_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"entity_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "<string>",
"ledger_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"merchant_amount": 123,
"merchant_location": "New York, US",
"merchant_name": "Acme Inc.",
"partner_metadata": {},
"payment_method": {
"details": {
"expiry_month": 6,
"expiry_year": 123,
"last4": 1234
},
"type": "card"
},
"payment_processing_status": "created",
"started_at": "2023-11-07T05:31:56Z"
}
'import requests
url = "https://api.sandbox.tesouro.com/finops/v1/transactions/{transaction_id}"
payload = {
"amount": 123,
"currency": "USD",
"department_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"entity_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "<string>",
"ledger_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"merchant_amount": 123,
"merchant_location": "New York, US",
"merchant_name": "Acme Inc.",
"partner_metadata": {},
"payment_method": {
"details": {
"expiry_month": 6,
"expiry_year": 123,
"last4": 1234
},
"type": "card"
},
"payment_processing_status": "created",
"started_at": "2023-11-07T05:31:56Z"
}
headers = {
"x-finops-version": "<x-finops-version>",
"x-organization-id": "<x-organization-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
'x-finops-version': '<x-finops-version>',
'x-organization-id': '<x-organization-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 123,
currency: 'USD',
department_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
description: '<string>',
entity_user_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
external_id: '<string>',
ledger_account_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
location_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
merchant_amount: 123,
merchant_location: 'New York, US',
merchant_name: 'Acme Inc.',
partner_metadata: {},
payment_method: {details: {expiry_month: 6, expiry_year: 123, last4: 1234}, type: 'card'},
payment_processing_status: 'created',
started_at: '2023-11-07T05:31:56Z'
})
};
fetch('https://api.sandbox.tesouro.com/finops/v1/transactions/{transaction_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.sandbox.tesouro.com/finops/v1/transactions/{transaction_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([
'amount' => 123,
'currency' => 'USD',
'department_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'description' => '<string>',
'entity_user_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'external_id' => '<string>',
'ledger_account_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'location_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'merchant_amount' => 123,
'merchant_location' => 'New York, US',
'merchant_name' => 'Acme Inc.',
'partner_metadata' => [
],
'payment_method' => [
'details' => [
'expiry_month' => 6,
'expiry_year' => 123,
'last4' => 1234
],
'type' => 'card'
],
'payment_processing_status' => 'created',
'started_at' => '2023-11-07T05:31:56Z'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"x-finops-version: <x-finops-version>",
"x-organization-id: <x-organization-id>"
],
]);
$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.sandbox.tesouro.com/finops/v1/transactions/{transaction_id}"
payload := strings.NewReader("{\n \"amount\": 123,\n \"currency\": \"USD\",\n \"department_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"entity_user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"external_id\": \"<string>\",\n \"ledger_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"location_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"merchant_amount\": 123,\n \"merchant_location\": \"New York, US\",\n \"merchant_name\": \"Acme Inc.\",\n \"partner_metadata\": {},\n \"payment_method\": {\n \"details\": {\n \"expiry_month\": 6,\n \"expiry_year\": 123,\n \"last4\": 1234\n },\n \"type\": \"card\"\n },\n \"payment_processing_status\": \"created\",\n \"started_at\": \"2023-11-07T05:31:56Z\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-finops-version", "<x-finops-version>")
req.Header.Add("x-organization-id", "<x-organization-id>")
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.sandbox.tesouro.com/finops/v1/transactions/{transaction_id}")
.header("x-finops-version", "<x-finops-version>")
.header("x-organization-id", "<x-organization-id>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": 123,\n \"currency\": \"USD\",\n \"department_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"entity_user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"external_id\": \"<string>\",\n \"ledger_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"location_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"merchant_amount\": 123,\n \"merchant_location\": \"New York, US\",\n \"merchant_name\": \"Acme Inc.\",\n \"partner_metadata\": {},\n \"payment_method\": {\n \"details\": {\n \"expiry_month\": 6,\n \"expiry_year\": 123,\n \"last4\": 1234\n },\n \"type\": \"card\"\n },\n \"payment_processing_status\": \"created\",\n \"started_at\": \"2023-11-07T05:31:56Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.tesouro.com/finops/v1/transactions/{transaction_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-finops-version"] = '<x-finops-version>'
request["x-organization-id"] = '<x-organization-id>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"amount\": 123,\n \"currency\": \"USD\",\n \"department_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"entity_user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"external_id\": \"<string>\",\n \"ledger_account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"location_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"merchant_amount\": 123,\n \"merchant_location\": \"New York, US\",\n \"merchant_name\": \"Acme Inc.\",\n \"partner_metadata\": {},\n \"payment_method\": {\n \"details\": {\n \"expiry_month\": 6,\n \"expiry_year\": 123,\n \"last4\": 1234\n },\n \"type\": \"card\"\n },\n \"payment_processing_status\": \"created\",\n \"started_at\": \"2023-11-07T05:31:56Z\"\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"amount": 123,
"currency": "USD",
"entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"expense_status": "new",
"has_validation_errors": true,
"merchant_amount": 123,
"merchant_currency": "AED",
"merchant_location": "New York, US",
"merchant_name": "Acme Inc.",
"payment_method": {
"details": {
"brand": "visa",
"card_type": "credit",
"expiry_month": 6,
"expiry_year": 123,
"last4": 1234
},
"type": "card"
},
"started_at": "<string>",
"type": "capture",
"applied_policy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"department_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"entity_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"external_id": "<string>",
"ledger_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"no_receipt_reason": "<string>",
"partner_metadata": {},
"payment_processing_status": "created",
"receipt_file_url": "<string>",
"receipt_id": "<string>",
"reject_reason": "<string>",
"source_of_data": {
"department_id": "user",
"description": "user",
"ledger_account_id": "user",
"location_id": "user",
"receipt_id": "user"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"error": {
"message": "<string>"
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"ctx": {},
"input": "<unknown>"
}
]
}{
"error": {
"message": "<string>"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The ID of the entity that owns the requested resource.
Example:
"9d2b4c8f-2087-4738-ba91-7359683c49a4"
Path Parameters
Body
application/json
The transaction amount in minor units. Positive values for in-flow, negative values for out-flow.
ISO currency code.
Available options:
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, IQD, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLE, SOS, SRD, SSP, SVC, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW Example:
"USD"
ID of the department associated with this transaction.
A human-readable description of the transaction.
Maximum string length:
255ID of the entity user who owns the transaction. Must be an active or invited user of the organization. A caller limited to their own transactions may only name themselves or one of their direct reportees.
External identifier for idempotency, if provided by the source system.
Maximum string length:
128ID of the ledger account from the Accounting service.
ID of the location associated with this transaction.
Original merchant transaction amount in minor units.
ISO currency code for the merchant_amount.
Available options:
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, IQD, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLE, SOS, SRD, SSP, SVC, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW The merchant location.
Maximum string length:
128Example:
"New York, US"
The merchant name.
Maximum string length:
128Example:
"Acme Inc."
Extensible key-value pairs for storing additional custom information for partner needs.
Show child attributes
Show child attributes
- Option 1
- Option 2
Show child attributes
Show child attributes
The current processing status of the transaction.
Available options:
created, processing, succeeded, declined, refunded, failed Date and time when the transaction was initiated.
The nature of the transaction.
Available options:
capture, refund, cash_withdrawal, fee, adjustment, reversal Response
Successful Response
A unique Monite-generated ID assigned to this transaction.
The transaction amount in minor units. Positive values for in-flow, negative values for out-flow.
ISO currency code.
Available options:
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, IQD, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLE, SOS, SRD, SSP, SVC, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW Example:
"USD"
ID of the entity that owns this resource.
The current expense approval status of the transaction.
Available options:
new, approve_in_progress, approved, rejected, canceled, deleted Whether the transaction has missing required fields per the entity's TransactionValidation config. Always false when no config is set.
Original merchant transaction amount in minor units.
ISO currency code for the merchant_amount.
Available options:
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, IQD, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLE, SOS, SRD, SSP, SVC, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW The merchant location.
Maximum string length:
128Example:
"New York, US"
The merchant name.
Maximum string length:
128Example:
"Acme Inc."
- Option 1
- Option 2
Show child attributes
Show child attributes
Date and time when the transaction was initiated.
The nature of the transaction.
Available options:
capture, refund, cash_withdrawal, fee, adjustment, reversal ID of the approval policy applied to this transaction, if any.
ID of the department associated with this transaction.
A human-readable description of the transaction.
Maximum string length:
255ID of the entity user who owns the transaction. Must be an active or invited user of the organization. When omitted and the request is made as an entity user, the caller becomes the owner; an explicit null leaves the transaction unowned. A caller limited to their own transactions may only name themselves or one of their direct reportees, and becomes the owner when the field is null.
External identifier for idempotency, if provided by the source system.
Maximum string length:
128ID of the ledger account from the Accounting service.
ID of the location associated with this transaction.
Reason provided by the employee when submitting without a receipt (e.g. receipt was lost or unavailable). Set via the submit endpoint; bypasses the receipt_id required-field check.
Extensible key-value pairs for storing additional custom information for partner needs.
Show child attributes
Show child attributes
The current processing status of the transaction.
Available options:
created, processing, succeeded, declined, refunded, failed URL of the attached receipt's file. Present when receipt_id is set and the receipt is reachable; null otherwise.
ID of the related receipt from payables service, if any.
Optional reason explaining why the transaction was rejected.
Per-field source tracking. Each field indicates how its value was set: user, generated, or automatched.
Show child attributes
Show child attributes
Was this page helpful?