Submit Payment Proof

{
  "name": "submit_payment_proof",
  "description": "Submits a settlement proof after the payer completes X402 payment on the source chain. No authentication required.",
  "input_schema": {
    "type": "object",
    "properties": {
      "intent_id": {
        "type": "string",
        "description": "The intent ID returned from createIntent operation"
      },
      "settle_proof": {
        "type": "string",
        "description": "The settlement proof from X402 payment. This is the signed proof from the user's wallet after completing the payment on the payer chain."
      }
    },
    "required": ["intent_id", "settle_proof"]
  },
  "output_schema": {
    "type": "object",
    "properties": {
      "intent_id": {
        "type": "string",
        "description": "The intent ID"
      },
      "status": {
        "type": "string",
        "enum": ["PENDING", "SOURCE_SETTLED", "TARGET_SETTLING", "TARGET_SETTLED", "VERIFICATION_FAILED", "PARTIAL_SETTLEMENT"],
        "description": "Current status of the intent after proof submission"
      },
      "message": {
        "type": "string",
        "description": "Status message"
      }
    },
    "required": ["intent_id", "status"]
  }
}

{
  "intent_id": "int_abc123xyz",
  "status": "PENDING",
  "message": "Proof submitted successfully"
}

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

// Use PublicPayClient for client-side operations (no secrets required)
const client = new PublicPayClient({
  baseUrl: 'https://api-pay.agent.tech',
});

// After user signs X402 payment with their wallet
const settleProof = await getUserSignedProof(); // Get proof from wallet

// Submit the proof
const result = await client.submitProof(intentId, settleProof);

console.log(`Intent ID: ${result.intentId}`);
console.log(`Status: ${result.status}`);
console.log(`Message: ${result.message}`);

package main

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

func main() {
    // Public mode - no authentication required
    client, err := pay.NewClient("https://api-pay.agent.tech")
    if err != nil {
        log.Fatal(err)
    }

    ctx := context.Background()

    // Get settle proof from user's wallet (X402 payment)
    settleProof := getUserSignedProof()

    // Submit the proof
    proof, err := client.SubmitProof(ctx, intentID, settleProof)
    if err != nil {
        log.Fatal(err)
    }

    log.Printf("Intent ID: %s", proof.IntentID)
    log.Printf("Status: %s", proof.Status)
    log.Printf("Message: %s", proof.Message)
}

// Step 1: Create intent
const intent = await client.createIntent({
  email: "merchant@example.com",
  amount: "100.50",
  payerChain: "base",
  targetChain: "ethereum",
});

// Step 2: User signs X402 payment (wallet interaction)
const settleProof = await signX402Payment(intent.intentId);

// Step 3: Submit proof
const result = await client.submitProof(intent.intentId, settleProof);

// Step 4: Poll for status (see query-intent-status.md)
// ...