Skip to main content
Refund는 Refund Payment로 발행되는 결제의 전액 또는 부분 환불 한 건입니다. 얼마가 어떤 제공업체를 통해 이동했는지, 그리고 성공했는지를 기록합니다. Refunds API를 사용하면 결제 또는 계정 전체의 환불 목록을 조회하고, 단일 환불을 조회할 수 있습니다.

엔드포인트

속성

string
필수
rf_ 접두사가 붙은 환불 ID입니다.
string | null
필수
환불을 발행한 계정으로, biz_ 접두사가 붙습니다.
object | null
필수
결제의 정산 통화로 정산된 환불 금액으로, 환불 페이지들을 합산하면 결제의 refunded_amount와 상계됩니다. 결제의 원래 환율이 아니라 환불 발행 시점에 적용되던 환율로 환산됩니다. 레거시 다중 통화 결제에 환율이 기록되어 있지 않은 경우에만 null입니다.

속성

string
필수
주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
string
필수
환불이 요청된 시각으로, ISO 8601 타임스탬프입니다.
string | null
필수
환불이 실패한 이유에 대한 판매자용 설명으로, 요청의 언어로 제공됩니다. 환불이 실패하거나 취소된 경우가 아니면 null입니다.
string | null
필수
제공업체 간에 정규화된 환불 실패 사유입니다. 환불이 실패하거나 취소된 경우가 아니면 null입니다.사용 가능한 옵션: bank_declined, expired_or_canceled_card, lost_or_stolen_card, insufficient_funds, charge_disputed, not_refundable, merchant_request, unknown
object | null
필수
환불 요청 시 첨부한 사용자 정의 키-값 데이터입니다.
object
필수
결제 처리업체가 이동한 통화 기준의 환불 금액입니다.

속성

string
필수
주 단위 금액이며, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 갖는 소수 자릿수입니다. 실제 결제가 처리되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 일반적으로 decimals와 같지만, 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 사용자의 로캘에 맞게 숫자를 포맷하세요.
string
필수
이 환불이 되돌리는 결제로, pay_ 접두사가 붙습니다.
string
필수
환불을 처리한 결제 제공업체로, 예를 들어 paypal 또는 coinbase입니다.
string | null
필수
제공업체가 환불을 생성한 시각으로, ISO 8601 타임스탬프입니다.
string | null
필수
기록된 경우, 환불이 발행된 사유입니다.사용 가능한 옵션: duplicate, fraudulent, requested_by_customer, expired_uncaptured_charge, dispute_alert
string | null
필수
이 환불에 대해 은행 네트워크 추적 참조 번호를 사용할 수 있는지 여부입니다.사용 가능한 옵션: available, pending, unavailable
string | null
필수
추적 참조 번호의 종류로, 예를 들어 매입사 참조 번호(acquirer reference number)가 있습니다.사용 가능한 옵션: acquirer_reference_number, retrieval_reference_number, system_trace_audit_number
string | null
필수
구매자의 은행이 환불을 추적하는 데 사용할 수 있는 추적 참조 번호입니다.
string
필수
결제 처리업체에서의 환불 진행 상태로, pending, requires_action, succeeded, failed, canceled 중 하나입니다.사용 가능한 옵션: pending, requires_action, succeeded, failed, canceled
string
필수
환불이 마지막으로 변경된 시각으로, ISO 8601 타임스탬프입니다.
boolean
필수
카드 네트워크가 Rapid Dispute Resolution을 통해 환불을 시작한 경우 true입니다.
Refund