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

look-up-card-details

Retrieve card metadata and surcharge eligibility via the Payroc BIN lookup API.

1|Updated May 1, 2026
Search Tags:#transaction processing#Payroc API#card details#BIN lookup#card metadata
One-click install
npx skills add https://github.com/payroc/skills --skill look-up-card-details
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: look-up-card-details
Source: https://github.com/payroc/skills/tree/main/plugins/payroc/transaction/skills/look-up-card-details
Command: npx skills add https://github.com/payroc/skills --skill look-up-card-details

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the process of looking up card details using the Payroc BIN lookup API, providing card metadata such as brand, country, and surcharging eligibility.

Core Features & Use Cases

  • Card Metadata Retrieval: Retrieve card brand, country of issue, debit/credit indicator, healthcare/FSA/HSA flag, and surcharging eligibility.
  • Use Case: A developer needs to determine the card type, issuer country, or surcharge eligibility for a transaction before processing.

Quick Start

Run the 'look-up-card-details' skill to retrieve card details for the card number 411111XXXXXX.

Frequently Asked Questions about look-up-card-details

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

FAQPage Schema
How do I retrieve card details and metadata using a BIN lookup?▼

You retrieve card details by sending the BIN (first 6-8 digits), full card data, secure token, or digital wallet input to the Payroc API. The API returns card brand, country of issue, and surcharge eligibility metadata.

What card metadata can I get from the Payroc API?▼

The Payroc API returns card metadata including card brand, country of issue, debit/credit indicator, healthcare/FSA/HSA flag, and surcharging eligibility for transaction processing.

Does the Payroc BIN lookup support digital wallet and secure token inputs?▼

Yes, the Payroc BIN lookup supports digital wallet input and secure token input alongside BIN and full card data. This allows you to retrieve card type and surcharge eligibility without exposing raw card numbers.

Do I need an API key and processing terminal ID for card surcharge eligibility?▼

Yes, retrieving surcharging eligibility requires both an API key and a processing terminal ID. You must provide these credentials to the Payroc API to determine if a card is eligible for surcharging.

Can I check FSA and HSA card eligibility before transaction processing?▼

Yes, you can check FSA and HSA card eligibility before transaction processing by looking up the card details. The Payroc API returns a healthcare/FSA/HSA flag as part of the card metadata response.

Related Skills

Explore More Software Engineering Skills→
payrocpayroc

integrate-hosted-fields

Guide Payroc Hosted Fields integration with Python and API credentials.

Official
Advanced
payrocpayroc

refund-a-card-payment

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

Official
Intermediate
payrocpayroc

run-a-pre-authorization

Create, adjust, capture, or reverse card pre-authorizations via Payroc Payments API.

Official
Advanced
payrocpayroc

add-attachment-to-processing-account

Upload documents to Payroc processing accounts via the Boarding API.

Official
Advanced