run-a-card-sale
Guides developers through running a card sale (immediate-capture payment) via the Payroc Payments API (POST /v1/payments). Use this skill when the user wants to process a card payment, charge a credit or debit card, run a card transaction or card sale, take a card payment, collect a card payment, run an immediate-capture payment, implement a direct-API card payment (server-to-server), accept a card payment online or in-store, process a MOTO payment, use a card token or single-use token to charge a customer, or work with the /v1/payments endpoint for a sale. Also use when the user asks about card payment channels (pos/web/moto), card entry methods, what fields are required for a card payment request, how to get a paymentId from a sale, or how to submit a card payment and handle the response — even if they don't use the word "skill" or "payments API" explicitly. Do NOT use for pre-authorization (autoCapture: false), refunds, reversals, ACH/bank-transfer payments, 3-D Secure authentication, or Hosted Fields / Hosted Payment Pages (embedded UI card input) — those are separate skills.
- Version
- 0.2.0
Pinned to revision a3761e0e5c18, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/run-a-card-sale/SKILL.md
- skills/run-a-card-sale/references/_sources.md
- skills/run-a-card-sale/references/api-schema.md
- skills/run-a-card-sale/references/error-response-format.md
- skills/run-a-card-sale/references/identity-call.md
- skills/run-a-card-sale/references/run-a-card-sale-guide.md
Every link opens the file at its source, pinned to the revision this page describes.