Skip to main content
구매자가 선택한 결제 수단에 대한 confirmation_token으로 온세션 결제를 생성하거나, 기존 멤버의 저장된 결제 수단으로 오프세션 결제를 생성하세요. Payments API를 사용하여 구매자에게 청구하고, 결제 목록을 조회하고 결제를 조회하며, 환불, 무효화, 캡처 또는 재시도할 수 있습니다. 수금은 백그라운드에서 실행되므로 생성 응답이 결과는 아닙니다. 결제가 어디까지 진행되었는지, 그리고 requires_action 상태인 동안 구매자가 다음에 해야 할 일(리디렉션 따라가기, 3D Secure 완료, 송금 안내 표시, 은행 계좌 연결)을 확인하려면 상태 조회를 폴링하세요. 구매자가 돌아오기 전까지 결제의 return_url을 업데이트하여 이후 도착할 위치를 변경할 수 있습니다.

엔드포인트

속성

string
필수
결제 ID로, 접두사는 pay_입니다.
string | null
필수
결제를 받은 계정으로, 접두사는 biz_입니다.
object | null
필수
계정이 갖게 되는 금액으로, 총액에서 Whop 수수료를 뺀 값입니다. 구매자로서 결제를 조회하는 경우 null입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
이 결제에 대해 구매자에게 청구되는 금액으로, 구매자가 결제하는 통화 기준의 총액에 구매자 수수료를 더한 값입니다. 환불로 줄어들지 않으며, 환불액은 presentment_refunded_amount에 같은 통화로 표시됩니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string | null
필수
먼저 무효화되지 않는 한 Whop이 이 승인된 카드 결제를 자동으로 캡처할 시점으로, ISO 8601 타임스탬프입니다. 자동 캡처가 요청되지 않은 경우 null입니다.
boolean
필수
Whop이 결제를 자동으로 환불한 경우(예: 분쟁 알림 시) true입니다.
object | null
필수
구매자가 입력한 청구 주소이며, 없으면 null입니다.

속성

string | null
필수
도시입니다.
string | null
필수
ISO 3166-1 alpha-2 국가 코드입니다.
string | null
필수
첫 번째 도로명 주소 줄입니다.
string | null
필수
두 번째 도로명 주소 줄입니다.
string | null
필수
주소에 기재된 이름입니다.
string | null
필수
우편번호 또는 ZIP 코드입니다.
string | null
필수
주, 도 또는 지역입니다.
string | null
필수
청구가 생성된 이유로, 첫 구매, 갱신, 일회성 결제 또는 수동 청구입니다.
string | null
필수
먼저 캡처되지 않을 경우 이 승인된 카드 결제의 보류가 만료되는 시점으로, ISO 8601 타임스탬프입니다. 결제가 나중에 캡처하도록 생성되지 않은 경우 null입니다.
string | null
필수
구매자가 결제에 사용한 체크아웃 구성으로, 접두사는 ch_이며 없으면 null입니다.
string | null
필수
구매자가 체크아웃을 연 웹사이트의 스킴과 호스트로, 예를 들어 https://store.example.com입니다. 한 계정에서 서로 다른 웹사이트의 결제를 구분하는 데 사용하세요. 구매자 없이 이루어진 결제를 포함하여 웹사이트가 기록되지 않은 경우 null입니다.
string | null
필수
이 결제를 생성한 체크아웃 경험으로, 예를 들어 계정 자체 웹사이트의 체크아웃은 embedded_checkout, 구독 갱신은 off_session입니다. 체크아웃이 기록되지 않은 경우 null입니다.사용 가능한 옵션: hosted_checkout, embedded_checkout, custom_checkout, modal_checkout, in_app_checkout, mobile_checkout, off_session, card_present
string | null
필수
구매자 측 화면이 이 결제를 폴링하고, 반환 URL을 설정하고, 은행이 고객에게 인증을 요청했을 때 결제를 재개하는 데 제시하는 자격 증명입니다. 확인 토큰으로 생성되었거나 해당 인증을 기다리는 결제에만 존재하며, 구매자로서 결제를 조회하는 경우 null이고, 목록 응답에서는 항상 null입니다. 값을 얻으려면 결제를 조회하세요.
string
필수
결제가 생성된 시점으로, ISO 8601 타임스탬프입니다.
string
필수
결제가 정산되는 통화로, 소문자 ISO 4217 코드입니다. 아래의 모든 금액 필드는 달리 명시되지 않는 한 이 통화로 표시됩니다.사용 가능한 옵션: usd, sgd, inr, aud, brl, cad, dkk, eur, nok, gbp, sek, chf, hkd, huf, jpy, mxn, myr, pln, czk, nzd, aed, eth, ape, cop, ron, thb, bgn, idr, dop, php, try, krw, twd, vnd, pkr, clp, uyu, ars, zar, dzd, tnd, mad, kes, kwd, jod, all, xcd, amd, bsd, bhd, bob, bam, khr, crc, xof, egp, etb, gmd, ghs, gtq, gyd, ils, jmd, mop, mga, mur, mdl, mnt, nad, ngn, mkd, omr, pyg, pen, qar, rwf, sar, rsd, lkr, tzs, ttd, uzs, rub, btc, cny, usdt, kzt, awg, whop_usd, xau, hnl
string | null
필수
구매자의 이메일 주소입니다. 계정에 대한 member:email:read가 없거나 구매자에게 지정된 이메일이 없는 경우 null입니다.
string | null
필수
수집된 경우, 구매자가 체크아웃 시 제공한 전화번호입니다.
string | null
필수
가장 최근 실패한 시도의 정규화된 거절 사유이며, 없으면 null입니다.
string | null
필수
카드 발급사가 이 결제에 분쟁이 제기될 것이라고 경고한 시점이며, 없으면 null입니다.
string | null
필수
이 결제에 대한 가장 최근 분쟁이 시작된 시점으로, ISO 8601 타임스탬프입니다. 결제에 분쟁이 제기된 적이 없거나 payment:dispute:read 권한이 없는 경우 null입니다.
string | null
필수
가장 최근 시도가 실패한 이유를 쉬운 말로 설명한 것이며, 없으면 null입니다.
number | null
필수
할부 결제 수단의 경우, 청구가 나뉘는 결제 횟수입니다.
object[]
필수
이 결제에 대한 활성 보류입니다. 각 보류에는 settlement_time_at과 별개인 자체 해제 날짜가 있습니다. 보류된 금액이 없거나 구매자로서 결제를 조회하는 경우 비어 있으며, 해제된 보류는 생략됩니다.

