정산 API Response 및 테스트 데이터 문의
안녕하세요 정산 API(/v1/settlements) 사용과 관련하여 두 가지 사항에 대해 문의드립니다.
1. 정산 API 응답에서 하나의 결제건에 대해 결제 승인 이후 24시간 이내 환불이 이루어진 경우 해당 결제건이 amount > 0인 승인 기록과 amount < 0인 환불 기록으로 각각 별도의 정산 항목으로 응답에 포함되는지 알고 싶습니다.
2. 테스트용 Secret Key를 사용한 환경에서는 /v1/settlements API를 호출해도 빈 배열이 반환됩니다.
테스트 환경에서도 정산 API의 실제 응답 구조를 확인할 수 있는 방법이 있는지 혹은 테스트 데이터를 통해 응답을 모의로 확인할 수 있는 방법이 있는지 궁금합니다.
11 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
2번 먼저 답변을 드리면, 테스트 환경에서는 실제 정산 배치가 돌지 않기때문에, 데이터가 나가지 않고 모의로 확인할 수도 없습니다.
감사합니다
1번은 영업일에 답변드릴 수 있을 것 같네요.
조금만 기다려 주셔요
1. 은 결제발생 24시간은 PG 와 무관합니다
결제발생 당일로 이해하시는게 맞구요, 정산에는 결제, 결제취소내역 모두 포함됩니다
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
답변 감사드립니다.
추가적으로 카드결제의 경우 결제 취소에 대한 수수료가 없는 것으로 알고 있습니다. 반면 가상계좌의 경우 고객센터에서 "또한 가상계좌 취소 건에 대해서 원거래 수수료는 반환 되지 않는 점 참고 부탁드려요." 라고 안내되어 있습니다.
1. 가상계좌의 수수료가 건당 400원으로 알고 있는데요. 400원을 제외하고 취소된다는 의미 맞나요?
2. 정산 API는 카드 결제 뿐만 아니라 가상계좌도 포함되어 Response 되는거 맞나요?
1. 취소는 전액 됩니다. 가맹점이 수수료를 부담하시는 거에요.
2. 네 맞습니다.
답변 감사합니다.
코어 API 의 정산 조회 Response의 예시 중 하나를 보면 아래와 같이 결제 승인과 cancel이 같이 들어오는 경우가 있습니다.
결제를 취소한 경우 항상 결제 승인 정보와 결제 취소 정보(cancel 객체)가 동일한 객체에서 같이 전달되나요?
...
"approvedAt": "2023-11-25T13:03:39+09:00",
"soldDate": "2023-11-25",
"paidOutDate": "2023-11-30",
"card": {
"issuerCode": "11",
"acquirerCode": "11",
"number": "55704251**800*",
"installmentPlanMonths": 3,
"isInterestFree": true,
"interestPayer": "CARD_COMPANY",
"approveNo": "30024234",
"useCardPoint": false,
"cardType": "신용",
"ownerType": "개인",
"acquireStatus": "READY",
"amount": 99800
},
....
"cancel": { "transactionKey": "497BF239847238947B0491D84B4", "cancelReason": "주문취소", "taxExemptionAmount": 0, "canceledAt": "2023-11-25T13:40:03+09:00", "transferDiscountAmount": 0, "easyPayDiscountAmount": 0, "receiptKey": null, "cancelAmount": 99800, "taxFreeAmount": 0, "refundableAmount": 0, "cancelStatus": "DONE", "cancelRequestId": null }, "amount": -99800, "interestFee": 0, "fee": -2250, "supplyAmount": -2045, "vat": -205, "payOutAmount": -97550 },
"cancel": { "transactionKey": "497BF239847238947B0491D84B4", "cancelReason": "주문취소", "taxExemptionAmount": 0, "canceledAt": "2023-11-25T13:40:03+09:00", "transferDiscountAmount": 0, "easyPayDiscountAmount": 0, "receiptKey": null, "cancelAmount": 99800, "taxFreeAmount": 0, "refundableAmount": 0, "cancelStatus": "DONE", "cancelRequestId": null }, "amount": -99800, "interestFee": 0, "fee": -2250, "supplyAmount": -2045, "vat": -205, "payOutAmount": -97550 },
네 맞습니다.
감사합니다🙇♂️