Payments

WALTA's payment system enables autonomous agents to process secure payments between customers and vendors. This page covers how to initiate payments, handle transactions, and manage payment metadata.

The payment model

The payment model contains all the information about transactions processed through the WALTA ecosystem, including payment details, transaction status, and associated metadata.

Properties

Send Payment

curl -X POST https://api.walta.ai/v1/sendPayment \
  -H "x-api-key: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "prod_123",
    "quantity": 2,
    "metadata": {
      "order_id": "order_456"
    }
  }'

{
  "paymentIntent": {
    "id": "pi_123456789",
    "amount": 200,
    "currency": "usd",
    "status": "succeeded",
    "metadata": {
      "productId": "prod_123",
      "productName": "Premium Service",
      "productDescription": "Premium service package",
      "productPrice": 100,
      "productQuantity": 2,
      "order_id": "order_456"
    }
  }
}

Best Practices

1. Payment Processing

   • Always validate product availability before initiating payment
   • Handle payment failures gracefully
   • Implement proper error handling
   • Use appropriate metadata for transaction tracking

2. Security

   • Keep your API keys secure
   • Never expose sensitive payment information
   • Validate all input data
   • Use HTTPS for all API calls

3. Transaction Management

   • Track transaction status
   • Maintain proper records
   • Implement reconciliation processes
   • Monitor for failed transactions

4. Error Handling

   • Handle API errors appropriately
   • Implement retry logic for failed payments
   • Log payment failures
   • Provide clear error messages

Common Errors