속성

object
필수
보류 통화 기준으로 현재 보류된 금액입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
number | null
필수
보류가 생성될 때 기록된 예비금 비율로, 예를 들어 3.5%는 3.5입니다. 다른 보류 유형이거나 비율이 기록되지 않은 경우 null입니다.
string | null
필수
보류된 자금이 사용 가능해질 예정인 시점으로, ISO 8601 타임스탬프입니다. 결제의 정산일보다 빠르지 않습니다. 해제가 날짜가 아니라 배송 해결과 같은 이벤트에 따라 달라지는 경우 null입니다.
string
필수
자금이 보류된 이유로, reserve, bnpl, sequra, fraud_hold 또는 preshipment_hold입니다.사용 가능한 옵션: reserve, bnpl, sequra, fraud_hold, preshipment_hold
string | null
필수
체크아웃 시 구매자의 IP 주소로, Whop의 사기 심사에서 식별한 주소이며, 그렇지 않으면 체크아웃 시 Whop이 구매자의 브라우저에서 수집한 주소입니다. 구독 갱신이나 구매자 없이 이루어진 청구처럼 구매자가 체크아웃에 참여하지 않은 경우, 또는 구매자로서 결제를 조회하는 경우 null입니다.
string | null
필수
가장 최근 청구 시도가 실행된 시점이며, 없으면 null입니다.
object[]
필수
이 결제가 청구한 모든 항목으로, 구매 순서대로 구매 통화 기준의 수량과 소계가 포함됩니다. 항목 스냅샷이 기록되기 전에 이루어진 결제는 변형에서 유추한 단일 항목을 반환합니다. 항목이나 변형을 확인할 수 없는 경우 비어 있습니다.

속성

