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.