Autessa Payments
Let agents move real money on your behalf: invoice customers, take payments, issue refunds, and check when your payouts land.
All four types require an Autessa Payments connector (connectorId) whose merchant onboarding is complete — a connector that has not finished onboarding fails with NOT_ONBOARDED. Charges run on your merchant account as the merchant of record: sales tax is calculated from the customer address fields you pass (customerCountry is the minimum; customerTaxId enables B2B reverse-charge handling) and added on top of amountCents, while Autessa's platform fee is taken on the pre-tax base. All amounts are integer cents; currency defaults to usd.
Create Invoice TOOLAUTESSA_PAYMENTS_CREATE_INVOICE
Bills a customer for an invoice amount: tax is computed from the customer address, the total is charged on your merchant account, and the charge is recorded on your ledger as an invoice. Note that this executes as an immediate charge — it does not email the customer a payable invoice link. description defaults to "Invoice" (plus the customer email) when omitted.
The result is {"success": true, "invoiceChargeId": ..., "amountCents": ..., "taxCents": ..., "totalAmountCents": ..., "customerEmail": ...} — keep invoiceChargeId if you may need to refund later.
Example
{
"toolType": "AUTESSA_PAYMENTS_CREATE_INVOICE",
"connectorId": "V1StGXR8Z5",
"customerEmail": "@@{CUSTOMER_EMAIL}",
"amountCents": 25000,
"currency": "usd",
"description": "@@{INVOICE_DESCRIPTION}",
"customerCountry": "US",
"customerState": "@@{CUSTOMER_STATE}",
"customerPostalCode": "@@{CUSTOMER_POSTAL_CODE}",
"customerCity": "@@{CUSTOMER_CITY}",
"customerTaxId": ""
}
connectorId in the tool configuration.Configuration fields
- Name
connectorId- Type
- string (ID)
- Description
- Required string (ID) value. References a connector by ID.
- Name
customerEmail- Type
- string
- Description
- Required string value.
- Name
amountCents- Type
- integer
- Description
- Required integer value.
- Name
currency- Type
- string
- Description
- Required string value.
- Name
description- Type
- string
- Description
- Required string value.
- Name
customerCountry- Type
- string
- Description
- Required string value.
- Name
customerState- Type
- string
- Description
- Required string value.
- Name
customerPostalCode- Type
- string
- Description
- Required string value.
- Name
customerCity- Type
- string
- Description
- Required string value.
- Name
customerTaxId- Type
- string
- Description
- Required string value.
Charge Customer TOOLAUTESSA_PAYMENTS_CHARGE_CUSTOMER
Creates a payment for amountCents plus computed tax on your merchant account, identified to your ledger by customerEmail. amountCents must be a positive integer, and repeated invocations are idempotent per tool invocation, so a retried agent turn cannot double-charge.
The result itemizes the money movement: {"success": true, "chargeId": ..., "amountCents": ..., "taxCents": ..., "taxJurisdiction": ..., "totalAmountCents": ..., "platformFeeCents": ...}.
Example
{
"toolType": "AUTESSA_PAYMENTS_CHARGE_CUSTOMER",
"connectorId": "V1StGXR8Z5",
"amountCents": 4999,
"currency": "usd",
"description": "Monthly service fee",
"customerEmail": "@@{CUSTOMER_EMAIL}",
"customerCountry": "US",
"customerState": "WA",
"customerPostalCode": "98101",
"customerCity": "Seattle",
"customerTaxId": ""
}
connectorId in the tool configuration.Configuration fields
- Name
connectorId- Type
- string (ID)
- Description
- Required string (ID) value. References a connector by ID.
- Name
amountCents- Type
- integer
- Description
- Required integer value.
- Name
currency- Type
- string
- Description
- Required string value.
- Name
description- Type
- string
- Description
- Required string value.
- Name
customerEmail- Type
- string
- Description
- Required string value.
- Name
customerCountry- Type
- string
- Description
- Required string value.
- Name
customerState- Type
- string
- Description
- Required string value.
- Name
customerPostalCode- Type
- string
- Description
- Required string value.
- Name
customerCity- Type
- string
- Description
- Required string value.
- Name
customerTaxId- Type
- string
- Description
- Required string value.
Refund TOOLAUTESSA_PAYMENTS_REFUND
Refunds a previous charge by its chargeId (the chargeId or invoiceChargeId returned by the charge tools). Leave amountCents null for a full refund, or set it for a partial refund — partial refunds prorate the base amount and tax, and any tax recorded on the original charge is reversed proportionally. The refund is written to your ledger as a negative entry against the original charge.
The result is {"success": true, "chargeId": ..., "refundedAmountCents": ...}.
Example
{
"toolType": "AUTESSA_PAYMENTS_REFUND",
"connectorId": "V1StGXR8Z5",
"chargeId": "@@{CHARGE_ID}",
"amountCents": null
}
connectorId in the tool configuration.Configuration fields
- Name
connectorId- Type
- string (ID)
- Description
- Required string (ID) value. References a connector by ID.
- Name
chargeId- Type
- string
- Description
- Required string value.
- Name
amountCents- Type
- integer
- Description
- null = full refund
Get Payout Status TOOLAUTESSA_PAYMENTS_GET_PAYOUT_STATUS
Checks the status of your merchant account's most recent payout — useful for agents that answer "has my money arrived?" questions. It returns a single status string, not a payout history.
The result is {"success": true, "payoutStatus": ...} where payoutStatus is a processor status such as paid, pending, in_transit, failed, or canceled; NONE means no payouts exist yet, and UNKNOWN means the status could not be retrieved.
Example
{
"toolType": "AUTESSA_PAYMENTS_GET_PAYOUT_STATUS",
"connectorId": "V1StGXR8Z5"
}
connectorId in the tool configuration.Configuration fields
- Name
connectorId- Type
- string (ID)
- Description
- Required string (ID) value. References a connector by ID.
Related
- Tool Types overview
- Connectors guide
- Tools guide
- QuickBooks tool types — accounting-side payments and invoicing