string | null
필수
항목 ID로, 접두사는 li_입니다. 결제가 항목 스냅샷 이전에 이루어져 항목을 결제의 변형에서 읽는 경우 null입니다.
string | null
필수
체크아웃에 표시된 항목 이름(상품 제목, 없으면 변형 제목)입니다.
string | null
필수
변형이 속한 상품으로, 접두사는 prod_입니다. 항목 스냅샷 이전의 결제에서는 변형의 상품으로 대체되므로, 상위 객체의 product_id가 null인 경우에도 설정될 수 있습니다. 상품이 없는 변형의 경우 null입니다.
string | null
필수
상품의 현재 제목이며, 항목에 상품이 없는 경우 null입니다.
number
필수
구매한 수량입니다.
string | null
필수
판매자가 설정한 자유 텍스트인 변형의 재고 관리 단위(SKU)입니다(예: TSHIRT-LARGE-BLUE). 청구 사유 SKU 접미사가 활성화된 계정은 청구가 발생한 이유가 표시된 값을 받습니다. 첫 구독 청구는 -S, 갱신은 -R, 일회성 구매는 -C, 결제 자체의 메타데이터에 upsell: true가 있으면 -U, 청구된 금액이 없으면 -F입니다. 다른 청구 사유는 접미사 없는 SKU를 가집니다. 변형에 SKU가 없거나 삭제된 경우 null입니다.
object | null
필수
할인, 세금, 수수료 적용 전 이 항목의 전체 수량에 대해 기록된 금액으로, 구매 통화 기준입니다. 기록된 항목 금액이 없으면 null을 반환합니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string | null
필수
구매한 변형으로, 접두사는 plan_입니다. 이후 변형이 삭제된 경우 null입니다.
string | null
필수
변형의 현재 제목이며, 변형이 삭제되었거나 제목이 없는 경우 null입니다.
string | null
필수
계정에 있는 구매자의 멤버 레코드로, 접두사는 mber_입니다. 본인이 구매자가 아닌 한 member:basic:read 권한이 없으면 null입니다.
string | null
필수
이 결제가 청구되는 멤버십으로, 접두사는 mem_입니다. 일회성 구매이거나, 본인이 구매자가 아닌 경우 member:basic:read 권한이 없으면 null입니다.
object | null
필수
결제 생성 시 첨부한 자체 키-값 데이터입니다. 구매자로서 결제를 조회하는 경우 null입니다.
boolean | null
필수
배송 주소가 있고, 배송이 없으며, 전액 환불되지 않은 결제 완료 건인 경우 true입니다. shipment:basic:read 권한이 없으면 null입니다.
boolean | null
필수
주문이 배송될 때까지 자금이 보류되며 아직 추적 번호가 추가되지 않은 경우 true입니다. shipment:basic:read 권한이 없으면 null입니다.
string | null
필수
다음 자동 재시도가 예약된 시점이며, 없으면 null입니다.
string | null
필수
돈이 수금된 시점이며, 아직 수금되지 않은 경우 null입니다.
object | null
필수
표시용으로 구성된 결제 수단 정보로, 구매자에게 보이는 이름, 표준 아이콘 세트, 그리고 카드인 경우 카드 브랜드, 마지막 네 자리, 발급사 식별 번호, 계정이 해당 카드에 사용하는 네트워크 거래 ID가 포함됩니다. 구매자로서 결제를 조회하는 경우 네트워크 거래 ID는 null입니다.

속성

object | null
필수
카드, Apple Pay, Google Pay 결제에만 해당합니다. 카드의 네트워크, 마지막 네 자리, 발급사 식별 번호, 만료일, 네트워크 거래 ID입니다.

속성

string | null
필수
네트워크 식별자(visa, amex, …)로, card.networks 항목 및 저장된 카드 결제 수단과 일치합니다. 볼트에 네트워크가 기록되지 않은 경우 null입니다.
number | null
필수
카드의 만료 월(1~12)입니다. 볼트에 기록되지 않은 경우 null입니다.
number | null
필수
카드의 네 자리 만료 연도입니다. 볼트에 기록되지 않은 경우 null입니다.
string | null
필수
BIN이라고도 하는 발급사 식별 번호로, 발급 은행을 식별하는 카드의 앞 6자리 또는 8자리입니다. 프로세서가 보고하지 않은 경우 null입니다.
string | null
필수
수집된 경우, 카드의 마지막 네 자리입니다.
string | null
필수
이 계정이 해당 카드에 사용하는 네트워크 거래 ID입니다. Whop이 보유한 경우 해당 카드에 대한 첫 고객 대면 청구 또는 인증에서 얻은 이 계정 자체의 ID입니다. 그렇지 않으면 이 카드의 이전 네트워크 거래 ID로, 다른 계정의 거래에서 왔거나 카드와 함께 가져온 것일 수 있습니다. 이 계정에서 이후 이 카드에 대해 가맹점이 시작하는 청구를 할 때 이전 거래로 인용하세요. 값이 생길 때까지 null입니다. 결제가 처음 기록될 때 전송되는 웹훅에는 null이 포함될 수 있으므로, 값을 읽으려면 결제를 조회하세요.
string
필수
구매자에게 보이는 결제 수단 이름으로, 카드가 확인된 경우 “Visa •••• 4242”, 그렇지 않으면 결제 수단 자체의 이름(“Klarna”)입니다.
object
필수
표준 아이콘 세트로, 정사각형과 카드 모양이 각각 라이트 및 다크 색상으로 제공됩니다.

