수납 및 결제취소

수납 시 승인동기화

고객이 청구서를 통해 결제를 완료하면, 페이민트가 파트너사의 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

결제 실패, 결제 취소 시 상태값을 전달되지 않습니다.
연동검수 시 승인동기화에 대한 정상 수신 응답 0000을 반환 받아야 검수가 완료됩니다.
승인동기화 데이터는 파트너사가 자체적으로 저장·관리해야 합니다.
현금영수증 결제인 경우 appr_cash_num, appr_cash_trader, appr_cash_issuance_number 필드가 함께 전달됩니다.

이미 결제가 완료된 건에 대한 결제를 취소 처리합니다.

취소 시 bill_id는 원래 발송 요청 시 사용한 값과 동일해야 합니다.
hash는 {bill_id} + "," + {price} 로 생성합니다. (발송 요청과 달리 phone이 포함되지 않습니다.)
이미 취소된 건을 다시 취소하면 9970 에러가 반환됩니다.
취소 응답에는 appr_num(취소 거래번호), appr_origin_num(원거래 승인번호), appr_cancel_dt(취소일시)가 포함됩니다.
매니저사이트/매니저앱에서 직접 결제 취소 및 청구서가 파기된 경우 API를 통해 callback이 전달되지 않습니다.

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