콜백

결제선생 -> 파트너에게 전달하는 콜백 입니다

파트너 하위 사업장 연동 결과 동기화 콜백

post

파트너 하위 사업장 연동 과정에서 연동 상태 변경을 페이민트 -> 파트너사에게 전달합니다. 파트너사는 아래 전문을 수신할 수 있는 엔드포인트를 구축해야 해야 합니다. 구축하신 엔드포인트의 URL을 '하위 사업장 등록 URL 발급(/auth/mapping)'의 callbackUrl 파라미터로 입력하면, 하위 사업장 연동 결과를 페이민트가 파트너사에 실시간으로 제공합니다.

Body

application/json

파트너 인증 맵핑 결과 콜백 페이로드

memberIdstringOptional

파트너 사용자 코드

Example: partner-user-1

merchantIdstringOptional

파트너 매장 코드

Example: partner-merchant-1

Responses

200

파트너 측 수신 성공

application/json

파트너 콜백 응답 포맷

codestringRequired

응답 코드. 0000으로 응답합니다.

Example: 0000

post/(승인 동기화 파트너사가 제공하는 callbackUrl)

HTTPcURLJavaScriptPython

POST /(승인 동기화 파트너사가 제공하는 callbackUrl) HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 287

{
  "memberId": "partner-user-1",
  "merchantId": "partner-merchant-1",
  "member": {
    "id": "[e-mail]"
  },
  "merchant": {
    "companyName": "결제선생",
    "branchName": "뚝섬점",
    "businessNumber": 1234567890,
    "reviewStatus": "O",
    "reviewMessage": "사업자등록증을 첨부해 주세요.",
    "isDeleted": "N"
  }
}

200

파트너 측 수신 성공

{
  "code": "0000"
}

결제 승인 동기화 콜백

post

결제 승인이 완료되면 페이민트 -> 파트너사에게 결과를 전달합니다. 파트너사는 아래 전문을 수신할 수 있는 엔드포인트를 구축해야 합니다. 구축하신 엔드포인트의 URL을 '청구서 생성(/bill)'의 callbackUrl 파라미터로 입력하면, 결제 승인 결과를 페이민트가 파트너사에 실시간으로 제공합니다.

Body

application/json

파트너에게 POST 되는 승인동기화 콜백 payload. camelCase 컨벤션.

apiKeystringOptional

파트너 연동용 API Key

Example: abcd1234efgh5678

billIdstringOptional

업체용 청구서 ID

Example: BILL20260420001

apprPayTypestringOptional

결제수단 코드 (간편결제 0 등)

Example: 0

apprCardTypestringOptional

카드 종류 — CardBin 조회 결과. 조회 실패 시 '정보없음'

Example: 신용

apprDtstringOptional

승인 일시 (yyyyMMddHHmmss). 승인동기화에서는 apprOriginDt 와 동일 값

Example: 20260420153012

apprOriginDtstringOptional

원거래 승인 일시 (yyyyMMddHHmmss)

Example: 20260420153012

apprPricestringOptional

승인 금액 (원 단위 문자열)

Example: 22000

apprIssuerstringOptional

카드명 또는 은행명. 헬스케어(hc-) 건에서 표준 코드 매핑 실패 시 null

Example: 신한카드

apprIssuerCdstringOptional

발행사 코드 또는 은행 코드. 헬스케어(hc-) 건에서 표준 코드 매핑 실패 시 null

Example: 04

apprIssuerNumstringOptional

카드번호/계좌번호. 분당제생병원 KSNET+KAKAOPAY+MONEY 케이스에선 바코드번호(approval_otc)로 대체

Example: 123456******1234

apprAcquirerCdstringOptional

매입사 코드. 영남대 KOCES 케이스에선 YoungNamAcquireCode 로 변환

Example: 04

apprAcquirerNmstringOptional

매입사명

Example: 신한카드

apprNumstringOptional

승인/취소 거래번호. 승인동기화에서는 apprOriginNum 과 동일 값

Example: 30012345

apprOriginNumstringOptional

원거래 승인번호

Example: 30012345

apprResCdstringOptional

VAN 응답 코드

Example: 0000

apprMonthlystringOptional

할부 개월수 (0: 일시불)

Example: 0

apprStatestringOptional

승인 상태 (F:승인, W:대기, C:취소, D:파기). 승인동기화는 F 만 파트너에게 전달

Example: F

apprCashNumstringOptional

현금영수증 승인번호

Example: 1234567890

apprCashTraderstringOptional

현금영수증 발급 구분 (personal/corporate 등)

Example: personal

apprCashIssuanceNumberstringOptional

현금영수증 발급 요청 번호

Example: 01012345678

apprCardMerchantNumstringOptional

신용카드 가맹점 정보 — 헬스케어(hc-) 전용

Example: 123456789012

catIdstringOptional

단말기 번호 (CAT ID) — 헬스케어(hc-) 전용

Example: DPT0Q62733

udItemanyOptional

사용자 정의 JSON 필드 (bill_user_define.item) — 헬스케어(hc-) 전용

dscTxNumstringOptional

거래 고유번호 (approval_tx_id) — 헬스케어(hc-) 전용

cardTypestringOptional

페이민트 공통 카드 타입 — 영남대 KOCES 전용 (원장 card_type 컬럼 그대로 전달)

apprSignstringOptional

전자서명 데이터 (Base64). 3000 byte 초과 시 JPEG 압축/리사이즈 — 헬스케어(hc-) 전용

Responses

200

파트너 측 수신 성공

application/json

파트너 콜백 응답 포맷

codestringRequired

응답 코드. 0000으로 응답합니다.

Example: 0000

post/(결제 승인 시 파트너사가 제공한 callbackUrl)

HTTPcURLJavaScriptPython

POST /(결제 승인 시 파트너사가 제공한 callbackUrl) HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 616

{
  "apiKey": "abcd1234efgh5678",
  "billId": "BILL20260420001",
  "apprPayType": 0,
  "apprCardType": "신용",
  "apprDt": 20260420153012,
  "apprOriginDt": 20260420153012,
  "apprPrice": 22000,
  "apprIssuer": "신한카드",
  "apprIssuerCd": "04",
  "apprIssuerNum": "123456******1234",
  "apprAcquirerCd": "04",
  "apprAcquirerNm": "신한카드",
  "apprNum": 30012345,
  "apprOriginNum": 30012345,
  "apprResCd": "0000",
  "apprMonthly": 0,
  "apprState": "F",
  "apprCashNum": 1234567890,
  "apprCashTrader": "personal",
  "apprCashIssuanceNumber": "01012345678",
  "apprCardMerchantNum": 123456789012,
  "catId": "DPT0Q62733",
  "udItem": null,
  "dscTxNum": "text",
  "cardType": "text",
  "apprSign": "text"
}

200

파트너 측 수신 성공

{
  "code": "0000"
}