refund-a-card-payment

Create, retrieve, adjust, and reverse card payment refunds via the Payroc API.

1|Updated May 1, 2026
One-click install
npx skills add https://github.com/payroc/skills --skill refund-a-card-payment
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refund-a-card-payment
Source: https://github.com/payroc/skills/tree/main/plugins/payroc/transaction/skills/refund-a-card-payment
Command: npx skills add https://github.com/payroc/skills --skill refund-a-card-payment

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill simplifies the task of refunding card payments by providing developers with a comprehensive guide and automated Payroc API interactions, streamlining the process of issuing credits and refunds to cardholders.

Core Features & Use Cases

  • Referenced Refund Creation: Create refunds using an existing payment ID for traceability.
  • Unreferenced Refund Creation: Initiate refunds without a payment ID by providing card details.
  • Extended Operations: Perform operations like listing refunds, adjusting, and reversing refunds while still in an open batch.
  • Use Case: Process returns for a card payment by generating a referenced refund for an order with a specific payment ID or using an unreferenced refund for customers without a payment ID.

Quick Start

Start by identifying whether the payment is referenced or unreferenced and execute the appropriate refund creation method with the provided parameters.

Frequently Asked Questions about refund-a-card-payment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I refund a card payment using the Payroc API?▼

To refund a card payment using the Payroc API, you can create a referenced refund using an existing payment ID for traceability, or initiate an unreferenced refund by providing card details directly.

What is the difference between a referenced and unreferenced refund?▼

A referenced refund uses an existing payment ID to trace the refund back to the original transaction, while an unreferenced refund initiates a credit to the cardholder without a payment ID by providing card details directly.

Can I adjust or reverse a card payment refund through the Payroc API?▼

Yes, you can perform extended operations like adjusting and reversing card payment refunds through the Payroc API, provided the refund transaction is still in an open batch.

How do I list previously processed card payment refunds?▼

You can list previously processed card payment refunds by interacting with the specific Payroc API endpoints designed for retrieval, allowing you to track and manage refund history.

Do I need a payment ID to process a refund for a customer?▼

No, you do not need a payment ID to process a refund if you use the unreferenced refund creation method, which allows you to initiate refunds by providing the cardholder's card details directly through the Payroc API.