속성

object
필수
신용카드 비율의 타일(48x30)입니다.

속성

object
필수
어두운 배경용 색상입니다.

속성

string
필수
모양의 기본 크기로 제공되는 래스터 대체 이미지입니다.
string
필수
2배 밀도의 래스터 대체 이미지입니다.
string
필수
4배 밀도의 래스터 대체 이미지입니다.
string
필수
벡터 파일입니다. SVG가 렌더링되는 모든 곳에서 이 파일을 우선 사용하세요.
object
필수
밝은 배경용 색상입니다.

속성

string
필수
모양의 기본 크기로 제공되는 래스터 대체 이미지입니다.
string
필수
2배 밀도의 래스터 대체 이미지입니다.
string
필수
4배 밀도의 래스터 대체 이미지입니다.
string
필수
벡터 파일입니다. SVG가 렌더링되는 모든 곳에서 이 파일을 우선 사용하세요.
object
필수
정사각형 타일(32x32)입니다.

속성

object
필수
어두운 배경용 색상입니다.

속성

string
필수
모양의 기본 크기로 제공되는 래스터 대체 이미지입니다.
string
필수
2배 밀도의 래스터 대체 이미지입니다.
string
필수
4배 밀도의 래스터 대체 이미지입니다.
string
필수
벡터 파일입니다. SVG가 렌더링되는 모든 곳에서 이 파일을 우선 사용하세요.
object
필수
밝은 배경용 색상입니다.

속성

string
필수
모양의 기본 크기로 제공되는 래스터 대체 이미지입니다.
string
필수
2배 밀도의 래스터 대체 이미지입니다.
string
필수
4배 밀도의 래스터 대체 이미지입니다.
string
필수
벡터 파일입니다. SVG가 렌더링되는 모든 곳에서 이 파일을 우선 사용하세요.
number | null
필수
할부 결제 수단에만 해당합니다. 청구가 나뉘는 결제 횟수입니다. 문구가 아닌 데이터이므로 클라이언트 측에서 레이블을 구성하고 번역하세요.
string
필수
결제 수단 유형 식별자로, 예를 들어 card, klarna, apple_pay입니다.
string | null
필수
청구된 저장된 결제 수단으로, 접두사는 payt_입니다. 결제 수단이 저장되지 않은 경우 null입니다.
string | null
필수
사용된 결제 수단의 종류로, 예를 들어 card, apple_pay, klarna 또는 us_bank_account입니다.
object[]
필수
이 결제를 결정한 계정 자체의 결제 규칙으로, 규칙이 실행될 때 기록됩니다. 결제당 하나의 동작만 수행되므로, 일치했지만 건너뛰었거나 우선순위에서 밀린 규칙은 나열되지 않습니다. 결정한 규칙이 없거나, 계정에 규칙이 없거나, 규칙이 실행되기 전에 Whop이 결제를 차단했거나, 구매자로서 결제를 조회하는 경우 비어 있습니다.

속성

