빌키 삭제 API
등록된 빌키를 삭제하는 API입니다. 구독 해지, 카드 변경 등의 경우에 사용합니다.
삭제 시 주의
빌키를 삭제하면 해당 빌키로 더 이상 결제를 진행할 수 없으며, 삭제된 빌키는 복구할 수 없습니다.
요청 파라미터
POST
/api/v1/bill_delete
Base URL
https://dev.firstpay.co.krContent-Type
application/json필수
조건부 필수
| key | 타입 | 최대크기 | 필수 | 설명 |
|---|---|---|---|---|
mxId | String | 12 | 가맹점 ID | |
billKey | String | 28 | 빌키 | |
callHash | String | - | 체크용 해시 데이터 : SHA256(mxId + billKey + passKey) |
요청 예시
json
{
"mxId": "testcorp",
"billKey": "BK20241103103045ABC123",
"callHash": "SHA256(mxId + billKey + passKey)"
}응답 파라미터
API 응답은 서비스 API 공통 형식을 따릅니다.
data 필드 상세는 아래와 같습니다.
필수
조건부 필수
| key | 타입 | 최대크기 | 필수 | 설명 |
|---|---|---|---|---|
mxId | String | 12 | 가맹점 ID | |
billKey | String | 28 | - | 빌키 |
custNo | String | 64 | 회원번호 |
복구 불가
삭제된 빌키는 복구할 수 없습니다. 고객이 다시 결제하려면 새로운 빌키를 등록해야 합니다.
빌키 취소 vs 빌키 삭제
- 빌링 취소: 특정 결제 건을 취소 (빌키는 유지됨)
- 빌키 삭제: 빌키 자체를 삭제하여 더 이상 결제 불가
결제를 취소해도 빌키는 남아있어 다음 결제 시 재사용할 수 있습니다.