Expense managementTransactions

Create a transaction

Authentication

AuthorizationBearer

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

Headers

x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.
amountintegerRequired

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

currencyenumRequired
ISO currency code.
merchant_amountintegerRequired
Original merchant transaction amount in minor units.
merchant_currencyenumRequired

ISO currency code for the merchant_amount.

merchant_locationstringRequired<=128 characters
The merchant location.
merchant_namestringRequired<=128 characters
The merchant name.
payment_methodobjectRequired
typeenumRequired
The nature of the transaction.
descriptionstringOptional<=255 characters

A human-readable description of the transaction.

entity_user_idstringOptionalformat: "uuid"
ID of the entity user who made the transaction, if applicable.
external_idstringOptional<=128 characters
External identifier for idempotency, if provided by the source system.
partner_metadatamap from strings to stringsOptional

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

started_atdatetimeOptional
Date and time when the transaction was initiated.
statusenumOptional
The current processing status of the transaction.

Response

Successful Response
idstringformat: "uuid"

A unique Monite-generated ID assigned to this transaction.

amountinteger

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

currencyenum
ISO currency code.
entity_idstringformat: "uuid"
ID of the entity that owns this resource.
merchant_amountinteger
Original merchant transaction amount in minor units.
merchant_currencyenum

ISO currency code for the merchant_amount.

merchant_locationstring<=128 characters
The merchant location.
merchant_namestring<=128 characters
The merchant name.
payment_methodobject
started_atdatetime
Date and time when the transaction was initiated.
typeenum
The nature of the transaction.
descriptionstring<=255 characters

A human-readable description of the transaction.

entity_user_idstringformat: "uuid"
ID of the entity user who made the transaction, if applicable.
external_idstring<=128 characters
External identifier for idempotency, if provided by the source system.
partner_metadatamap from strings to strings

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

receipt_idstring

ID of the related receipt from payables service, if any. This field is read-only and system-managed.

statusenum
The current processing status of the transaction.

Errors

400
Post Transactions Request Bad Request Error
401
Post Transactions Request Unauthorized Error
403
Post Transactions Request Forbidden Error
422
Post Transactions Request Unprocessable Entity Error
429
Post Transactions Request Too Many Requests Error