가상계좌 환불 테스트 시 계좌 정보 오류 문의
안녕하세요.
가상계좌 환불 테스트를 테스트 환경에서 진행하던 중 정상 케이스로 통과 되던 계좌 번호가 "INVALID_REFUND_ACCOUNT_NUMBER" 오류를 받아 문의드립니다.
실제 계좌 번호에 문제가 있는 것인지, 아니면 테스트 환경이라 발생한 문제인지 알려주시면 감사하겠습니다.
1) 성공 케이스
- 주문번호: tmeec20251118144209HubP3
- 요청:
{
"currency": null,
"cancelAmount": 7000,
"cancelReason": "상품 또는 옵션 변경",
"taxFreeAmount": null,
"taxExemptionAmount": 0,
"cancelRequestId": null,
"taxAmount": null,
"refundableAmount": null,
"refundReceiveAccount": {
"bank": "하나",
"accountNumber": "287**8607",
"holderName": "이광섭"
}
}
- 응답
{
"virtualAccount": {
"accountNumber": "X9891223634537",
"accountType": "일반",
"bank": "하나",
"bankCode": "81",
"customerName": "스티븐",
"dueDate": "2025-11-20T14:42:08+09:00",
"expired": true,
"settlementStatus": "INCOMPLETED",
"refundStatus": "PENDING",
"refundReceiveAccount": {
"bankCode": "81",
"accountNumber": "28791031368607",
"holderName": "이광섭"
},
"depositorName": "테스트"
},
"transfer": null,
"mobilePhone": null,
"giftCertificate": null,
"cancels": [
{
"transactionKey": "txrd_a01kaas54cp9q14jhr6twmpq9ms",
"cancelReason": "상품 또는 옵션 변경",
"taxExemptionAmount": 0,
"canceledAt": "2025-11-18T15:06:41+09:00",
"cancelStatus": "DONE",
"cancelRequestId": null,
"cancelAmount": 7000,
"taxFreeAmount": 0,
"taxAmount": 7000,
"refundableAmount": 5600
}
]
}
2) 동일 계좌에 대한 실패 케이스
- 주문번호: tmeec20251118155814znX88
- 요청
{
"currency": null,
"cancelAmount": 7000,
"cancelReason": "상품 또는 옵션 변경",
"taxFreeAmount": null,
"taxExemptionAmount": 0,
"cancelRequestId": null,
"taxAmount": null,
"refundableAmount": null,
"refundReceiveAccount": {
"bank": "하나",
"accountNumber": "287**8607",
"holderName": "이광섭"
}
}
- 응답
{
"code": "INVALID_REFUND_ACCOUNT_NUMBER",
"message": "잘못된 환불 계좌번호입니다."
}
24 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(문제가 발생한 이미지나 전체 결제흐름 동영상을 첨부해주시면 빠른 분석을 받으실 수 있습니다.)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
은행을 "하나둘"로 보내셨는데 올바른 은행코드를 입력해주세요.
은행코드와 환불받을 계좌번호를 정상값으로 보내주시면 처리될거에요.
1. 테스트를 위해 은행을 "하나둘"로도, "하나"로도 보냈는데 둘 다 오류가 나 문의드렸습니다.
2. 다른 은행으로 진행해도 동일합니다
A) "X-TossPayments-Trace-Id": "89aa7aabe44debb0da1e14559928f57e"
{
"currency": null,
"cancelAmount": 7000,
"cancelReason": "상품 또는 옵션 변경",
"taxFreeAmount": null,
"taxExemptionAmount": 0,
"cancelRequestId": null,
"taxAmount": null,
"refundableAmount": null,
"refundReceiveAccount": {
"bank": "토스",
"accountNumber": "1002484",
"holderName": "이광섭"
},
"isDividedPayment": false,
"refundMid": null
}
- 응답
{
"code": "INVALID_REFUND_ACCOUNT_NUMBER",
"message": "잘못된 환불 계좌번호입니다."
}
B) "X-TossPayments-Trace-Id": "418dbf6a7d11de31c2dfdbe624463e36"
{
"currency": null,
"cancelAmount": 100,
"cancelReason": "상품 또는 옵션 변경",
"taxFreeAmount": null,
"taxExemptionAmount": 0,
"cancelRequestId": null,
"taxAmount": null,
"refundableAmount": null,
"refundReceiveAccount": {
"bank": "12",
"accountNumber": "525**4548",
"holderName": "전낙원"
},
"isDividedPayment": false,
"refundMid": null
}
- 응답
{
"code": "INVALID_REFUND_ACCOUNT_NUMBER",
"message": "잘못된 환불 계좌번호입니다."
}
확인해보니 샌드박스 환경에 이슈가 있어서 에러 응답된 것입니다.
내부 확인 후 답변드릴게요.
혹시 해당 문제 아직 미해결 상태일까요?
네 아직입니다.
@Kwangsub Lee 다시 해보시겠어요?
@박수습 동작하는 것 같습니다! 혹시 이상 있다면 다시 말씀드리겠습니다.
감사합니다
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
관련 문제인지는 모르겠으나 토스 테스트 결제 내역에서 가상계좌 "입금처리" 클릭 시 "승인되었습니다" 토스트는 뜨나 실제 입금이 되지 않고 있습니다.
주문번호 알려주세요
"BIGC-1763529740-98749" 입니다
"BIGC-1763530732-98750" 도 확인 부탁드립니다.
입금처리는 어디서 하셨어요?
토스 페이먼츠>개발자 센터>테스트 결제내역 에서 진행하였습니다
혹시 하나은행말고 다른은행으로 한번해보실래요?
아 아닙니다 확인해보고 안내드릴게요
네 다른 은행 케이스 진행 후 경과 공유드릴까요?
BIGC-1763531270-98751 입금은행 국민은행 테스트 입금 처리 동작합니다
국민은행으로는 동작했나요?
네 방금 국민은행으로 진행했더니 입금 완료로 동작했습니다
네 이슈는 확읺배록에ㅛ
귀사 테스트 계정으로 테스트 거래 1건만 올려도 될가요?
네 알겠습니다
현재 테스트 환경에서 계좌번호 검증이 동작하는지 확인 가능할까요?
의도적으로 틀린 예금주명과 계좌번호를 입력했는데 성공이 되었습니다.
- 주문번호 tmeec202511191459264YCo0
- "X-TossPayments-Trace-Id": "6bdc1221cf765db5506ce30a3cb75d04"
- 요청 바디
{
"currency": null,
"cancelAmount": 9000,
"cancelReason": "상품 또는 옵션 변경",
"taxFreeAmount": null,
"taxExemptionAmount": 0,
"cancelRequestId": null,
"taxAmount": null,
"refundableAmount": null,
"refundReceiveAccount": {
"bank": "토스",
"accountNumber": "100**8400", // 정상 계좌번호는 ""100**84" 입니다
"holderName": "이광섭섭" // 정상 예금주명은 "이광섭 입니다"
},
"isDividedPayment": false,
"refundMid": null
}
- 응답
{
"status": "PARTIAL_CANCELED",
"requestedAt": "2025-11-19T14:59:26+09:00",
"approvedAt": "2025-11-19T15:01:14+09:00",
"virtualAccount": {
"accountNumber": "X5909014388665",
"accountType": "일반",
"bank": "국민",
"bankCode": "06",
"customerName": "스티븐",
"dueDate": "2025-11-21T14:59:25+09:00",
"expired": true,
"settlementStatus": "INCOMPLETED",
"refundStatus": "PENDING",
"refundReceiveAccount": {
"bankCode": "81",
"accountNumber": "28791031368607",
"holderName": "이광섭"
},
"depositorName": "테스트"
},
// ....
"cancels": [
{
"transactionKey": "txrd_a01kadbd2mdspwwtyy2z5xz5xqm",
"cancelReason": "상품 또는 옵션 변경",
"taxExemptionAmount": 0,
"canceledAt": "2025-11-19T15:04:04+09:00",
"receiptKey": null,
"cancelStatus": "DONE",
"cancelRequestId": null,
"cancelAmount": 9000,
"taxFreeAmount": 0,
"taxAmount": 9000,
"refundableAmount": 3600
}
],
"type": "NORMAL",
"easyPay": null,
"easyPayAmount": 0,
"easyPayDiscountAmount": 0,
"isPartialCancelable": true,
"receipt": {
"url": "https://dashboard-sandbox.tosspayments.com/receipt/payment-detail/bank-transfer?transactionId=tmeec202511191459264YCo0&ref=PX"
},
"checkout": {
"url": "https://api.tosspayments.com/v1/payments/tmeec202511191459264YCo0/checkout"
},
}
테스트환경은 검증안합니다.
그럼 어제 검증 관런 응답을 받은건 어떤 상황이었을까요?
CASE A)
"X-TossPayments-Trace-Id": "b036e11720ca69420929bda16a453cdc"
- 요청
{
"currency": null,
"cancelAmount": 7000,
"cancelReason": "상품 또는 옵션 변경",
"taxFreeAmount": null,
"taxExemptionAmount": 0,
"cancelRequestId": null,
"taxAmount": null,
"refundableAmount": null,
"refundReceiveAccount": {
"bank": "92",
"accountNumber": "100*2484",
"holderName": "이광섭"
},
"isDividedPayment": false,
"refundMid": null
}
- 응답
{
"code": "INVALID_REFUND_ACCOUNT_NUMBER",
"message": "잘못된 환불 계좌번호입니다."
}
// 방금 전 테스트 입니다
CASE B)
"X-TossPayments-Trace-Id": "0751cc7f8803a53da8081651843a893e"
- 요청
{
"currency": null,
"cancelAmount": 9000,
"cancelReason": "상품 또는 옵션 변경",
"taxFreeAmount": null,
"taxExemptionAmount": 0,
"cancelRequestId": null,
"taxAmount": null,
"refundableAmount": null,
"refundReceiveAccount": {
"bank": "토스",
"accountNumber": "--",
"holderName": "이광섭섭"
},
"isDividedPayment": false,
"refundMid": null
}
- 응답
{
"code": "INVALID_REFUND_ACCOUNT_NUMBER",
"message": "잘못된 환불 계좌번호입니다."
}
어제 테스트환경에 잠시 이슈가 있어서 그랬습니다.
네 그렇다면 오류 관련 테스트는 라이브에서 진행하도록 하겠습니다. 감사합니다