integrate-payroc-cloud

Guide card-present sales and refunds through Payroc Cloud async workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill simplifies running in-person, card-present sales and refunds through Payroc Cloud, streamlining the process and ensuring smooth transaction flows.

Core Features & Use Cases

  • Semi-integrated Payments: Handle card-present payments using Payroc Cloud, including sales, refunds, and signature capture.
  • Async Flow Management: Manage the submit-poll-follow-link-retrieve workflow for payment instructions.
  • Error Handling: Provides comprehensive error handling and explanations for common issues like token expiration, permission errors, and resource not found.
  • Use Case: Imagine a retail environment where you need to process card payments. Use this Skill to initiate a sale, capture a signature, and handle refunds all through the Payroc Cloud API.

Quick Start

Run a sale with Payroc Cloud by using the command: integrate-payroc-cloud run-sale --serial-number <device-serial-number> --amount <amount> --currency <currency-code>

Frequently Asked Questions about integrate-payroc-cloud

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

FAQPage Schema
How do I process card-present payments using Payroc Cloud API?

Semi-integrated card-present payments work by submitting an asynchronous payment instruction to Payroc Cloud, polling the API for transaction status, and following returned links to retrieve the final sale or refund result.

How do I handle async transaction polling and retrieval for Payroc Cloud sales?

Async transaction polling involves submitting a sale request via HTTP POST, repeatedly checking the transaction status via GET until completion, and then retrieving the final payment resource or following links to capture required signatures.

Can I capture customer signatures during card-present refunds through Payroc Cloud?

Yes, you can capture customer signatures during card-present refunds through Payroc Cloud by managing the submit-poll-follow-link-retrieve workflow, which supports retrieving signature capture resources after the initial refund instruction is processed.

Do I need a specific environment to integrate Payroc Cloud for in-person sales?

You need a Payroc Cloud account, an API key, and the curl command-line tool to integrate in-person sales, as the process relies on making HTTP POST, GET, and DELETE requests to manage transaction resources.

Why does my Payroc Cloud payment instruction return a token expiration error?

Token expiration errors during Payroc Cloud payment processing occur when API authentication credentials become invalid, and this Skill provides error handling to identify and explain common issues like permission errors and resource not found responses.

What is the best way to manage transaction resources when processing refunds with Payroc Cloud?

The best way to manage transaction resources during Payroc Cloud refunds is to use HTTP DELETE requests to clean up resources after successfully initiating the refund and retrieving the final transaction status through the async polling workflow.