💷가상계좌 환불하기
가상계좌 입금내역을 환불하는 방법을 확인합니다.
Last updated
Was this helpful?
가상계좌 입금내역을 환불하는 방법을 확인합니다.
Last updated
Was this helpful?
Was this helpful?
가상계좌의 경우 단방향 결제수단이여서 환불 대상을 알 수 없으므로 환불 금액 외에 다음의 환불 수령계좌 정보를 입력해야 합니다.
refund_holder: 환불 수령계좌 예금주
refund_account: 환불 수령계좌 번호
refund_bank: 환불 수령계좌 은행코드
/* ... 중략 ... */
app.post('/payments/cancel', async (req, res, next) => {
try {
/* 액세스 토큰(access token) 발급 */
/* ... 중략 ... */
/* 결제정보 조회 */
const { body } = req;
// 클라이언트로부터 전달받은 주문번호, 환불사유, 환불금액, 가상계좌 정보(예금주, 계좌번호, 은행코드)
const { merchant_uid, reason, cancel_request_amount, refund_holder, refund_bank, refund_account } = body;
Payments.find({ merchant_uid }, async function(err, payment) {
/* ... 중략 ... */
const paymentData = payment[0]; // 조회된 결제정보
// 조회한 결제정보로부터 imp_uid, amount(결제금액), cancel_amount(환불된 총 금액) 추출
const { imp_uid, amount, cancel_amount } = paymentData;
// 환불 가능 금액(= 결제금액 - 환불된 총 금액) 계산
const cancelableAmount = amount - cancel_amount;
if (cancelableAmount <= 0) { // 이미 전액 환불된 경우
return res.status(400).json({ message: "이미 전액환불된 주문입니다." });
}
...
/* 포트원 REST API로 결제환불 요청 */
const getCancelData = await axios({
url: "https://api.iamport.kr/payments/cancel",
method: "post",
headers: {
"Content-Type": "application/json",
"Authorization": access_token // 포트원 서버로부터 발급받은 엑세스 토큰
},
data: {
reason, // 가맹점 클라이언트로부터 받은 환불사유
imp_uid, // imp_uid를 환불 `unique key`로 입력
amount: cancel_request_amount, // 가맹점 클라이언트로부터 받은 환불금액
checksum: cancelableAmount, // [권장] 환불 가능 금액 입력
refund_holder, // [가상계좌 환불시 필수입력] 환불 수령계좌 예금주
refund_bank, // [가상계좌 환불시 필수입력] 환불 수령계좌 은행코드(ex. KG이니시스의 경우 신한은행은 88번)
refund_account // [가상계좌 환불시 필수입력] 환불 수령계좌 번호
}
});
const { response } = getCancelData.data; // 환불 결과
/* 환불 결과 동기화 */
...
});
} catch (error) {
res.status(400).send(error);
}
});다음과 같이 가상계좌 환불을 요청하여 성공하면 PG사 담당자가 다음날 해당 계좌로 환불 금액을 입금합니다. 이는 통상적으로 영엽일 기준 하루 정도 소요됩니다.
