The Commission object

Represents a commission charged on a transaction. Commissions are fees collected by ZenPays for processing payments, payouts, or refunds.

Fields

Field	Type	Description
id REQUIRED	string	Unique identifier for the commission record
merchantId REQUIRED	string	ID of the merchant who was charged
transactionId REQUIRED	string	ID of the transaction that generated the commission
amount REQUIRED	number	Commission amount in the smallest currency unit
rate REQUIRED	number	Commission rate applied (as a decimal, e.g., 0.029 for 2.9%)
currency REQUIRED	string	Three-letter ISO currency code
type REQUIRED	'payment'| 'payout'| 'refund'	Type of transaction the commission was charged on
createdAt REQUIRED	string	ISO 8601 timestamp when the commission was charged

Example

{
  "id": "obj_1a2b3c",
  "merchantId": "merchant_1a2b3c",
  "transactionId": "transaction_1a2b3c",
  "amount": 5000,
  "rate": 1,
  "currency": "USD",
  "type": "payment",
  "createdAt": "2026-01-15T09:30:00Z"
}