General

Example terminal-state payment.updated webhook (USDC payout on Ethereum, complete):

Code
 
{
  "id": "f4c8e1a3-9b76-4d2e-a058-3c5f9e1d4b27",
  "type": "payment.updated",
  "created_at": "2025-12-01T09:00:02.502Z",
  "data": {
    "object": {
      "id": "550e8400-e29b-41d4-a716-446655440020",
      "workspace_id": "550e8400-e29b-41d4-a716-446655440001",
      "organization_reference_id": "ref_123",
      "direction": "outbound",
      "funding_account_id": "550e8400-e29b-41d4-a716-446655440010",
      "desired": {
        "from": {
          "account_id": "550e8400-e29b-41d4-a716-446655440011",
          "amount": "1000",
          "currency": "USDC",
          "network": "ETHEREUM"
        },
        "to": {
          "account_id": "550e8400-e29b-41d4-a716-446655440012",
          "amount": null,
          "currency": "USDC",
          "network": "ETHEREUM"
        }
      },
      "estimated": {
        "from": {
          "account_id": "550e8400-e29b-41d4-a716-446655440011",
          "amount": "1000",
          "currency": "USDC",
          "network": "ETHEREUM"
        },
        "to": {
          "account_id": "550e8400-e29b-41d4-a716-446655440012",
          "amount": "1000",
          "currency": "USDC",
          "network": "ETHEREUM"
        }
      },
      "actual": {
        "from": {
          "account_id": "550e8400-e29b-41d4-a716-446655440011",
          "amount": "1000",
          "currency": "USDC",
          "network": "ETHEREUM"
        },
        "to": {
          "account_id": "550e8400-e29b-41d4-a716-446655440012",
          "amount": "1000",
          "currency": "USDC",
          "network": "ETHEREUM"
        }
      },
      "risk_status": "auto_approved",
      "risk_status_reasons": [],
      "risk_reviewed_by": null,
      "risk_reviewed_at": null,
      "balance_status": "reserved",
      "balance_reserved_at": "2025-12-01T09:00:01.000Z",
      "steps": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440100",
          "transfer_id": "550e8400-e29b-41d4-a716-446655440020",
          "step_sequence": 1,
          "step_type": "transfer",
          "estimated": {
            "from": {
              "account_id": "550e8400-e29b-41d4-a716-446655440011",
              "amount": "1000",
              "currency": "USDC",
              "network": "ETHEREUM"
            },
            "to": {
              "account_id": "550e8400-e29b-41d4-a716-446655440012",
              "amount": "1000",
              "currency": "USDC",
              "network": "ETHEREUM"
            }
          },
          "actual": {
            "from": {
              "account_id": "550e8400-e29b-41d4-a716-446655440011",
              "amount": "1000",
              "currency": "USDC",
              "network": "ETHEREUM"
            },
            "to": {
              "account_id": "550e8400-e29b-41d4-a716-446655440012",
              "amount": "1000",
              "currency": "USDC",
              "network": "ETHEREUM"
            }
          },
          "transaction_hash": "0xd65dc6bf6dcc ... e877f7be",
          "fees": [
            {
              "fee_amount": "0.01",
              "fee_currency": "USDC",
              "fee_type": "gas",
              "fee_metadata": {}
            }
          ],
          "provider_key": "circle_mint",
          "status": "completed",
          "status_reasons": [],
          "created_at": "2025-12-01T09:00:00.040Z",
          "updated_at": "2025-12-01T09:00:02.500Z",
          "submitted_at": "2025-12-01T09:00:01.200Z",
          "confirmed_at": "2025-12-01T09:00:01.800Z",
          "completed_at": "2025-12-01T09:00:02.500Z",
          "failed_at": null
        }
      ],
      "created_at": "2025-12-01T09:00:00.000Z",
      "updated_at": "2025-12-01T09:00:02.500Z",
      "expires_at": "2025-12-01T23:59:59.999Z"
    }
  }
}