latestSwagger 2.02026-07-177680526.3 KB
006dfffdec43
vbanks
가상계좌 발급취소 API
발급된 가상계좌(입금이 되기 전)를 말소합니다. <br> 아직 입금이 되지 않은 가상계좌를 말소시킴으로써 구매자가 실수로 입금하는 경우를 방지하도록 합니다.<br> imp_uid가 지정되어야 합니다.(포트원 기획 의도상 동일한 merchant_uid의 입금대기 중인 가상계좌가 N개 존재할 수 있으므로 imp_uid로만 가상계좌 말소가 가능합니다) <h4>지원되는 PG사</h4> <ul> <li>KG이니시스 </li> <li>NHN KCP </li> <li>토스페이먼츠 - 구모듈 </li> <li>다날 </li> <li>나이스페이먼츠 </li> <li>KICC </li> <li>헥토파이낸셜(구 세틀뱅크) </li> <li>스마트로 - 구모듈 </li> <li>토스페이먼츠 - 신모듈 </li> <li>KSNET </li> <li> 스마트로 - 신모듈 </li> <li>(신) 나이스페이 </li> <li>웰컴페이먼츠</li></ul>
delete/vbanks/{imp_uid}
Path parameters
imp_uidstring required
포트원 거래고유번호
Query parameters
pg_api_keystring
이니시스의 가맹점 관리자 페이지에서 확인하셔야 하는 API Key 값으로 가상계좌 발급 및 말소 신청에 사용됩니다. 누락하거나 잘못된 키 입력 시 hashData 불일치 오류가 발생합니다. <br> POST 가상계좌 발급 API요청의 pg_api_key와 동일한 값입니다. <br> (이니시스 전용 필수 파라미터로 Query parameter입니다.)
Response
가상계좌 말소 완료
PaymentResponse required— unresolved $ref