string
필수
결제 규칙 ID로, 접두사는 prule_입니다.
string
필수
규칙이 요청한 동작입니다.사용 가능한 옵션: allow, block, review, enforce_3ds
string | null
필수
일치했을 당시의 규칙 이름입니다. 이후 규칙 이름을 변경해도 이 값은 다시 작성되지 않습니다.
number
필수
이 결제에서 실패한 청구 시도 횟수입니다.
object | null
필수
지금까지 환불된 금액으로, 구매자에게 표시된 통화 기준입니다. 환불된 금액이 없으면 0입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object | null
필수
징수된 판매세 또는 VAT로, 구매자에게 표시된 통화 기준입니다. 세금이 적용되지 않은 경우 null입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object | null
필수
정산 통화로 환전되기 전, 구매자에게 표시된 통화 기준의 계정 측 총액입니다. 구매자 수수료는 제외됩니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string | null
필수
변형이 속한 상품으로, 접두사는 prod_입니다. 상품이 없는 변형의 경우 null입니다.
string | null
필수
체크아웃 시 적용된 프로모션 코드로, 접두사는 promo_이며 없으면 null입니다.
string | null
필수
이 결제가 청구한 결제 견적으로, 접두사는 pq_입니다. 구매, 프로모션 코드, tax_amount는 견적의 값입니다. 결제에 견적이 지정되지 않아 청구 시점에 세금이 계산된 경우 null입니다.
string | null
필수
은행이 챌린지를 요청한 오프세션 청구(구독 갱신 또는 저장된 카드 결제)에 대해 구매자가 로그인하여 3D Secure를 완료할 수 있는 Whop 호스팅 URL입니다. 복구를 사용할 수 없거나, member:basic:read가 없거나, 목록 응답인 경우 null입니다. 값을 얻으려면 결제를 조회하세요.
boolean
필수
결제가 paid 상태이고, 아직 전액 환불되지 않았으며, 프로세서가 환불을 지원하는 경우 true입니다.
object | null
필수
지금까지 정산 기준으로 환불된 금액입니다. 환불은 결제 당시의 원래 환율이 아니라 각 환불이 발행된 시점의 환율로 환산됩니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string | null
필수
결제가 환불된 시점이며, 없으면 null입니다.
string | null
필수
계정의 응답을 기다리는 분쟁 또는 Resolution Center 사례에 대한 가장 이른 응답 기한으로, ISO 8601 타임스탬프입니다. 응답을 기다리는 건이 없거나 해당 분쟁 또는 사례를 읽을 권한이 없는 경우 null입니다.
boolean
필수
POST /payments/\{id}/retry로 결제를 수동 재시도할 수 있는 경우 true입니다. 결제는 open 상태여야 하며 인보이스 결제 링크를 통해 결제된 것이 아니어야 합니다. 멤버십은 active, trialing 또는 past_due 상태이거나, 결제가 drafted 멤버십의 실패한 첫 결제여야 합니다. 1회의 수동 재시도를 이미 사용하지 않았어야 합니다. 계정이 현재 결제를 받을 수 없는 경우 재시도가 여전히 거부될 수 있습니다.
number | null
필수
적용된 결정 하한선을 포함하여 0(최저)부터 100(최고)까지의 Whop 공개 위험 지수입니다. 사기 확률이 아닙니다. 사용할 수 있는 점수가 없거나 구매자로서 결제를 조회하는 경우 null입니다.
object | null
필수
지원 중단됨. 위험 점수 설명은 더 이상 제공되지 않으며, 항상 null입니다. DEPRECATED: 위험 점수 설명은 더 이상 제공되지 않습니다. 항상 null입니다.
string | null
필수
holds에 나열되지 않은 부분이 계정의 사용 가능 잔액에 반영되는 시점으로, UTC 자정입니다. 이를 처리하는 정산이 반영될 때 financial_activity.funds_available 웹훅의 posted_at에도 같은 값이 포함됩니다. 결제가 완료될 때까지 또는 구매자로서 결제를 조회하는 경우 null이며, 목록 응답에서는 항상 null입니다. 값을 얻으려면 결제를 조회하세요.
string | null
필수
이 결제를 이행하는 배송으로, 접두사는 ship_입니다. 배송할 것이 없거나 shipment:basic:read 권한이 없는 경우 null입니다.
object | null
필수
실물 상품의 배송 주소이며, 없으면 null입니다.

속성

