skills.rest
payroc
payrocOFFICIAL
Explore all skills by this author →
WebsiteGitHub

run-a-card-sale

Automate immediate-capture card sales through the Payroc Payments API.

1|Updated May 1, 2026
Search Tags:#API integration#payment processing#card payments#Payroc Payments API#immediate-capture payment
One-click install
npx skills add https://github.com/payroc/skills --skill run-a-card-sale
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: run-a-card-sale
Source: https://github.com/payroc/skills/tree/main/plugins/payroc/transaction/skills/run-a-card-sale
Command: npx skills add https://github.com/payroc/skills --skill run-a-card-sale

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pypdf, pdfplumber, pdf2image, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers to streamline and automate the process of running card sales (immediate-capture payments) through the Payroc Payments API.

Core Features & Use Cases

  • Immediate-Capture Payment Processing: Guides developers through making card payments with features like authenticating the payment method, capturing the payment immediately, and handling errors.
  • Payment Request Building: Offers guidance on how to build and send payment requests using Payroc API conventions, including constructing the request body, handling the channel, currency, amount, and payment method.
  • Response Handling: Teaches developers how to interpret the API's response and extract essential information such as paymentId, transaction status, and payment method details.
  • Error Handling: Provides detailed guidance on common error scenarios, how to troubleshoot them, and how to communicate with developers about each step in the payment process.

Quick Start

Run a card sale for the 'order_id_123' using card details with this skill.

Frequently Asked Questions about run-a-card-sale

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

FAQPage Schema
How do I process immediate-capture card payments using the Payroc Payments API?▼

To process immediate-capture card payments with the Payroc Payments API, you construct a payment request body containing the channel, currency, amount, and payment method, then submit it to authenticate and capture the payment instantly.

How should I handle errors when submitting card payment requests to the Payroc API?▼

Handling errors for Payroc API card payment requests involves interpreting the API response to identify common failure scenarios, troubleshooting the specific request payload or authentication issue, and communicating the transaction status back to the system.

What information is included in the Payroc API response after a card sale?▼

The Payroc API response after a card sale includes essential information such as the paymentId, the final transaction status, and the details of the payment method used, which developers extract to confirm the immediate-capture payment.

How do I build a payment request body for Payroc card sales?▼

Building a Payroc card sale payment request requires structuring the request body using Payroc API conventions, specifically including the channel, currency, amount, and the payment method details for the immediate-capture transaction.

Does the Payroc API support immediate-capture payments for automated card sales?▼

Yes, the Payroc Payments API supports immediate-capture payments, allowing developers to automate card sale processes by authenticating the payment method and capturing the funds instantly within a single API request.

What is the best way to automate Payroc card payment processing workflows?▼

The best way to automate Payroc card payment processing is by programmatically constructing payment requests, submitting them for immediate capture, and parsing the API response to extract the paymentId and transaction status for record-keeping.

Related Skills

Explore More Software Engineering Skills→
payrocpayroc

save-a-payment-method

Tokenize customer payment details using the Payroc Secure Tokens API.

Official
Advanced
mr-kellymr-kelly
4

kelly-money

Aggregate financial data from multiple payment providers into a unified local ledger.

Community
Advanced
payrocpayroc

manage-subscriptions

Manage Payroc repeat-payments subscriptions and payment plans via CRUD operations.

Official
Intermediate
payrocpayroc

refund-a-card-payment

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

Official
Intermediate