look-up-card-details
Guide a developer through calling the Payroc BIN lookup API (POST /v1/cards/bin-lookup) to retrieve card metadata — card brand (Visa, Mastercard, Amex), country of issue, debit/credit indicator, healthcare/FSA/HSA flag, and surcharging eligibility — before or without processing a transaction. Use this skill when a developer asks about looking up card details via the Payroc API, identifying a card network or brand from a BIN or card number, checking whether a card is debit or credit, checking surcharge eligibility for a specific card via API lookup, doing a BIN lookup, checking card issuer country via the BIN lookup endpoint, or checking if a card is FSA/HSA-linked. Also use when the developer has a card number (or first 6–8 digits) and wants to know what kind of card it is, whether surcharging applies to that card, or whether healthcare spending applies — even if they don't use the term "BIN lookup". Do NOT use for card number format validation (Luhn check), processing a card payment, pre-authorization, refunds, configuring surcharging on a terminal, or general surcharging setup — those are separate skills.
- Version
- 0.3.0
Pinned to revision a3761e0e5c18, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/look-up-card-details/SKILL.md
- skills/look-up-card-details/references/_sources.md
- skills/look-up-card-details/references/api-schema.md
- skills/look-up-card-details/references/error-response-format.md
- skills/look-up-card-details/references/identity-call.md
Every link opens the file at its source, pinned to the revision this page describes.