{"openapi":"3.0.3","info":{"title":"APICK 결제카드 판독(OCR)","version":"1.0.0","description":"신용·체크카드 사진에서 카드번호·유효기간·소유자명을 읽어 돌려줍니다. 카드번호는 첫 6자리와 끝 4자리만 보여 주고 가운데는 *로 가립니다. 결제수단 등록 화면에서 카드 정보를 손으로 옮겨 적는 일을 줄이는 데 맞춰 만들었습니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/payment_card_ocr":{"post":{"summary":"결제카드 판독(OCR)","description":"신용·체크카드 사진에서 카드번호·유효기간·소유자명을 읽어 돌려줍니다. 카드번호는 첫 6자리와 끝 4자리만 보여 주고 가운데는 *로 가립니다. 결제수단 등록 화면에서 카드 정보를 손으로 옮겨 적는 일을 줄이는 데 맞춰 만들었습니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"card_number":{"type":"string","description":"가운데를 *로 가린 카드번호입니다(예: 123456******7890)."},"card_number_last4":{"type":"string","description":"카드번호 끝 4자리입니다."},"card_number_first6":{"type":"string","description":"카드번호 첫 6자리입니다."},"expiry":{"type":"string","description":"유효기간 MM/YY입니다. 읽지 못하면 빈 문자열입니다."},"expiry_month":{"type":"integer","description":"유효기간 월입니다. 읽지 못하면 0입니다."},"expiry_year":{"type":"integer","description":"유효기간 연도(4자리)입니다. 읽지 못하면 0입니다."},"cardholder":{"type":"string","description":"카드에 영문으로 적힌 소유자명입니다. 없으면 빈 문자열입니다."},"checks":{"type":"object","properties":{"카드번호_형식":{"type":"boolean","description":"카드번호가 13~19자리인지 여부입니다."},"카드번호_Luhn":{"type":"boolean","description":"카드번호 검증 숫자가 맞는지 여부입니다."}},"description":"자동 확인 결과입니다."},"success":{"type":"integer","description":"처리 결과입니다. 1: 성공(과금), 0: 실패, 3: 시간 초과(과금 없음)."}},"description":"판독 결과"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"요청을 정상 처리했는지 여부입니다."},"cost":{"type":"integer","description":"이번 요청에서 차감된 포인트입니다."},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."},"pl_id":{"type":"integer","description":"결제 기록 번호입니다. 문의할 때 함께 알려 주세요."}},"description":"호출 공통 정보"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"image":{"type":"string","description":"분석할 이미지 파일입니다. JPG·PNG·WEBP를 지원하며, 파일 크기·해상도 제한은 요청 표를 확인하세요. (file)","format":"binary"}},"required":["image"]}}}}}}},"x-code-tables":[{"title":"오류와 대처","columns":["HTTP","data.error","대처"],"rows":[["400","판독할 이미지(image)가 없습니다.","카드 사진을 image 필드로 보내세요."],["400","이미지 형식의 파일만 보낼 수 있습니다.","PNG·JPEG 이미지인지 확인하세요."],["422","이미지에서 글자를 읽지 못했습니다. …","카드 전체가 밝고 반듯하게 나오도록 다시 찍게 하세요."],["422","카드번호를 찾지 못했습니다. …","카드 앞면 번호가 선명하게 나오도록 다시 찍게 하세요."],["424","카드를 판독하지 못했습니다. 잠시 후 다시 시도해 주세요.","잠시 뒤 한 번 더 요청하세요."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}