수납 및 결제취소(작성중)

1. 수납(승인동기화) 흐름

고객이 청구서를 통해 결제를 완료하면, 페이민트가 파트너사의 callbackURL로 승인 결과를 전달합니다. 이 과정을 "승인동기화"라고 합니다.

흐름 요약

고객 결제 → 페이민트 → VAN사 승인 요청 → 승인 완료 
→ 페이민트 → [승인동기화 API] → 파트너사 callbackURL
→ 파트너사 승인 결과 저장 → 저장 상태 반환 → 페이민트

핵심 포인트

• 호출 방향이 페이민트 → 파트너사입니다. 파트너사는 이 데이터를 수신할 REST API를 미리 구현해두어야 합니다.

• 결제 실패 및 취소 건은 파트너사로 결과를 전달하지 않습니다. 결제 성공 건만 결과를 전달합니다.

• 파트너사는 승인 결과를 수신한 후 반드시 아래의 형태와 값을 동일하게 세팅하여 정상 응답을 반환해야 합니다. 이 응답 데이터가 일치하지 않으면 검수가 완료되지 않습니다.

//response coee
{
    "code": "0000", 
    "msg": "성공하였습니다."
}

수신 데이터에서 확인할 주요 필드

• appr_state: 결제 상태 (F:결제완료, W:미결제, C:취소, D:파기)

• appr_pay_type: 결제수단 (CARD_VAN, KEYIN, OFFLINE_CARD, OFFLINE_CASH)

• appr_num: 승인번호 — 결제 취소 시 원거래 승인번호로 필요합니다.

• appr_dt: 승인일시 (YYYYMMDDHHMMSS)

주의사항

• 승인동기화 데이터는 파트너사가 자체적으로 저장·관리해야 합니다.

• 현금영수증 결제인 경우 appr_cash_num, appr_cash_trader, appr_cash_issuance_number 필드가 함께 전달됩니다.

2. 결제 상태 조회

승인동기화 콜백을 놓쳤거나, 현재 청구서의 결제 상태를 확인하고 싶을 때 사용합니다.

사용 시나리오

• 콜백 수신 실패 시 결제 여부 확인

• 고객 문의 대응 시 현재 상태 조회

• 취소/파기 처리 전 상태 사전 확인

3. 결제 취소

이미 결제가 완료된 건을 취소(환불) 처리합니다.

흐름 요약

파트너사 → [결제 취소 API] → 페이민트 → VAN사 취소 요청 → 취소 완료
→ 페이민트 → 파트너사에 취소 결과 응답

주의사항

• 취소 시 bill_id는 원래 발송 요청 시 사용한 값과 동일해야 합니다.

• hash는 {bill_id} + "," + {price} 로 생성합니다. (발송 요청과 달리 phone이 포함되지 않습니다.)

• 이미 취소된 건을 다시 취소하면 9970 에러가 반환됩니다.

• 취소 응답에는 appr_num(취소 거래번호), appr_origin_num(원거래 승인번호), appr_cancel_dt(취소일시)가 포함됩니다.