run-a-pre-authorization
Guides developers through running a card pre-authorization via the Payroc Payments API (POST /v1/payments with autoCapture: false), then capturing or reversing it. Use this skill when the user wants to hold funds on a card without immediately capturing, run a pre-auth, authorize a card payment for later capture, implement a hotel or car-rental hold pattern, build a deferred-capture payment flow, capture a pre-authorized payment, void or reverse a pre-authorization, or adjust a pre-authorization amount before capture — even if they don't use the word "pre-authorization" explicitly. Also trigger for questions about the difference between a sale and a pre-auth, or how to capture a held amount. Do NOT use for immediate card sales (autoCapture: true), ACH/bank-transfer payments, refunds on settled transactions, 3-D Secure authentication, or tokenization — those are separate skills.
- Version
- 0.1.2
Pinned to revision a3761e0e5c18, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/run-a-pre-authorization/SKILL.md
- skills/run-a-pre-authorization/references/_sources.md
- skills/run-a-pre-authorization/references/api-schema.md
- skills/run-a-pre-authorization/references/error-response-format.md
- skills/run-a-pre-authorization/references/identity-call.md
- skills/run-a-pre-authorization/references/run-a-pre-authorization-guide.md
Every link opens the file at its source, pinned to the revision this page describes.