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.