string | null
필수
도시입니다.
string | null
필수
ISO 3166-1 alpha-2 국가 코드입니다.
string | null
필수
첫 번째 도로명 주소 줄입니다.
string | null
필수
두 번째 도로명 주소 줄입니다.
string | null
필수
주소에 기재된 이름입니다.
string | null
필수
우편번호 또는 ZIP 코드입니다.
string | null
필수
주, 도 또는 지역입니다.
string
필수
청구의 수명 주기 상태입니다. 수금이 진행 중이면 open, 돈이 이동하면 paid, 정산 레일이 처리 중이면 pending, 수금 없이 종료되면 void/uncollectible입니다.사용 가능한 옵션: draft, open, authorized, paid, pending, uncollectible, unresolved, void
string
필수
환불, 분쟁, Resolution Center 사례를 반영한 대시보드의 더 세분화된 결제 상태입니다.사용 가능한 옵션: succeeded, requires_capture, pending, failed, blocked, past_due, canceled, price_too_low, uncollectible, refunded, auto_refunded, partially_refunded, dispute_warning, dispute_needs_response, dispute_warning_needs_response, resolution_needs_response, dispute_under_review, dispute_warning_under_review, resolution_under_review, dispute_won, dispute_warning_closed, resolution_won, dispute_lost, dispute_closed, resolution_lost, drafted, incomplete, unresolved, open_dispute, open_resolution
object | null
필수
할인, 세금, 수수료 적용 전 가격입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object | null
필수
징수된 판매세 또는 VAT입니다. 세금이 적용되지 않은 경우 null입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string | null
필수
tax_amount가 가격에 별도로 추가되었는지(exclusive) 이미 포함되어 있었는지(inclusive) 여부입니다.
object
필수
지금까지 구매자에게 반환된 징수 세금액입니다. 결제에 세금이 없었거나 환불된 금액이 없으면 0입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
boolean
필수
구매자가 이 결제에 대해 3D Secure를 완료한 경우 true입니다.
object | null
필수
계정 측 총액으로, 할인 후 가격에 별도로 추가된 세금을 더한 값입니다. 구매자가 이 금액에 더해 지불하는 구매자 수수료는 제외되므로, 반드시 구매자의 명세서에 표시되는 금액과 같지는 않습니다. 구매자에게 청구되는 금액은 amount_charged입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string
필수
결제가 마지막으로 변경된 시점으로, ISO 8601 타임스탬프입니다.
object | null
필수
여러 통화에 걸친 보고를 위해 청구 시점에 USD로 환산한 총액입니다. 계정이 갖지 않는 적응형 가격 책정 환전 마크업은 제외됩니다. 구매자로서 결제를 조회하는 경우 null입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object | null
필수
구매자입니다. 구매자가 사용자가 아닌 계정인 경우 null입니다.

속성

string
필수
사용자 ID로, 접두사는 user_입니다.
string | null
필수
표시 이름입니다.
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
string
필수
공개 사용자 이름입니다.
string | null
필수
체크아웃 시 구매자 브라우저의 사용자 에이전트입니다. 구독 갱신처럼 구매자가 체크아웃에 참여하지 않았거나 member:basic:read 권한이 없는 경우 null입니다.
string | null
필수
청구된 변형으로, 접두사는 plan_입니다.
object | null
필수
주소 확인 서비스(AVS), 카드 소유자 이름, 카드 확인 값(CVV/CVC) 결과이며, 프로세서가 결과를 반환하지 않았거나 구매자로서 결제를 조회하는 경우 null입니다.

속성

string | null
필수
청구 도로명 주소에 대한 주소 확인 서비스(AVS) 결과입니다.
string | null
필수
카드 네트워크를 통해 이 청구를 추적하는 매입사 참조 번호(ARN)이며, 프로세서가 반환하지 않은 경우 null입니다.
string | null
필수
이 청구에 대한 카드 발급사의 승인 코드이며, 프로세서가 반환하지 않은 경우 null입니다.
string | null
필수
카드 소유자 이름이 발급사 기록과 일치했는지 여부입니다.
string | null
필수
카드 확인 값(CVV/CVC) 결과입니다.
string | null
필수
청구 우편번호에 대한 주소 확인 서비스(AVS) 결과입니다.
boolean
필수
결제를 무효화하거나 취소할 수 있는 경우 true입니다. 결제가 더 이상 대상이 아니면 요청이 거부됩니다. POST /payments/\{id}/void를 참고하세요.
string | null
필수
체크아웃 시 구매자 브라우저에 대한 Whop 픽셀의 방문자 ID로, 접두사는 wuid_입니다. 체크아웃 페이지에 Whop 픽셀이 없었거나, 구매자가 체크아웃에 참여하지 않았거나, member:basic:read 권한이 없는 경우 null입니다.
Payment