Submit Transaction Fee for Bag

Submits a per-bag transaction fee on behalf of the authenticated channel. The fee submission is validated against the merchant's payment configuration and persisted at the bag level.

Only APP_PROVIDED is accepted as the source_type for channel submissions.

Submit Transaction Fee for Bag

put

Submits a per-bag transaction fee on behalf of the authenticated channel. The fee submission is forwarded to BillingService, which resolves the bag context, validates ownership against the submitting app, and persists the record. Only source_type APP_PROVIDED is accepted for channel submissions.

Path parameters

bag_idinteger · int64Required

ID of the bag to submit the transaction fee for

Header parameters

X-Violet-TokenstringRequired

API token for authentication

X-Violet-App-SecretstringRequired

Application secret key

X-Violet-App-Idinteger · int32Required

Application ID

Body

application/json

Request body for submitting an app-provided transaction fee for a bag.

transaction_fee_total_amountinteger · int32Optional

Total transaction fee amount in minor units (e.g. cents)

transaction_fee_percentage_amountinteger · int32Optional

Percentage-based component of the transaction fee in minor units (audit)

transaction_fee_fixed_amountinteger · int32Optional

Fixed component of the transaction fee in minor units (audit)

currencystringOptional

Currency code for this fee (e.g. USD)

source_typestring · enumOptional

Source type of this transaction fee

Possible values:

source_providerstringOptional

Provider that supplied this fee (e.g. payment processor name)

source_reference_idstringOptional

External reference ID from the fee source

idempotency_keystringOptional

Unique key to prevent duplicate fee submissions

source_app_idinteger · int32Optional

ID of the application that provided this fee data

Responses

200

Fee submission accepted or duplicate accepted

application/json

objectOptional

400

Validation error (missing fields, invalid source type, etc.)

application/json

403

Bag not owned by the submitting app

application/json

404

Bag not found

application/json

put/bags/{bag_id}/transaction_fee

HTTPcURLJavaScriptPython

PUT /v1/bags/{bag_id}/transaction_fee HTTP/1.1
Host: sandbox-api.violet.io
X-Violet-Token: text
X-Violet-App-Secret: text
X-Violet-App-Id: 1
Content-Type: application/json
Accept: */*
Content-Length: 249

{
  "transaction_fee_total_amount": 1,
  "transaction_fee_percentage_amount": 1,
  "transaction_fee_fixed_amount": 1,
  "currency": "text",
  "source_type": "APP_PROVIDED",
  "source_provider": "text",
  "source_reference_id": "text",
  "idempotency_key": "text",
  "source_app_id": 1
}

{}