run-a-pre-authorization

Create, adjust, capture, or reverse card pre-authorizations via Payroc Payments API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps developers streamline the process of creating pre-authorizations and capturing funds from a card without immediate settlement, simplifying complex payment workflows.

Core Features & Use Cases

  • Pre-Authorization Handling: Create pre-authorizations and adjust amounts if necessary.
  • Capture or Reverse Pre-Authorizations: Capture funds from a pre-authorization or release the hold without charging.
  • Use Case: For a hotel that wants to place a hold on a customer's card for a reservation without immediately charging them.

Quick Start

To initiate a pre-authorization for $100.00, use the skill: pre-auth initiate 100.00.

Frequently Asked Questions about run-a-pre-authorization

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

FAQPage Schema
How do I place a hold on a card without immediately charging it?▼

To place a hold without charging, you create a pre-authorization through the Payroc API. This reserves funds on the customer's card for later capture or reversal without immediate settlement.

Can I adjust the amount of a pre-authorization after creating it?▼

Yes, you can adjust the pre-authorization amount after creation. The workflow supports modifying the held amount to accommodate changes like incidental fees before final settlement.

How do I capture funds from a pre-authorization using the Payroc API?▼

To capture funds from a pre-authorization, you submit a capture request via the Payroc API using Bearer token authentication. This finalizes the charge and settles the previously held amount.

What is the best way to release a pre-authorization hold without charging the card?▼

The best way to release a pre-authorization hold is by performing a reversal. This cancels the reserved funds without settling a charge, useful for canceled reservations.

Do I need Bearer token authentication for Payroc API payment processing?▼

Yes, Bearer token authentication is required for secure Payroc API calls. You must include this token in your JSON requests to manage pre-authorizations and captures.

When do I need pre-authorization handling for card payments?▼

You need pre-authorization handling when reserving funds for uncertain final amounts, such as hotel reservations or deposits. It allows placing a hold and adjusting or capturing the amount later.