Skip to main content

​
What is a Transaction?

Every time an agent completes a checkout, Ovra creates a transaction record. Transactions are immutable and form the financial audit trail.

​
Transaction Fields

FieldDescription
idUnique ID (e.g. tx_xxx)
agentIdWhich agent made the payment
intentIdThe intent that authorized it
amountEurosAmount charged
merchantMerchant name
statuscompleted, pending, failed
typecheckout, cdp_checkout, refund
memoOptional note (added later)
createdAtTimestamp

​
List Transactions

curl https://api.getovra.com/transactions \
  -H "Authorization: Bearer sk_test_..."

​
Add a Memo

curl -X PATCH https://api.getovra.com/transactions/tx_xxx \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"memo": "Office supplies for Q2"}'

​
Ledger

Every transaction creates debit entries in Ovra’s ledger:
  • Card balance is reduced by the transaction amount
  • Wallet balance is reduced accordingly
  • Both entries are linked to the transaction for reconciliation
In sandbox mode, balances are not deducted (virtual money).