MOmonta
Wallet Transactions

Patch an existing transaction

Changed on

Note: This has been deprecated and won't do anything. Required scope: transaction:write

patch/api/v1/wallet-transactions/{transactionId}

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/wallet-transactions/{transactionId}
  • Auth
    HTTP bearer

Path parameters

transactionIdinteger required

Request body

partnerExternalIdstring nullable

External Id of this entity, managed by you.

partnerCustomPayloadobject nullable

Custom JSON payload for this entity, managed by you.</br>Note: the expected shape is a flat JSON object with named keys. The payload is limited to 1000 characters.

Example request

{
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  }
}

Response

Transaction updated

idinteger

Id of the transaction

fromAmountnumber double

Amount sent, incl. VAT

fromSubAmountnumber double

Amount sent, excl. VAT

fromVatAmountnumber double

VAT amount sent

fromTypestring nullable

Type of sender: operator, team

fromWalletIdinteger nullable

Id of the wallet where the amount was sent from. Can be null if the transaction did not originate from a wallet.

toAmountnumber double

Amount received, incl. VAT

toSubAmountnumber double

Amount received, excl. VAT

toVatAmountnumber double

VAT amount received

toTypestring nullable

Type of receiver: operator, team

toWalletIdinteger nullable

Id of the wallet where the amount was sent to. Can be null if the transaction did not target a wallet.

exchangeRatenumber double

Exchange rate used for currency conversion

createdAtstring date-time required

Creation date of transaction

updatedAtstring date-time nullable

Update date of transaction

completedAtstring date-time nullable

Completion date of transaction

referenceIdstring nullable

Reference id of this transaction. e.g the charge id

referenceType'TEAM' | 'COMPANY_REFERRAL' | 'USER_REFERRAL' | 'ORDER' | 'SUBSCRIPTION_PURCHASE' | 'CHARGE' | 'BANK_ACCOUNT' | 'WALLET_BANK_ACCOUNT' | 'STRIPE_CHARGE' | 'SUBSCRIPTION' | 'TRANSACTION' | 'PROMO_CODE_USE' | 'TEAM_MEMBER_FEE_PURCHASE' | 'WALLET' | 'PAYTER_PAYMENT_SESSION' | 'ADYEN_PAYMENT' | 'POWER_BANK_PAYOUT' | 'SPLIT_BILLING_SETTLEMENT' | 'OTHER'
group'deposit' | 'withdraw' | 'charge' | 'other' required
kindstring required

Kind of this transaction, ie 'charge-sponsored'.<br/>Note: This is an open field and therefore more kinds will be added moving forward.

vatPercentagenumber double

VAT percentage included in this transaction.

state'complete' | 'pending' | 'failed' | 'reserved' | 'other' required
notestring nullable

A note that has been entered for this transaction.

partnerExternalIdstring nullable

**Note: This has been deprecated and will be null always.**External Id of this entity, managed by you.

partnerCustomPayloadobject nullable

**Note: This has been deprecated and will be null always.**Custom JSON payload for this entity, managed by you.

Example response

{
  "id": 1,
  "fromAmount": 13.77,
  "fromSubAmount": 11.02,
  "fromVatAmount": 2.75,
  "fromCurrency": {
    "identifier": "dkk",
    "name": "Danish krone",
    "decimals": 2
  },
  "fromType": "team",
  "from": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "fromWalletId": 1,
  "toAmount": 13.77,
  "toSubAmount": 11.02,
  "toVatAmount": 2.75,
  "toCurrency": {
    "identifier": "dkk",
    "name": "Danish krone",
    "decimals": 2
  },
  "toType": "operator",
  "to": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "toWalletId": 2,
  "exchangeRate": 1,
  "createdAt": "2022-04-22T09:47:05Z",
  "updatedAt": "2022-04-22T09:47:05Z",
  "completedAt": "2022-04-22T09:47:05Z",
  "referenceId": "referenceId",
  "kind": "charge-sponsored",
  "vatPercentage": 25,
  "note": "Test transaction.",
  "partnerExternalId": "ACME-12345",
  "metadata": {
    "id": 1,
    "kwh": 13.77
  }
}

Changes

  • 0ca400461c52Revision changes
    • breaking

      the request property type changed from array to object

    • breaking

      the response's property type changed from array to object for status

    • info

      added to the response property allOf list for the response status

    • info

      added to the response property allOf list for the response status

    • info

      removed from the response property allOf list for the response status

    • info

      removed from the response property allOf list for the response status

    • info

      removed subschema #2 from the response property allOf list for the response status

    • info

      removed subschema #2 from the response property allOf list for the response status