The WalletAdjustment object

Represents a manual adjustment to a wallet balance. Adjustments are typically made by administrators to correct errors or apply promotional credits.

Fields

Field	Type	Description
id REQUIRED	string	Unique identifier for the adjustment
merchantId REQUIRED	string	ID of the merchant whose wallet was adjusted
type REQUIRED	'credit'| 'debit'	Type of adjustment
amount REQUIRED	number	Adjustment amount in the smallest currency unit
currency REQUIRED	string	Three-letter ISO currency code
reason REQUIRED	string	Reason for the adjustment
approvedBy OPTIONAL	string	ID of the administrator who approved the adjustment
createdAt REQUIRED	string	ISO 8601 timestamp when the adjustment was made

Example

{
  "id": "obj_1a2b3c",
  "merchantId": "merchant_1a2b3c",
  "type": "credit",
  "amount": 5000,
  "currency": "USD",
  "reason": "string",
  "approvedBy": "string",
  "createdAt": "2026-01-15T09:30:00Z"
}