Create Payment Intent

{
  "name": "create_payment_intent",
  "description": "Creates a new payment intent. The payer chain and target (settlement) chain can differ. Returns an intent ID for subsequent operations.",
  "input_schema": {
    "type": "object",
    "properties": {
      "email": {
        "type": "string",
        "description": "Recipient email address. Required if recipient is not provided."
      },
      "recipient": {
        "type": "string",
        "description": "Recipient wallet address. Required if email is not provided. Format is validated against target_chain (EVM address for EVM targets, Solana public key for target_chain='solana')."
      },
      "amount": {
        "type": "string",
        "description": "ExactOut: the merchant receives exactly this USD amount (e.g. '100.50'). Mutually exclusive with to_amount. Minimum: 0.02, Maximum: 1,000,000. Up to 6 decimal places.",
        "pattern": "^[0-9]+(\\.[0-9]{1,6})?$"
      },
      "to_amount": {
        "type": "string",
        "description": "ExactIn: the payer sends exactly this USD amount and the merchant receives the remainder after fees. Mutually exclusive with amount. Same range and precision as amount.",
        "pattern": "^[0-9]+(\\.[0-9]{1,6})?$"
      },
      "payer_chain": {
        "type": "string",
        "description": "Source chain identifier. See Supported Chains for the full list."
      },
      "target_chain": {
        "type": "string",
        "description": "Settlement chain identifier. Optional; defaults to 'base'. Must be a chain listed by GET /api/chains."
      },
      "payer_asset": {
        "type": "string",
        "enum": ["usdc", "usdt", "usdt0"],
        "description": "Token the payer signs against on payer_chain. Optional; defaults to 'usdc'. The (chain, asset) pair must be supported."
      },
      "target_asset": {
        "type": "string",
        "enum": ["usdc", "usdt", "usdt0"],
        "description": "Token the merchant receives on target_chain. Optional; defaults to 'usdc'."
      },
      "payer_address": {
        "type": "string",
        "description": "Optional payer wallet address, screened advisorily against sanctions lists at create time. Leave empty to skip."
      }
    },
    "required": ["payer_chain"],
    "allOf": [
      { "oneOf": [ { "required": ["email"] }, { "required": ["recipient"] } ] },
      { "oneOf": [ { "required": ["amount"] }, { "required": ["to_amount"] } ] }
    ]
  },
  "output_schema": {
    "type": "object",
    "properties": {
      "intent_id": {
        "type": "string",
        "description": "Unique identifier for the created intent"
      },
      "status": {
        "type": "string",
        "enum": ["AWAITING_PAYMENT"],
        "description": "Initial status of the intent"
      },
      "expires_at": {
        "type": "string",
        "format": "date-time",
        "description": "ISO 8601 timestamp when the intent expires (10 minutes after creation)"
      }
    },
    "required": ["intent_id", "status"]
  }
}

{
  "intent_id": "int_abc123xyz",
  "agent_id": "8b2e9c4a-3f7a-4d1b-9e2c-5a6b7c8d9e0f",
  "status": "AWAITING_PAYMENT",
  "payer_chain": "base",
  "target_chain": "ethereum",
  "expires_at": "2024-01-01T12:10:00Z",
  "fee_breakdown": {
    "source_chain": "base",
    "source_chain_fee": "0.001",
    "target_chain": "ethereum",
    "target_chain_fee": "0.85",
    "platform_fee": "1.00",
    "platform_fee_percentage": "1.0",
    "total_fee": "1.851"
  }
}

import { PayClient } from '@cross402/usdc';

const client = new PayClient({
  baseUrl: 'https://api-pay.agent.tech',
  auth: { apiKey: 'your-api-key', secretKey: 'your-secret-key' },
});

// Payer pays on Base; merchant receives on Ethereum.
const intent = await client.createIntent({
  email: "merchant@example.com",
  amount: "100.50",
  payerChain: "base",
  targetChain: "ethereum",
});

console.log(`Intent created: ${intent.intentId}`);
console.log(`Status: ${intent.status}`);

package main

import (
    "context"
    "log"
    "github.com/cross402/usdc-sdk-go"
)

func main() {
    client, err := pay.NewClient(
        "https://api-pay.agent.tech",
        pay.WithBearerAuth(apiKey, secretKey),
    )
    if err != nil {
        log.Fatal(err)
    }

    ctx := context.Background()

    resp, err := client.CreateIntent(ctx, &pay.CreateIntentRequest{
        Email:       "merchant@example.com",
        Amount:      "100.50",
        PayerChain:  "base",
        TargetChain: "ethereum",
    })
    if err != nil {
        log.Fatal(err)
    }

    log.Printf("Intent created: %s", resp.IntentID)
    log.Printf("Status: %s", resp.Status)
}