confirmation_token으로 온세션 결제를 생성하거나, 기존 멤버의 저장된 결제 수단으로 오프세션 결제를 생성하세요.
Payments API를 사용하여 구매자에게 청구하고, 결제 목록을 조회하고 결제를 조회하며, 환불, 무효화, 캡처 또는 재시도할 수 있습니다. 수금은 백그라운드에서 실행되므로 생성 응답이 결과는 아닙니다. 결제가 어디까지 진행되었는지, 그리고 requires_action 상태인 동안 구매자가 다음에 해야 할 일(리디렉션 따라가기, 3D Secure 완료, 송금 안내 표시, 은행 계좌 연결)을 확인하려면 상태 조회를 폴링하세요. 구매자가 돌아오기 전까지 결제의 return_url을 업데이트하여 이후 도착할 위치를 변경할 수 있습니다.
엔드포인트
속성
계정이 갖게 되는 금액으로, 총액에서 Whop 수수료를 뺀 값입니다. 구매자로서 결제를 조회하는 경우 null입니다.
속성
속성
이 결제에 대해 구매자에게 청구되는 금액으로, 구매자가 결제하는 통화 기준의 총액에 구매자 수수료를 더한 값입니다. 환불로 줄어들지 않으며, 환불액은
presentment_refunded_amount에 같은 통화로 표시됩니다.속성
속성
먼저 무효화되지 않는 한 Whop이 이 승인된 카드 결제를 자동으로 캡처할 시점으로, ISO 8601 타임스탬프입니다. 자동 캡처가 요청되지 않은 경우 null입니다.
먼저 캡처되지 않을 경우 이 승인된 카드 결제의 보류가 만료되는 시점으로, ISO 8601 타임스탬프입니다. 결제가 나중에 캡처하도록 생성되지 않은 경우 null입니다.
구매자가 체크아웃을 연 웹사이트의 스킴과 호스트로, 예를 들어
https://store.example.com입니다. 한 계정에서 서로 다른 웹사이트의 결제를 구분하는 데 사용하세요. 구매자 없이 이루어진 결제를 포함하여 웹사이트가 기록되지 않은 경우 null입니다.이 결제를 생성한 체크아웃 경험으로, 예를 들어 계정 자체 웹사이트의 체크아웃은
embedded_checkout, 구독 갱신은 off_session입니다. 체크아웃이 기록되지 않은 경우 null입니다.사용 가능한 옵션: hosted_checkout, embedded_checkout, custom_checkout, modal_checkout, in_app_checkout, mobile_checkout, off_session, card_present구매자 측 화면이 이 결제를 폴링하고, 반환 URL을 설정하고, 은행이 고객에게 인증을 요청했을 때 결제를 재개하는 데 제시하는 자격 증명입니다. 확인 토큰으로 생성되었거나 해당 인증을 기다리는 결제에만 존재하며, 구매자로서 결제를 조회하는 경우 null이고, 목록 응답에서는 항상 null입니다. 값을 얻으려면 결제를 조회하세요.
결제가 정산되는 통화로, 소문자 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이 결제에 대한 가장 최근 분쟁이 시작된 시점으로, ISO 8601 타임스탬프입니다. 결제에 분쟁이 제기된 적이 없거나 payment:dispute:read 권한이 없는 경우 null입니다.
이 결제에 대한 활성 보류입니다. 각 보류에는
settlement_time_at과 별개인 자체 해제 날짜가 있습니다. 보류된 금액이 없거나 구매자로서 결제를 조회하는 경우 비어 있으며, 해제된 보류는 생략됩니다.속성
속성
보류 통화 기준으로 현재 보류된 금액입니다.
속성
속성
보류된 자금이 사용 가능해질 예정인 시점으로, ISO 8601 타임스탬프입니다. 결제의 정산일보다 빠르지 않습니다. 해제가 날짜가 아니라 배송 해결과 같은 이벤트에 따라 달라지는 경우 null입니다.
체크아웃 시 구매자의 IP 주소로, Whop의 사기 심사에서 식별한 주소이며, 그렇지 않으면 체크아웃 시 Whop이 구매자의 브라우저에서 수집한 주소입니다. 구독 갱신이나 구매자 없이 이루어진 청구처럼 구매자가 체크아웃에 참여하지 않은 경우, 또는 구매자로서 결제를 조회하는 경우 null입니다.
이 결제가 청구한 모든 항목으로, 구매 순서대로 구매 통화 기준의 수량과 소계가 포함됩니다. 항목 스냅샷이 기록되기 전에 이루어진 결제는 변형에서 유추한 단일 항목을 반환합니다. 항목이나 변형을 확인할 수 없는 경우 비어 있습니다.
속성
속성
변형이 속한 상품으로, 접두사는
prod_입니다. 항목 스냅샷 이전의 결제에서는 변형의 상품으로 대체되므로, 상위 객체의 product_id가 null인 경우에도 설정될 수 있습니다. 상품이 없는 변형의 경우 null입니다.판매자가 설정한 자유 텍스트인 변형의 재고 관리 단위(SKU)입니다(예:
TSHIRT-LARGE-BLUE). 청구 사유 SKU 접미사가 활성화된 계정은 청구가 발생한 이유가 표시된 값을 받습니다. 첫 구독 청구는 -S, 갱신은 -R, 일회성 구매는 -C, 결제 자체의 메타데이터에 upsell: true가 있으면 -U, 청구된 금액이 없으면 -F입니다. 다른 청구 사유는 접미사 없는 SKU를 가집니다. 변형에 SKU가 없거나 삭제된 경우 null입니다.할인, 세금, 수수료 적용 전 이 항목의 전체 수량에 대해 기록된 금액으로, 구매 통화 기준입니다. 기록된 항목 금액이 없으면
null을 반환합니다.속성
속성
이 결제가 청구되는 멤버십으로, 접두사는
mem_입니다. 일회성 구매이거나, 본인이 구매자가 아닌 경우 member:basic:read 권한이 없으면 null입니다.배송 주소가 있고, 배송이 없으며, 전액 환불되지 않은 결제 완료 건인 경우 true입니다. shipment:basic:read 권한이 없으면 null입니다.
주문이 배송될 때까지 자금이 보류되며 아직 추적 번호가 추가되지 않은 경우 true입니다. shipment:basic:read 권한이 없으면 null입니다.
표시용으로 구성된 결제 수단 정보로, 구매자에게 보이는 이름, 표준 아이콘 세트, 그리고 카드인 경우 카드 브랜드, 마지막 네 자리, 발급사 식별 번호, 계정이 해당 카드에 사용하는 네트워크 거래 ID가 포함됩니다. 구매자로서 결제를 조회하는 경우 네트워크 거래 ID는 null입니다.
속성
속성
카드, Apple Pay, Google Pay 결제에만 해당합니다. 카드의 네트워크, 마지막 네 자리, 발급사 식별 번호, 만료일, 네트워크 거래 ID입니다.
속성
속성
네트워크 식별자(
visa, amex, …)로, card.networks 항목 및 저장된 카드 결제 수단과 일치합니다. 볼트에 네트워크가 기록되지 않은 경우 null입니다.이 계정이 해당 카드에 사용하는 네트워크 거래 ID입니다. Whop이 보유한 경우 해당 카드에 대한 첫 고객 대면 청구 또는 인증에서 얻은 이 계정 자체의 ID입니다. 그렇지 않으면 이 카드의 이전 네트워크 거래 ID로, 다른 계정의 거래에서 왔거나 카드와 함께 가져온 것일 수 있습니다. 이 계정에서 이후 이 카드에 대해 가맹점이 시작하는 청구를 할 때 이전 거래로 인용하세요. 값이 생길 때까지 null입니다. 결제가 처음 기록될 때 전송되는 웹훅에는
null이 포함될 수 있으므로, 값을 읽으려면 결제를 조회하세요.표준 아이콘 세트로, 정사각형과 카드 모양이 각각 라이트 및 다크 색상으로 제공됩니다.
속성
속성
신용카드 비율의 타일(48x30)입니다.
속성
속성
정사각형 타일(32x32)입니다.
속성
속성
이 결제를 결정한 계정 자체의 결제 규칙으로, 규칙이 실행될 때 기록됩니다. 결제당 하나의 동작만 수행되므로, 일치했지만 건너뛰었거나 우선순위에서 밀린 규칙은 나열되지 않습니다. 결정한 규칙이 없거나, 계정에 규칙이 없거나, 규칙이 실행되기 전에 Whop이 결제를 차단했거나, 구매자로서 결제를 조회하는 경우 비어 있습니다.
지금까지 환불된 금액으로, 구매자에게 표시된 통화 기준입니다. 환불된 금액이 없으면 0입니다.
속성
속성
징수된 판매세 또는 VAT로, 구매자에게 표시된 통화 기준입니다. 세금이 적용되지 않은 경우 null입니다.
속성
속성
정산 통화로 환전되기 전, 구매자에게 표시된 통화 기준의 계정 측 총액입니다. 구매자 수수료는 제외됩니다.
속성
속성
이 결제가 청구한 결제 견적으로, 접두사는
pq_입니다. 구매, 프로모션 코드, tax_amount는 견적의 값입니다. 결제에 견적이 지정되지 않아 청구 시점에 세금이 계산된 경우 null입니다.은행이 챌린지를 요청한 오프세션 청구(구독 갱신 또는 저장된 카드 결제)에 대해 구매자가 로그인하여 3D Secure를 완료할 수 있는 Whop 호스팅 URL입니다. 복구를 사용할 수 없거나,
member:basic:read가 없거나, 목록 응답인 경우 null입니다. 값을 얻으려면 결제를 조회하세요.지금까지 정산 기준으로 환불된 금액입니다. 환불은 결제 당시의 원래 환율이 아니라 각 환불이 발행된 시점의 환율로 환산됩니다.
속성
속성
계정의 응답을 기다리는 분쟁 또는 Resolution Center 사례에 대한 가장 이른 응답 기한으로, ISO 8601 타임스탬프입니다. 응답을 기다리는 건이 없거나 해당 분쟁 또는 사례를 읽을 권한이 없는 경우 null입니다.
POST /payments/\{id}/retry로 결제를 수동 재시도할 수 있는 경우 true입니다. 결제는 open 상태여야 하며 인보이스 결제 링크를 통해 결제된 것이 아니어야 합니다. 멤버십은 active, trialing 또는 past_due 상태이거나, 결제가 drafted 멤버십의 실패한 첫 결제여야 합니다. 1회의 수동 재시도를 이미 사용하지 않았어야 합니다. 계정이 현재 결제를 받을 수 없는 경우 재시도가 여전히 거부될 수 있습니다.적용된 결정 하한선을 포함하여 0(최저)부터 100(최고)까지의 Whop 공개 위험 지수입니다. 사기 확률이 아닙니다. 사용할 수 있는 점수가 없거나 구매자로서 결제를 조회하는 경우 null입니다.
지원 중단됨. 위험 점수 설명은 더 이상 제공되지 않으며, 항상 null입니다. DEPRECATED: 위험 점수 설명은 더 이상 제공되지 않습니다. 항상 null입니다.
holds에 나열되지 않은 부분이 계정의 사용 가능 잔액에 반영되는 시점으로, UTC 자정입니다. 이를 처리하는 정산이 반영될 때 financial_activity.funds_available 웹훅의 posted_at에도 같은 값이 포함됩니다. 결제가 완료될 때까지 또는 구매자로서 결제를 조회하는 경우 null이며, 목록 응답에서는 항상 null입니다. 값을 얻으려면 결제를 조회하세요.청구의 수명 주기 상태입니다. 수금이 진행 중이면
open, 돈이 이동하면 paid, 정산 레일이 처리 중이면 pending, 수금 없이 종료되면 void/uncollectible입니다.사용 가능한 옵션: draft, open, authorized, paid, pending, uncollectible, unresolved, void환불, 분쟁, 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할인, 세금, 수수료 적용 전 가격입니다.
속성
속성
징수된 판매세 또는 VAT입니다. 세금이 적용되지 않은 경우 null입니다.
속성
속성
지금까지 구매자에게 반환된 징수 세금액입니다. 결제에 세금이 없었거나 환불된 금액이 없으면 0입니다.
속성
속성
계정 측 총액으로, 할인 후 가격에 별도로 추가된 세금을 더한 값입니다. 구매자가 이 금액에 더해 지불하는 구매자 수수료는 제외되므로, 반드시 구매자의 명세서에 표시되는 금액과 같지는 않습니다. 구매자에게 청구되는 금액은
amount_charged입니다.속성
속성
여러 통화에 걸친 보고를 위해 청구 시점에 USD로 환산한 총액입니다. 계정이 갖지 않는 적응형 가격 책정 환전 마크업은 제외됩니다. 구매자로서 결제를 조회하는 경우 null입니다.
속성
속성
체크아웃 시 구매자 브라우저의 사용자 에이전트입니다. 구독 갱신처럼 구매자가 체크아웃에 참여하지 않았거나 member:basic:read 권한이 없는 경우 null입니다.
주소 확인 서비스(AVS), 카드 소유자 이름, 카드 확인 값(CVV/CVC) 결과이며, 프로세서가 결과를 반환하지 않았거나 구매자로서 결제를 조회하는 경우 null입니다.
속성
속성
결제를 무효화하거나 취소할 수 있는 경우 true입니다. 결제가 더 이상 대상이 아니면 요청이 거부됩니다.
POST /payments/\{id}/void를 참고하세요.Payment

