Skip to main content
POST
/
finops
/
v1
/
transactions
/
{transaction_id}
/
approve
Approve a transaction
curl --request POST \
  --url https://api.sandbox.tesouro.com/finops/v1/transactions/{transaction_id}/approve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-finops-version: <x-finops-version>' \
  --header 'x-organization-id: <x-organization-id>' \
  --data '
{
  "approval_metadata": {
    "approval_policy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "approval_policy_name": "<string>",
    "approval_policy_process_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "approval_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "approval_source": "<string>",
    "entity_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": 123,
  "currency": "USD",
  "entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "has_validation_errors": true,
  "merchant_amount": 123,
  "merchant_location": "<string>",
  "merchant_name": "<string>",
  "payment_method": {
    "details": {
      "brand": "<string>",
      "expiry_month": 6,
      "expiry_year": 123,
      "last4": "<string>"
    }
  },
  "started_at": "2023-11-07T05:31:56Z",
  "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": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Headers

​
x-finops-version
string<date>
required
​
x-organization-id
string<uuid>
required

The ID of the entity that owns the requested resource.

Example:

"9d2b4c8f-2087-4738-ba91-7359683c49a4"

Path Parameters

​
transaction_id
string<uuid>
required

Body

application/json
​
approval_metadata
object

Approval metadata forwarded by the approval-policies connector. Internal use only.

Response

Successful Response

​
id
string<uuid>
required

A unique Monite-generated ID assigned to this transaction.

​
amount
integer
required

The transaction amount in minor units. Positive values for in-flow, negative values for out-flow.

​
currency
enum<string>
required

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"

​
entity_id
string<uuid>
required

ID of the entity that owns this resource.

​
expense_status
enum<string>
required

The current expense approval status of the transaction.

Available options:
new,
approve_in_progress,
approved,
rejected,
canceled
​
has_validation_errors
boolean
required

Whether the transaction has missing required fields per the entity's TransactionValidation config. Always false when no config is set.

​
merchant_amount
integer
required

Original merchant transaction amount in minor units.

​
merchant_currency
enum<string>
required

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
​
merchant_location
string
required

The merchant location.

Maximum string length: 128
Example:

"New York, US"

​
merchant_name
string
required

The merchant name.

Maximum string length: 128
Example:

"Acme Inc."

​
payment_method
object
required
​
started_at
string<date-time>
required

Date and time when the transaction was initiated.

​
type
enum<string>
required

The nature of the transaction.

Available options:
capture,
refund,
cash_withdrawal,
fee,
adjustment,
reversal
​
applied_policy_id
string<uuid>

ID of the approval policy applied to this transaction, if any.

​
department_id
string<uuid>

ID of the department associated with this transaction.

​
description
string

A human-readable description of the transaction.

Maximum string length: 255
​
entity_user_id
string<uuid>

ID of the entity user who made the transaction, if applicable.

​
external_id
string

External identifier for idempotency, if provided by the source system.

Maximum string length: 128
​
ledger_account_id
string<uuid>

ID of the ledger account from the Accounting service.

​
location_id
string<uuid>

ID of the location associated with this transaction.

​
no_receipt_reason
string

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.

​
partner_metadata
object

Extensible key-value pairs for storing additional custom information for partner needs.

​
payment_processing_status
enum<string>
default:created

The current processing status of the transaction.

Available options:
created,
processing,
succeeded,
declined,
refunded,
failed
​
receipt_file_url
string

URL of the attached receipt's file. Present when receipt_id is set and the receipt is reachable; null otherwise.

​
receipt_id
string

ID of the related receipt from payables service, if any.

​
reject_reason
string

Optional reason explaining why the transaction was rejected.

​
source_of_data
object

Per-field source tracking. Each field indicates how its value was set: user, generated, or automatched.