@radzor/payment-refund — LLM & AI Component | Radzor Registry

@radzor/payment-refund

Process full and partial refunds via Stripe. Create refunds against payment intents or charges, check refund status, and react to refund lifecycle events.

Paymentv0.1.0typescriptpythonServerstriperefundpaymentchargebackbillingby Radzor

Install

View source on GitHub →

$npx radzor@latest add payment-refund

⚠ Constraints: Requires Stripe secret key (server-side only). Refunds can only be issued for payments less than 180 days old. Partial refunds reduce the original charge amount. Webhook endpoint must be publicly accessible.

Inputs

Name	Type	Default	Description
secretKey*	string	—	Stripe secret API key (sk_live_... or sk_test_...).STRIPE_SECRET_KEY
webhookSecret*	string	—	Stripe webhook signing secret for verifying refund events.STRIPE_WEBHOOK_SECRET

secretKey*string

Stripe secret API key (sk_live_... or sk_test_...).

STRIPE_SECRET_KEY

webhookSecret*string

Stripe webhook signing secret for verifying refund events.

STRIPE_WEBHOOK_SECRET

Outputs

Name	Type	Description
refundResult	RefundResult	Result of a refund operation. .idstring .amountnumber .currencystring .statusstring .paymentIntentIdstring .reasonstring(optional)

refundResultRefundResult

Result of a refund operation.

.idstring

.amountnumber

.currencystring

.statusstring

.paymentIntentIdstring

.reasonstring(optional)

radzor.manifest.json

{
  "llm": {
    "constraints": "Requires Stripe secret key (server-side only). Refunds can only be issued for payments less than 180 days old. Partial refunds reduce the original charge amount. Webhook endpoint must be publicly accessible.",
    "usageExamples": "llm/examples.md",
    "integrationPrompt": "llm/integration.md"
  },
  "name": "@radzor/payment-refund",
  "tags": [
    "stripe",
    "refund",
    "payment",
    "chargeback",
    "billing"
  ],
  "events": [
    {
      "name": "onRefundCompleted",
      "payload": {
        "amount": "number",
        "currency": "string",
        "refundId": "string",
        "paymentIntentId": "string"
      },
      "description": "Fired when a refund is successfully processed."
    },
    {
      "name": "onRefundFailed",
      "payload": {
        "reason": "string",
        "refundId": "string",
        "paymentIntentId": "string"
      },
      "description": "Fired when a refund fails."
    }
  ],
  "inputs": [
    {
      "name": "secretKey",
      "type": "string",
      "envVar": "STRIPE_SECRET_KEY",
      "required": true,
      "description": "Stripe secret API key (sk_live_... or sk_test_...)."
    },
    {
      "name": "webhookSecret",
      "type": "string",
      "envVar": "STRIPE_WEBHOOK_SECRET",
      "required": true,
      "description": "Stripe webhook signing secret for verifying refund events."
    }
  ],
  "radzor": "1.0.0",
  "actions": [
    {
      "name": "createRefund",
      "params": [
        {
          "name": "paymentIntentId",
          "type": "string",
          "description": "Stripe payment intent ID to refund."
        },
        {
          "name": "amount",
          "type": "number",
          "required": false,
          "description": "Amount to refund in smallest currency unit. Omit for full refund."
        },
        {
          "name": "reason",
          "type": "'duplicate' | 'fraudulent' | 'requested_by_customer'",
          "required": false,
          "description": "Reason for the refund."
        }
      ],
      "returns": "Promise<RefundResult>",
      "description": "Create a full or partial refund for a payment."
    },
    {
      "name": "getRefundStatus",
      "params": [
        {
          "name": "refundId",
          "type": "string",
          "description": "Stripe refund ID to check."
        }
      ],
      "returns": "Promise<RefundResult>",
      "description": "Get the current status of a refund."
    }
  ],
  "outputs": [
    {
      "name": "refundResult",
      "type": "RefundResult",
      "fields": [
        {
          "name": "id",
          "type": "string",
          "description": "Stripe refund ID."
        },
        {
          "name": "amount",
          "type": "number",
          "description": "Refund amount in smallest currency unit (e.g. cents)."
        },
        {
          "name": "currency",
          "type": "string",
          "description": "Currency of the refund."
        },
        {
          "name": "status",
          "type": "string",
          "description": "Refund status (pending, succeeded, failed, canceled)."
        },
        {
          "name": "paymentIntentId",
          "type": "string",
          "description": "Associated payment intent ID."
        },
        {
          "name": "reason",
          "type": "string",
          "required": false,
          "description": "Reason for the refund."
        }
      ],
      "description": "Result of a refund operation."
    }
  ],
  "runtime": "server",
  "version": "0.1.0",
  "category": "payment",
  "languages": [
    "typescript",
    "python"
  ],
  "description": "Process full and partial refunds via Stripe. Create refunds against payment intents or charges, check refund status, and react to refund lifecycle events.",
  "dependencies": {
    "radzor": [],
    "packages": {}
  },
  "composability": {
    "connectsTo": [
      {
        "output": "refundResult",
        "mapField": "id",
        "compatibleWith": [
          "@radzor/email-send.action.send.message",
          "@radzor/notification-hub.action.send.body"
        ]
      },
      {
        "event": "onRefundCompleted",
        "description": "Notify customer of successful refund",
        "compatibleWith": [
          "@radzor/email-send.action.send.message",
          "@radzor/slack-bot.action.sendMessage.text"
        ]
      },
      {
        "event": "onRefundFailed",
        "description": "Alert on failed refund",
        "compatibleWith": [
          "@radzor/error-tracker.action.captureMessage.message",
          "@radzor/slack-bot.action.sendMessage.text"
        ]
      }
    ]
  }
}

@radzor/payment-refund

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json