Service
신한카드의 카드, 거래, 이용대금명세서, 포인트, 이용한도, 실적 화면 카드, 소득공제 정보를 정규화하여 읽기 전용으로 제공합니다.
85.44%30일 가동률평균 응답1381ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/shinhan-card/card-approvals | Lists card approval (authorization) transactions in a date range of at most six calendar months, consuming every cursor page. Use when the user asks what was charged, approved, or cancelled on their Shinhan Card. Do NOT use for merchant-settled purchases and refunds — use shinhan-card:card-purchases instead. Returns items with transaction_id, approved_at, merchant_name, amount (KRW), card_label, status, and optional funding_type, plus returned_count, total_count, start_date, and end_date. | |
| POST | /v1/shinhan-card/card-bills | Lists credit-card bills by payment date: the billed amount, the payment date, and the upcoming payment estimates (Shinhan Card can list both the next month and the month after it), with statement_date and statement_sequence. Use when the user asks how much their credit card will charge this month or next month, or when the payment is due. Rows with period upcoming are estimates for bills not yet issued; pick the month you need by payment_due_date. Do NOT use for individual transactions — use shinhan-card:card-approvals instead; for check-card statements use shinhan-card:statement-months. Returns has_credit_card, has_check_card, upcoming_status, upcoming_status_code, items, and returned_count. | |
| POST | /v1/shinhan-card/card-performance | Lists the cards shown on Shinhan Card's spending-performance (실적) screen. Use only when the user asks which cards appear on that screen. Do NOT use for spending totals — use shinhan-card:card-approvals instead. Do NOT use for the full list of held cards — use shinhan-card:cards instead. No spending-performance or benefit amounts are available from this endpoint; only card identity is returned. Returns cards with product_code, card_name, masked_card_suffix, and network, plus returned_count. | |
| POST | /v1/shinhan-card/card-purchases | Lists merchant-settled purchases (매입) in a date range of at most six calendar months, consuming every cursor page. Use when the user asks for settled charges and refunds, purchase dates, or domestic/international scope. Do NOT use for authorization-time approvals — use shinhan-card:card-approvals instead. Returns items with transaction_id, purchased_on, direction, merchant_id, merchant_name, scope, and amount, plus returned_count and total_count. | |
| POST | /v1/shinhan-card/cards | Lists the cards held on the account with masked number, card name, product code, normalized network, expiration month, and whether transit payment is enabled. Use when the user asks which Shinhan cards they have. Do NOT use for the cards shown on the spending-performance (실적) screen — use shinhan-card:card-performance instead. Returns items and returned_count. | |
| POST | /v1/shinhan-card/credit-limits | Gets the current credit limits on the account. Use when the user asks about their total, cash-advance, installment, or business limit. Do NOT use for point balances or spending totals — use shinhan-card:point-balances or shinhan-card:card-approvals instead. Returns total_limit, cash_advance_limit, installment_limit, and business_limit; other values on the limit screen are not exposed. | |
| POST | /v1/shinhan-card/point-balances | Lists point-program balances on the account. Use when the user asks how many Shinhan Card points they have. Do NOT use for credit limits or transaction history — use shinhan-card:credit-limits or shinhan-card:card-approvals instead. Returns items with program_code, program_name, and balance in points, plus returned_count. | |
| POST | /v1/shinhan-card/statement-detail | Check-card statements only; for credit-card bills and upcoming payments use shinhan-card:card-bills. Gets one monthly statement using the statement_date and statement_sequence returned by statement-months; both values must come from the same row. Use when the user asks for the per-card breakdown or payment bank of a specific statement. Do NOT use to discover which statements exist — use shinhan-card:statement-months instead. Returns statement_date, payment_bank_name, total_amount, cards, and returned_card_count. | |
| POST | /v1/shinhan-card/statement-months | Check-card statements only; for credit-card bills and upcoming payments use shinhan-card:card-bills. Lists the available monthly statements with statement_date, statement_sequence, and the statement total. Use when the user asks how much a monthly statement was, or needs the date and sequence for a detail request. Do NOT use for per-card statement amounts or the payment bank — use shinhan-card:statement-detail instead. Returns items and returned_count. | |
| POST | /v1/shinhan-card/tax-deductions | Gets current-year monthly year-end tax-deduction usage, split by payment type (credit, debit, prepaid) and by additional-deduction category (traditional market, public transit, books and performances). Use when the user asks about year-end tax deduction (연말정산 소득공제) amounts. No year parameter is accepted; the current year is always returned. Do NOT use for individual transaction lists — use shinhan-card:card-approvals instead. Returns year, available_years, months, and returned_count. |
key가 호출할 수 있는 서비스와 API의 범위를 정의합니다.
멱등한 호출의 재시도 규칙과 backoff 동작을 설명합니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
지난 30일 동안 이 서비스에서 관측된 기록입니다.
