marketplace_charge
Create a wallet charge for a GHL sub-account using meter, event, and units. Track transactions by referencing your event ID, with optional pricing and timestamps.
Instructions
Create a new wallet charge
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"appId": "<appId>",
"meterId": "<meterId>",
"eventId": "<eventId>",
"companyId": "<companyId>",
"description": "<description>",
"units": "<units>"
},
"name": "marketplace_charge"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | App ID of the App | |
| price | No | Price per unit to charge | |
| units | Yes | Number of units to charge | |
| userId | No | User ID | |
| eventId | Yes | Event ID / Transaction ID on your server's side. This will help you maintain the reference of the event/transaction on your end that you charged the customer for. | |
| meterId | Yes | Billing Meter ID (you can find this on your app's pricing page) | |
| companyId | Yes | ID of the Agency the Sub-account belongs to | |
| eventTime | No | The timestamp when the event/transaction was performed. If blank, the billing timestamp will be set as the event time. ISO8601 Format. | |
| locationId | No | ID of the Sub-Account to be charged Defaults to GHL_LOCATION_ID when omitted. | |
| description | Yes | Description of the charge |