빌링 승인 API

등록된 빌키를 사용하여 실제 결제를 진행하는 API입니다. 고객의 카드 정보를 다시 입력받지 않고 빌키만으로 결제할 수 있습니다.

빌키 필수

결제 전에 반드시 빌키 등록 API로 빌키를 생성해야 합니다. 유효하지 않은 빌키로 요청하면 승인이 실패합니다.

결제 금액 주의

1,004원은 당사 정책에 따라 매입 처리되지 않으며, 매입 취소도 불가능합니다. 운영환경에서 테스트하실 경우 1,004원 이외의 금액을 사용해 주세요.

요청 파라미터

POST

/api/v1/bill_approval

Base URLhttps://dev.firstpay.co.kr

Content-Typeapplication/json

필수

조건부 필수

key	타입	최대크기	필수	설명
`mxId`	String	12		가맹점 ID
`mxIssueNo`	String	32		주문번호
`mxIssueDate`	String	14		주문일시 (YYYYMMDDHHMMSS)
`amount`	Number	-		결제금액
`billKey`	String	40		빌키
`orderName`	String	256	-	상품명
`custName`	String	64	-	주문자 명
`email`	String	32	-	주문자 이메일주소
`phoneNo`	String	32	-	주문자 휴대폰번호 ('-' 제거)
`taxAmount`	Number	-	-	과세결제금액
`taxFreeAmount`	Number	-	-	면세결제금액
`callHash`	String	-		체크용 해시 데이터 : SHA256(mxId + mxIssueNo + amount + passKey)

요청 예시

json

{
  "mxId": "testcorp",
  "mxIssueNo": "YYYYMMDD00001",
  "mxIssueDate": "YYYYMMDDHHMMSS",
  "amount": 1000,
  "billKey": "BK20241103103045ABC123",
  "orderName": "정기구독 11월",
  "custName": "홍길동",
  "email": "hong@example.com",
  "phoneNo": "01012345678",
  "callHash": "SHA256(mxId + mxIssueNo + amount + passKey)"
}

응답 파라미터

API 응답은 서비스 API 공통 형식을 따릅니다. data 필드 상세는 아래와 같습니다.

필수

조건부 필수

key	타입	최대크기	필수	설명
`mxId`	String	12		가맹점 ID
`mxIssueNo`	String	32		주문번호
`mxIssueDate`	String	14		주문일시 (YYYYMMDDHHMMSS)
`amount`	Number	12		결제금액
`authNo`	String	12	-	승인번호
	String	2	-	매입사코드
`acqName`	String	-	-	매입사명
	String	2	-	발급사코드
`issName`	String	-	-	발급사명
`ccNo`	String	-	-	마스킹 된 카드번호
	String	1	-	체크카드 여부
`authDate`	String	14		거래시간 (YYYYMMDDHHMMSS)
`tid`	String	40		거래 ID
`oTid`	String	40		원거래 ID