Skip to main content
POST
Register Payment
Agent Transactions: Create payments between agents with automatic application of approval rules based on the sender’s configuration.

Request Headers

string
required
Your API key for authentication

Request Body

string
required
ID of the agent sending the payment
string
required
ID of the agent receiving the payment
object
required
string
required
Name or description of the payment
object
array
Tags or categories for the payment

Response

string
Unique payment identifier in short ID format
string
Name or description of the payment
string
Type of payment (EXTERNAL or INTERNAL)
string
Current status of the payment (New, Pending, or Confirmed)
string
Timestamp when the payment was created
boolean
Whether this payment requires approval
string
Current approval status (Waiting, Pending, Approved, or Decline)
string
Transaction hash on the blockchain (if processed immediately)

Status Codes

Payment Limits: The payment will fail if it exceeds the sender agent’s transaction or daily limits.
Payment Types: Use “EXTERNAL” for payments to recipients outside your agent network and “INTERNAL” for payments between your own agents.
Approval Flow: Payments requiring approval will need to be approved using the Approve Payment endpoint before they are processed.