integrate-payroc-cloud
Guides developers through running in-person, card-present sales and refunds through Payroc Cloud — the semi-integrated cloud-to-device API where a POS sends an instruction to the Payroc gateway and the gateway relays it to a physical payment device. Use this skill whenever the user mentions Payroc Cloud, "pay by cloud", semi-integrated card-present payments, sending a sale/refund/signature to a terminal or card reader via the API, payment-instructions / refund-instructions / signature-instructions, polling an instruction, or cloud device payments — even if they don't say "skill" explicitly. Covers the async submit -> poll -> follow-link -> retrieve flow, idempotency, cancelling an in-progress instruction, referenced vs unreferenced refunds, reversals, signature capture, closed-loop reads, and finding a device serialNumber via GET /devices. Do NOT use this skill for card-not-present / e-commerce flows, for Hosted Fields, Hosted Payment Pages, or Payment Links (browser-based — separate skills), or for physically configuring or pairing a payment device (that is hardware setup, out of scope). If the user wants to set up or pair a device, say that is out of scope and that this skill picks up once a device serial number exists.
- Version
- 0.2.1
Pinned to revision a3761e0e5c18, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/integrate-payroc-cloud/SKILL.md
- skills/integrate-payroc-cloud/references/_sources.md
- skills/integrate-payroc-cloud/references/api-schema.md
- skills/integrate-payroc-cloud/references/error-response-format.md
- skills/integrate-payroc-cloud/references/identity-call.md
- skills/integrate-payroc-cloud/references/narrative-extend.md
- skills/integrate-payroc-cloud/references/narrative-run-a-sale.md
Every link opens the file at its source, pinned to the revision this page describes.