> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Payment

> 결제(Payment)는 완료되었거나 시도된 청구를 나타냅니다. 결제는 금액, 상태, 통화, 사용된 결제 수단을 추적합니다.

> [!NOTE]
>
> 이 리소스에는 [Whop API](https://docs.whop.com/ko/api-reference/payments/retrieve-payment-status.md)의 후속 리소스가 있습니다. 이 페이지는 계속 완전히 지원됩니다.

```json Example theme={null}
{
	"amount_after_fees": 6.9,
	"application_fee": {
		"amount": 6.9,
		"amount_captured": 6.9,
		"amount_refunded": 6.9,
		"created_at": "2023-12-01T05:00:00.401Z",
		"currency": "usd",
		"id": "apfee_xxxxxxxxxxxx"
	},
	"auto_refunded": true,
	"billing_address": {
		"city": "<string>",
		"country": "<string>",
		"line1": "<string>",
		"line2": "<string>",
		"name": "<string>",
		"postal_code": "<string>",
		"state": "<string>"
	},
	"billing_reason": "subscription_create",
	"card_brand": "mastercard",
	"card_exp_month": 6,
	"card_exp_year": 2027,
	"card_last4": "4242",
	"checkout_configuration_id": "ch_xxxxxxxxxxxxxxx",
	"company": {
		"id": "biz_xxxxxxxxxxxxxx",
		"route": "<string>",
		"title": "<string>"
	},
	"created_at": "2023-12-01T05:00:00.401Z",
	"currency": "usd",
	"customer_phone": "<string>",
	"decline_code": "insufficient_funds",
	"dispute_alerted_at": "2023-12-01T05:00:00.401Z",
	"disputes": [
		{
			"amount": 6.9,
			"currency": "usd",
			"editable": true,
			"id": "dspt_xxxxxxxxxxxxx",
			"needs_response_by": "2023-12-01T05:00:00.401Z",
			"notes": "Customer used the product for 3 months before disputing.",
			"reason": "Product Not Received",
			"status": "warning_needs_response"
		}
	],
	"failure_message": "<string>",
	"fees": [
		{
			"amount": 6.9,
			"currency": "usd",
			"name": "<string>",
			"type": "payment_processing_percentage_fee"
		}
	],
	"financing_installments_count": 42,
	"financing_transactions": [
		{
			"amount": 6.9,
			"created_at": "2023-12-01T05:00:00.401Z",
			"id": "ptx_xxxxxxxxxxxxxx",
			"status": "succeeded",
			"transaction_type": "purchase"
		}
	],
	"id": "pay_xxxxxxxxxxxxxx",
	"last_payment_attempt": "2023-12-01T05:00:00.401Z",
	"member": {
		"id": "<string>",
		"phone": "<string>"
	},
	"membership": {
		"id": "mem_xxxxxxxxxxxxxx",
		"phone_number": "<string>",
		"status": "trialing"
	},
	"metadata": {},
	"needs_tracking": true,
	"next_payment_attempt": "2023-12-01T05:00:00.401Z",
	"paid_at": "2023-12-01T05:00:00.401Z",
	"payment_instrument": {
		"card": {
			"brand": "<string>",
			"last4": "<string>"
		},
		"display_name": "<string>",
		"icons": {
			"card": {
				"dark": {
					"png_1x": "<string>",
					"png_2x": "<string>",
					"png_4x": "<string>",
					"svg": "<string>"
				},
				"light": {
					"png_1x": "<string>",
					"png_2x": "<string>",
					"png_4x": "<string>",
					"svg": "<string>"
				}
			},
			"square": {
				"dark": {
					"png_1x": "<string>",
					"png_2x": "<string>",
					"png_4x": "<string>",
					"svg": "<string>"
				},
				"light": {
					"png_1x": "<string>",
					"png_2x": "<string>",
					"png_4x": "<string>",
					"svg": "<string>"
				}
			}
		},
		"installment_count": 42,
		"payment_method_type": "<string>"
	},
	"payment_method": {
		"card": {
			"brand": "mastercard",
			"exp_month": 42,
			"exp_year": 42,
			"fingerprint": "<string>",
			"last4": "4242"
		},
		"created_at": "2023-12-01T05:00:00.401Z",
		"id": "payt_xxxxxxxxxxxxx",
		"payment_method_type": "acss_debit"
	},
	"payment_method_type": "acss_debit",
	"payments_failed": 42,
	"plan": {
		"id": "plan_xxxxxxxxxxxxx",
		"internal_notes": "<string>",
		"metadata": {}
	},
	"product": {
		"id": "prod_xxxxxxxxxxxxx",
		"metadata": {},
		"route": "pickaxe-analytics",
		"title": "Pickaxe Analytics"
	},
	"promo_code": {
		"amount_off": 6.9,
		"base_currency": "usd",
		"code": "<string>",
		"id": "promo_xxxxxxxxxxxx",
		"number_of_intervals": 42,
		"promo_type": "percentage"
	},
	"recovery_url": "<string>",
	"refundable": true,
	"refunded_amount": 6.9,
	"refunded_at": "2023-12-01T05:00:00.401Z",
	"refunds": [
		{
			"amount": 6.9,
			"created_at": "2023-12-01T05:00:00.401Z",
			"currency": "usd",
			"id": "rf_xxxxxxxxxxxxxxx",
			"status": "pending"
		}
	],
	"resolutions": [
		{
			"customer_appealed": true,
			"customer_response_actions": ["respond"],
			"due_date": "2023-12-01T05:00:00.401Z",
			"id": "reso_xxxxxxxxxxxxx",
			"issue": "forgot_to_cancel",
			"merchant_appealed": true,
			"merchant_response_actions": ["accept"],
			"platform_response_actions": ["request_buyer_info"],
			"status": "merchant_response_needed"
		}
	],
	"retryable": true,
	"risk_score": 42,
	"risk_signals": {},
	"settlement_amount": 6.9,
	"settlement_currency": "usd",
	"settlement_exchange_rate": 6.9,
	"settlement_time_at": "2023-12-01T05:00:00.401Z",
	"shipment": {
		"carrier": "usps",
		"id": "ship_xxxxxxxxxxxxx",
		"status": "unknown",
		"tracking_number": "9400111899223456789012",
		"tracking_url": "https://track.aftership.com/9400111899223456789012"
	},
	"shipping_address": {
		"city": "<string>",
		"country": "<string>",
		"line1": "<string>",
		"line2": "<string>",
		"name": "<string>",
		"postal_code": "<string>",
		"state": "<string>"
	},
	"sku": "<string>",
	"status": "draft",
	"substatus": "succeeded",
	"subtotal": 6.9,
	"tax_amount": 6.9,
	"tax_behavior": "exclusive",
	"tax_refunded_amount": 6.9,
	"three_ds_verified": true,
	"total": 6.9,
	"updated_at": "2023-12-01T05:00:00.401Z",
	"usd_total": 6.9,
	"user": {
		"email": "john.doe@example.com",
		"id": "user_xxxxxxxxxxxxx",
		"name": "John Doe",
		"username": "johndoe42"
	},
	"verification_checks": {
		"address_line1": "<string>",
		"authorization_code": "<string>",
		"card_holder_name": "<string>",
		"card_security_code": "<string>",
		"zip_code": "<string>"
	},
	"voidable": true
}
```

**amount\_after\_fees** `number` *required*

수수료를 제외한 결제 금액입니다

예시: `6.9`

**application\_fee** `object | null` *required*

이 결제에 부과된 애플리케이션 수수료입니다.

**하위 속성**

**amount** `number` *required*

애플리케이션 수수료 금액입니다.

예시: `6.9`

**amount\_captured** `number` *required*

캡처된 애플리케이션 수수료 금액입니다.

예시: `6.9`

**amount\_refunded** `number` *required*

환불된 애플리케이션 수수료 금액입니다.

예시: `6.9`

**created\_at** `string\<date-time\>` *required*

애플리케이션 수수료가 생성된 일시입니다.

예시: `2023-12-01T05:00:00.401Z`

**currency** `Currencies` *required*

애플리케이션 수수료의 통화입니다.

사용 가능한 옵션: `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`

**id** `string` *required*

애플리케이션 수수료의 고유 식별자입니다.

예시: `apfee_xxxxxxxxxxxx`

**auto\_refunded** `boolean` *required*

이 결제가 자동 환불되었는지 여부입니다

**billing\_address** `object | null` *required*

결제한 사용자의 주소입니다.

**하위 속성**

**city** `string | null` *required*

주소의 도시입니다.

**country** `string | null` *required*

주소의 국가입니다.

**line1** `string | null` *required*

주소의 첫 번째 줄입니다.

**line2** `string | null` *required*

주소의 두 번째 줄입니다.

**name** `string | null` *required*

고객의 이름입니다.

**postal\_code** `string | null` *required*

주소의 우편번호입니다.

**state** `string | null` *required*

주소의 주(州)입니다.

**billing\_reason** `BillingReasons | null` *required*

이 청구가 생성된 기계 판독 가능한 사유로, 최초 구독 구매, 갱신 주기, 일회성 결제 등이 있습니다.

사용 가능한 옵션: `subscription_create`, `subscription_cycle`, `subscription_update`, `one_time`, `manual`, `subscription`

**card\_brand** `CardBrands | null` *required*

처리업체가 보고한 카드 네트워크입니다(예: 'visa', 'mastercard', 'amex'). 결제 수단 유형이 'card'인 경우에만 표시됩니다.

사용 가능한 옵션: `mastercard`, `visa`, `amex`, `discover`, `unionpay`, `jcb`, `diners`, `link`, `troy`, `visadankort`, `visabancontact`, `china_union_pay`, `rupay`, `jcbrupay`, `elo`, `maestro`, `tarjeta_naranja`, `cirrus`, `nspk_mir`, `verve`, `ebt`, `private_label`, `local_brand`, `uatp`, `wexcard`, `uzcard`, `meeza`, `hrg_store_card`, `girocard`, `fuel_card`, `dankort`, `carnet`, `atm_card`, `china_union_payuzcard`, `codensa`, `cabal`, `hipercard`, `jcblankapay`, `cmi`, `aura`, `accel`, `culiance`, `nyce`, `pulse`, `star`, `eftpos`, `alelo`, `edenred`, `sodexo`, `unknown`

**card\_exp\_month** `integer | null` *required*

이 결제에 사용된 카드의 만료 월(1-12)입니다. 저장된 카드가 없는 실패한 결제의 경우 거절된 카드의 값으로 대체됩니다. 카드로 결제하지 않았거나 만료일을 확인할 수 없는 경우 Null입니다.

예시: `6`

**card\_exp\_year** `integer | null` *required*

이 결제에 사용된 카드의 네 자리 만료 연도입니다. 저장된 카드가 없는 실패한 결제의 경우 거절된 카드의 값으로 대체됩니다. 카드로 결제하지 않았거나 만료일을 확인할 수 없는 경우 Null입니다.

예시: `2027`

**card\_last4** `string | null` *required*

이 결제에 사용된 카드의 마지막 네 자리입니다. 카드로 결제하지 않은 경우 Null입니다.

예시: `4242`

**checkout\_configuration\_id** `string | null` *required*

이 결제를 생성한 체크아웃 세션/구성의 ID입니다(있는 경우). 결제를 해당 결제를 생성한 체크아웃 구성에 매핑할 때 사용합니다.

예시: `ch_xxxxxxxxxxxxxxx`

**company** `object | null` *required*

결제의 회사입니다.

**하위 속성**

**id** `string` *required*

회사의 고유 식별자입니다.

예시: `biz_xxxxxxxxxxxxxx`

**route** `string` *required*

Whop 사이트에서 회사의 슬러그/경로입니다.

**title** `string` *required*

회사의 표기 이름입니다.

**created\_at** `string\<date-time\>` *required*

결제가 생성된 일시입니다.

예시: `2023-12-01T05:00:00.401Z`

**currency** `Currencies` *required*

이 결제의 세 자리 ISO 통화 코드입니다(예: 'usd', 'eur').

사용 가능한 옵션: `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`

**customer\_phone** `string | null` *required*

고객이 체크아웃 시 입력한 전화번호, 또는 체크아웃에서 전화번호 인증을 요구하는 경우 인증된 전화번호입니다. 전화번호를 수집하지 않은 경우 `null`입니다.

**decline\_code** `PaymentDeclineCodes | null` *required*

결제가 거절된 사유입니다. 결제가 실패하지 않은 경우 Null입니다.

사용 가능한 옵션: `insufficient_funds`, `lost_card`, `stolen_card`, `expired_card`, `suspected_fraud`, `invalid_card_number`, `invalid_cvc`, `invalid_cvc_or_expiration`, `incorrect_pin`, `authentication_required`, `card_not_supported`, `currency_not_supported`, `duplicate_transaction`, `generic_decline`, `invalid_account`, `invalid_amount`, `processing_error`, `restricted_card`, `card_velocity_exceeded`, `contact_issuer`, `card_declined_by_issuer`, `bank_declined`, `regulatory_blocked`, `transaction_not_permitted`, `transaction_stopped`, `card_type_not_supported`, `issuer_not_found`, `closed_account`, `issuer_unavailable`, `invalid_zip`, `invalid_expiry_month`, `invalid_expiry_year`, `invalid_expiry`, `invalid_transaction`, `cannot_authorize`, `pin_required`, `pin_try_exceeded`, `provider_declined`, `high_risk`, `test_mode_decline`, `merchant_blacklist`, `reenter_transaction`, `invalid_pin`, `pin_required_as`, `withdrawal_count_limit_exceeded`, `invalid_country`, `issuer_error`, `invalid_card_holder_name`, `no_accounts`, `transaction_cancelled`, `three_d_secure_success`, `three_d_secure_canceled`, `three_d_secure_invalid_card_number`, `three_d_secure_generic_error`, `three_d_secure_timeout`, `three_d_secure_failed`, `three_d_secure_card_not_enrolled`, `three_d_secure_fraud`, `three_d_secure_too_many_attempts`, `three_d_secure_rejected_by_bank`, `three_d_secure_reported_lost_or_stolen`, `blocked_by_cardholder`, `test_mode_test_card`, `try_again_later`, `transaction_not_allowed`, `bank_insufficient_funds`, `bank_account_not_found`, `bank_account_closed`, `bank_account_frozen`, `bank_invalid_routing_number`, `bank_non_transaction_account`, `bank_authorization_revoked`, `bank_payment_stopped`, `bank_not_authorized`, `bank_account_holder_deceased`, `bank_duplicate`, `bank_amount_error`, `bank_regulatory_blocked`, `bank_details_invalid`, `bank_processing_error`, `bank_generic_decline`, `sepa_invalid_iban`, `sepa_no_mandate`, `sepa_mandate_data_invalid`, `sepa_disputed`, `sepa_refused_by_customer`, `sepa_generic_decline`

**dispute\_alerted\_at** `string\<date-time\> | null` *required*

이 거래에 분쟁이 제기될 것이라는 알림이 들어온 시점입니다

예시: `2023-12-01T05:00:00.401Z`

**disputes** `array\<object\> | null` *required*

이 결제에 연결된 분쟁입니다. 컨텍스트의 행위자에게 payment:dispute:read 권한이 없는 경우 Null입니다.

**하위 속성**

**amount** `number` *required*

지정된 통화로 표시된 분쟁 금액이며, 소수로 형식화됩니다.

예시: `6.9`

**currency** `Currencies` *required*

분쟁 금액의 세 자리 ISO 통화 코드입니다.

사용 가능한 옵션: `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`

**editable** `boolean | null` *required*

분쟁 증빙 자료를 아직 편집하고 제출할 수 있는지 여부입니다.

**id** `string` *required*

분쟁의 고유 식별자입니다.

예시: `dspt_xxxxxxxxxxxxx`

**needs\_response\_by** `string\<date-time\> | null` *required*

분쟁 증빙 자료를 제출해야 하는 기한입니다. 응답 기한이 설정되지 않은 경우 Null입니다.

예시: `2023-12-01T05:00:00.401Z`

**notes** `string | null` *required*

회사가 분쟁 증빙 자료의 일부로 제출한 추가 자유 형식 메모입니다.

예시: `Customer used the product for 3 months before disputing.`

**reason** `string | null` *required*

사람이 읽을 수 있는 분쟁 사유입니다.

예시: `Product Not Received`

**status** `DisputeStatuses` *required*

분쟁 수명 주기의 현재 상태로, needs\_response, under\_review, won, lost 등이 있습니다.

사용 가능한 옵션: `warning_needs_response`, `warning_under_review`, `warning_closed`, `needs_response`, `under_review`, `won`, `lost`, `closed`, `other`

**failure\_message** `string | null` *required*

결제가 실패한 경우 실패 사유입니다.

**fees** `array\<object\>` *required*

이 특정 결제와 관련된 수수료입니다.

**하위 속성**

**amount** `number` *required*

수수료로 표시할 값 또는 금액입니다.

예시: `6.9`

**currency** `Currencies` *required*

수수료의 통화입니다.

사용 가능한 옵션: `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`

**name** `string` *required*

수수료로 표시할 레이블입니다.

**type** `SpecificFeeOrigins` *required*

수수료의 구체적인 발생원입니다(해당하는 경우).

사용 가능한 옵션: `stripe_domestic_processing_fee`, `stripe_international_processing_fee`, `stripe_fixed_processing_fee`, `stripe_billing_fee`, `stripe_radar_fee`, `sales_tax_remittance`, `sales_tax_remittance_reversal`, `stripe_sales_tax_fee`, `whop_processing_fee`, `marketplace_affiliate_fee`, `affiliate_fee`, `crypto_fee`, `stripe_standard_processing_fee`, `paypal_fee`, `stripe_payout_fee`, `dispute_fee`, `dispute_alert_fee`, `dispute_representment_fee`, `apple_processing_fee`, `buyer_fee`, `sezzle_processing_fee`, `splitit_processing_fee`, `platform_balance_processing_fee`, `payment_processing_percentage_fee`, `payment_processing_fixed_fee`, `cross_border_percentage_fee`, `fx_percentage_fee`, `orchestration_percentage_fee`, `three_ds_fixed_fee`, `billing_percentage_fee`, `revshare_percentage_fee`, `application_fee`, `high_risk_merchant_fee`, `economic_intelligence_percentage_fee`, `payment_return_fee`

예시: `payment_processing_percentage_fee`

**financing\_installments\_count** `integer | null` *required*

결제의 할부 분할 횟수입니다. 결제가 할부 결제(예: Splitit, Klarna 등)인 경우 표시됩니다.

예시: `42`

**financing\_transactions** `array\<object\>` *required*

이 결제에 연결된 할부 거래입니다. 결제가 할부 결제(예: Splitit, Klarna 등)인 경우 표시됩니다.

**하위 속성**

**amount** `number` *required*

결제 거래의 금액입니다.

예시: `6.9`

**created\_at** `string\<date-time\>` *required*

결제 거래가 생성된 날짜와 시간입니다.

예시: `2023-12-01T05:00:00.401Z`

**id** `string` *required*

결제 거래의 고유 식별자입니다.

예시: `ptx_xxxxxxxxxxxxxx`

**status** `PaymentTransactionStatuses` *required*

결제 거래의 상태입니다.

사용 가능한 옵션: `succeeded`, `declined`, `error`, `pending`, `created`, `expired`, `won`, `rejected`, `lost`, `prevented`, `canceled`

**transaction\_type** `PaymentTransactionTypes` *required*

결제 거래의 유형입니다.

사용 가능한 옵션: `purchase`, `authorize`, `capture`, `refund`, `canceled`, `verify`, `chargeback`, `pre_chargeback`, `three_d_secure`, `fraud_screening`, `authorization`, `installment`, `deposit`

**id** `string` *required*

결제의 고유 식별자입니다.

예시: `pay_xxxxxxxxxxxxxx`

**last\_payment\_attempt** `string\<date-time\> | null` *required*

마지막 결제 시도 시간입니다.

예시: `2023-12-01T05:00:00.401Z`

**member** `object | null` *required*

이 결제에 연결된 멤버입니다.

**하위 속성**

**id** `string` *required*

회사 멤버의 고유 식별자입니다.

**phone** `string | null` *required*

멤버의 전화번호입니다(있는 경우).

**membership** `object | null` *required*

이 결제에 연결된 멤버십입니다.

**하위 속성**

**id** `string` *required*

멤버십의 고유 식별자입니다.

예시: `mem_xxxxxxxxxxxxxx`

**phone\_number** `string | null` *required*

이 멤버십과 연결된 전화번호입니다.

**status** `MembershipStatus` *required*

멤버십의 상태입니다.

사용 가능한 옵션: `trialing`, `active`, `past_due`, `completed`, `canceled`, `expired`, `unresolved`, `drafted`, `canceling`

**metadata** `object | null` *required*

이 결제에 저장된 사용자 지정 메타데이터입니다. 이 결제가 이루어진 체크아웃 구성으로 복사됩니다

**needs\_tracking** `boolean | null` *required*

이 결제가 주문이 배송되고 아직 추적 번호가 없는 동안 자금을 보류하고 있는지 여부입니다.

**next\_payment\_attempt** `string\<date-time\> | null` *required*

다음 예약된 결제 재시도 시간입니다.

예시: `2023-12-01T05:00:00.401Z`

**paid\_at** `string\<date-time\> | null` *required*

이 결제가 성공적으로 수금된 시간입니다. 결제가 아직 성공하지 않은 경우 Null입니다. Unix 타임스탬프입니다.

예시: `2023-12-01T05:00:00.401Z`

**payment\_instrument** `object | null` *required*

이 결제에 사용된 결제 수단으로, 표시용으로 구성되어 있습니다: 결제 수단 유형, 구매자에게 표시되는 이름, 표준 아이콘 세트, 그리고 카드인 경우 카드 정보입니다. 영수증에 결제 수단이 명시되지 않은 경우 Null입니다.

**하위 속성**

**card** `object | null` *required*

카드 결제 전용: 카드의 네트워크와 마지막 네 자리입니다.

**하위 속성**

**brand** `string` *required*

네트워크 식별자(`visa`, `amex`, …)로, `card.networks` 항목 및 저장된 카드 결제 수단과 일치합니다.

**last4** `string | null` *required*

카드의 마지막 네 자리입니다(캡처된 경우).

**display\_name** `string` *required*

구매자에게 표시되는 결제 수단 이름입니다. 카드 정보가 확인된 경우 "Visa •••• 4242", 그렇지 않으면 결제 수단 자체의 이름("Klarna")입니다.

**icons** `object` *required*

표준 아이콘 세트: 정사각형 및 카드 모양이 있으며, 각각 라이트 및 다크 색상 버전으로 제공됩니다.

**하위 속성**

**card** `object` *required*

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

**하위 속성**

**dark** `object` *required*

어두운 배경용 색상 버전입니다.

**하위 속성**

**png\_1x** `string` *required*

모양의 기본 크기로 된 래스터 대체 이미지입니다.

**png\_2x** `string` *required*

2배 밀도의 래스터 대체 이미지입니다.

**png\_4x** `string` *required*

4배 밀도의 래스터 대체 이미지입니다.

**svg** `string` *required*

벡터 파일입니다. SVG가 렌더링되는 모든 곳에서 이 파일을 우선 사용하세요.

**light** `object` *required*

밝은 배경용 색상 버전입니다.

**하위 속성**

**png\_1x** `string` *required*

모양의 기본 크기로 된 래스터 대체 이미지입니다.

**png\_2x** `string` *required*

2배 밀도의 래스터 대체 이미지입니다.

**png\_4x** `string` *required*

4배 밀도의 래스터 대체 이미지입니다.

**svg** `string` *required*

벡터 파일입니다. SVG가 렌더링되는 모든 곳에서 이 파일을 우선 사용하세요.

**square** `object` *required*

정사각형 타일(32x32)입니다.

**하위 속성**

**dark** `object` *required*

어두운 배경용 색상 버전입니다.

**하위 속성**

**png\_1x** `string` *required*

모양의 기본 크기로 된 래스터 대체 이미지입니다.

**png\_2x** `string` *required*

2배 밀도의 래스터 대체 이미지입니다.

**png\_4x** `string` *required*

4배 밀도의 래스터 대체 이미지입니다.

**svg** `string` *required*

벡터 파일입니다. SVG가 렌더링되는 모든 곳에서 이 파일을 우선 사용하세요.

**light** `object` *required*

밝은 배경용 색상 버전입니다.

**하위 속성**

**png\_1x** `string` *required*

모양의 기본 크기로 된 래스터 대체 이미지입니다.

**png\_2x** `string` *required*

2배 밀도의 래스터 대체 이미지입니다.

**png\_4x** `string` *required*

4배 밀도의 래스터 대체 이미지입니다.

**svg** `string` *required*

벡터 파일입니다. SVG가 렌더링되는 모든 곳에서 이 파일을 우선 사용하세요.

**installment\_count** `integer | null` *required*

할부 결제 수단 전용: 청구가 분할되는 결제 횟수입니다. 표시 문구가 아닌 데이터이므로, 레이블은 클라이언트 측에서 구성하고 번역하세요.

예시: `42`

**payment\_method\_type** `string` *required*

결제 수단 유형 식별자입니다(예: `card`, `klarna`, `apple_pay`).

**payment\_method** `object | null` *required*

이 결제에 사용된 토큰화된 결제 수단 참조입니다. 토큰이 사용되지 않은 경우 Null입니다.

**하위 속성**

**card** `object | null` *required*

결제 수단이 직불 카드 또는 신용카드인 경우 해당 카드 데이터입니다.

**하위 속성**

**brand** `CardBrands | null` *required*

카드 네트워크입니다(예: visa, mastercard, amex). 브랜드를 확인할 수 없는 경우 Null입니다.

사용 가능한 옵션: `mastercard`, `visa`, `amex`, `discover`, `unionpay`, `jcb`, `diners`, `link`, `troy`, `visadankort`, `visabancontact`, `china_union_pay`, `rupay`, `jcbrupay`, `elo`, `maestro`, `tarjeta_naranja`, `cirrus`, `nspk_mir`, `verve`, `ebt`, `private_label`, `local_brand`, `uatp`, `wexcard`, `uzcard`, `meeza`, `hrg_store_card`, `girocard`, `fuel_card`, `dankort`, `carnet`, `atm_card`, `china_union_payuzcard`, `codensa`, `cabal`, `hipercard`, `jcblankapay`, `cmi`, `aura`, `accel`, `culiance`, `nyce`, `pulse`, `star`, `eftpos`, `alelo`, `edenred`, `sodexo`, `unknown`

**exp\_month** `integer | null` *required*

카드의 두 자리 만료 월(1-12)입니다. 사용할 수 없는 경우 Null입니다.

예시: `42`

**exp\_year** `integer | null` *required*

카드의 두 자리 만료 연도입니다(예: 2027년의 경우 27). 사용할 수 없는 경우 Null입니다.

예시: `42`

**fingerprint** `string | null` *required*

기본 카드의 안정적인 식별자입니다. 핑거프린트가 같은 두 결제 수단은 동일한 카드입니다. 사용할 수 없는 경우 Null입니다.

**last4** `string | null` *required*

카드 번호의 마지막 네 자리입니다. 사용할 수 없는 경우 Null입니다.

예시: `4242`

**created\_at** `string\<date-time\>` *required*

결제 토큰이 생성된 일시입니다.

예시: `2023-12-01T05:00:00.401Z`

**id** `string` *required*

결제 토큰의 고유 식별자입니다.

예시: `payt_xxxxxxxxxxxxx`

**payment\_method\_type** `PaymentMethodTypes` *required*

결제 수단의 결제 수단 유형입니다

사용 가능한 옵션: `acss_debit`, `addi`, `affirm`, `afterpay_clearpay`, `alipay`, `alipayhk`, `alma`, `amazon_pay`, `apple`, `apple_pay`, `au_bank_transfer`, `au_becs_debit`, `bacs_debit`, `bancolombia`, `bancontact`, `bank_wire`, `billie`, `blik`, `boleto`, `bre_b`, `ca_bank_transfer`, `capchase_pay`, `card`, `card_present`, `card_installments_three`, `card_installments_six`, `card_installments_twelve`, `cashapp`, `claritypay`, `coinbase`, `crypto`, `crypto_subscription`, `custom`, `customer_balance`, `demo_pay`, `duitnow_qr`, `efecty`, `eps`, `eu_bank_transfer`, `fpx`, `flex_pay`, `gb_bank_transfer`, `gcash`, `giropay`, `google_pay`, `gopay`, `grabpay`, `id_bank_transfer`, `ideal`, `interac`, `international_bank_wire`, `kakao_pay`, `klarna`, `klarna_pay_now`, `konbini`, `kr_card`, `kr_market`, `kriya`, `kueski`, `link`, `mb_way`, `m_pesa`, `mercado_pago`, `mercado_pago_ar`, `mercado_pago_mx`, `mobilepay`, `modo`, `mondu`, `multibanco`, `naver_pay`, `nequi`, `netbanking`, `ng_bank`, `ng_bank_transfer`, `ng_card`, `ng_market`, `ng_ussd`, `ng_wallet`, `nupay`, `nz_bank_account`, `oney`, `oney_3x`, `oney_4x`, `opay`, `oxxo`, `p24`, `pago_efectivo`, `pse`, `pay_by_bank`, `payco`, `paynow`, `paypal`, `paypal_express`, `paypay`, `payto`, `payto_email`, `payto_phone`, `payto_bank_account`, `pix`, `pix_automatico`, `platform_balance`, `promptpay`, `qris`, `rapipago`, `rechnung`, `revolut_pay`, `samsung_pay`, `satispay`, `scalapay`, `sencillito`, `sepa_debit`, `sequra`, `servipag`, `sezzle`, `shop_pay`, `shopeepay`, `sofort`, `south_korea_market`, `spei`, `splitit`, `sunbit`, `swish`, `tabby`, `tamara`, `touch_n_go`, `twint`, `upi`, `us_bank_account`, `us_bank_transfer`, `venmo`, `verve`, `vipps`, `webpay`, `wechat_pay`, `whop_pay`, `yape`, `zip`, `coinflow`, `unknown`

**payment\_method\_type** `PaymentMethodTypes | null` *required*

이 결제에 사용된 결제 수단의 유형입니다(예: card, Cash App, iDEAL, Klarna, crypto). 처리업체가 유형을 제공하지 않는 경우 Null입니다.

사용 가능한 옵션: `acss_debit`, `addi`, `affirm`, `afterpay_clearpay`, `alipay`, `alipayhk`, `alma`, `amazon_pay`, `apple`, `apple_pay`, `au_bank_transfer`, `au_becs_debit`, `bacs_debit`, `bancolombia`, `bancontact`, `bank_wire`, `billie`, `blik`, `boleto`, `bre_b`, `ca_bank_transfer`, `capchase_pay`, `card`, `card_present`, `card_installments_three`, `card_installments_six`, `card_installments_twelve`, `cashapp`, `claritypay`, `coinbase`, `crypto`, `crypto_subscription`, `custom`, `customer_balance`, `demo_pay`, `duitnow_qr`, `efecty`, `eps`, `eu_bank_transfer`, `fpx`, `flex_pay`, `gb_bank_transfer`, `gcash`, `giropay`, `google_pay`, `gopay`, `grabpay`, `id_bank_transfer`, `ideal`, `interac`, `international_bank_wire`, `kakao_pay`, `klarna`, `klarna_pay_now`, `konbini`, `kr_card`, `kr_market`, `kriya`, `kueski`, `link`, `mb_way`, `m_pesa`, `mercado_pago`, `mercado_pago_ar`, `mercado_pago_mx`, `mobilepay`, `modo`, `mondu`, `multibanco`, `naver_pay`, `nequi`, `netbanking`, `ng_bank`, `ng_bank_transfer`, `ng_card`, `ng_market`, `ng_ussd`, `ng_wallet`, `nupay`, `nz_bank_account`, `oney`, `oney_3x`, `oney_4x`, `opay`, `oxxo`, `p24`, `pago_efectivo`, `pse`, `pay_by_bank`, `payco`, `paynow`, `paypal`, `paypal_express`, `paypay`, `payto`, `payto_email`, `payto_phone`, `payto_bank_account`, `pix`, `pix_automatico`, `platform_balance`, `promptpay`, `qris`, `rapipago`, `rechnung`, `revolut_pay`, `samsung_pay`, `satispay`, `scalapay`, `sencillito`, `sepa_debit`, `sequra`, `servipag`, `sezzle`, `shop_pay`, `shopeepay`, `sofort`, `south_korea_market`, `spei`, `splitit`, `sunbit`, `swish`, `tabby`, `tamara`, `touch_n_go`, `twint`, `upi`, `us_bank_account`, `us_bank_transfer`, `venmo`, `verve`, `vipps`, `webpay`, `wechat_pay`, `whop_pay`, `yape`, `zip`, `coinflow`, `unknown`

**payments\_failed** `integer | null` *required*

결제의 실패한 결제 시도 횟수입니다.

예시: `42`

**plan** `object | null` *required*

이 결제에 연결된 플랜입니다.

**하위 속성**

**id** `string` *required*

플랜의 고유 식별자입니다.

예시: `plan_xxxxxxxxxxxxx`

**internal\_notes** `string | null` *required*

비즈니스를 위한 개인 설명 또는 메모 섹션입니다.

**metadata** `object | null` *required*

플랜에 저장된 사용자 지정 키-값 쌍입니다. 결제 및 멤버십 이벤트의 웹훅 페이로드에 포함됩니다. 최대 50개 키, 키당 100자, 문자열 값당 500자입니다. 예약된 키 `custom_cta` 및 `custom_cta_url`이 설정되면 이 플랜에 대한 상품의 체크아웃 행동 유도 문구를 재정의합니다.

**product** `object | null` *required*

이 결제가 이루어진 상품입니다

**하위 속성**

**id** `string` *required*

상품의 고유 식별자입니다.

예시: `prod_xxxxxxxxxxxxx`

**metadata** `object | null` *required*

상품에 저장되어 결제 및 멤버십 웹훅 페이로드에 포함되는 사용자 지정 키-값 쌍입니다. 최대 50개 키, 키당 100자, 문자열 값당 500자입니다.

**route** `string` *required*

상품 공개 링크의 URL 슬러그입니다. 예: whop.com/company/pickaxe-analytics의 `pickaxe-analytics`.

예시: `pickaxe-analytics`

**title** `string` *required*

상품 페이지와 검색 결과에서 고객에게 표시되는 상품의 표시 이름입니다.

예시: `Pickaxe Analytics`

**promo\_code** `object | null` *required*

이 결제에 사용된 프로모션 코드입니다.

**하위 속성**

**amount\_off** `number` *required*

할인 금액입니다. 해석은 promo\_type에 따라 달라집니다: 'percentage'인 경우 백분율(예: 20은 20% 할인)이고, 'flat\_amount'인 경우 할인되는 달러 금액(예: 10.00은 \$10.00 할인)입니다.

예시: `6.9`

**base\_currency** `Currencies` *required*

프로모션 코드의 통화입니다.

사용 가능한 옵션: `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`

**code** `string | null` *required*

체크아웃 시 프로모션을 적용하는 데 사용된 특정 코드입니다.

**id** `string` *required*

프로모션 코드의 고유 식별자입니다.

예시: `promo_xxxxxxxxxxxx`

**number\_of\_intervals** `integer | null` *required*

프로모션이 적용되는 개월 수입니다.

예시: `42`

**promo\_type** `PromoTypes` *required*

프로모션의 유형(% 또는 정액)입니다.

사용 가능한 옵션: `percentage`, `flat_amount`

**recovery\_url** `string | null` *required*

은행이 인증을 요구한 오프 세션 청구(구독 갱신 또는 저장된 카드 결제)에 대해 구매자가 로그인하여 3D Secure를 완료할 수 있는 Whop 호스팅 URL입니다. 복구를 사용할 수 없거나 `member:basic:read` 권한이 없는 경우 `null`입니다.

**refundable** `boolean` *required*

`paid` 상태이고, 전액 환불되지 않았으며, 환불을 허용하는 결제 처리업체가 처리한 결제인 경우에만 true입니다.

**refunded\_amount** `number | null` *required*

결제 환불 금액입니다(해당하는 경우).

예시: `6.9`

**refunded\_at** `string\<date-time\> | null` *required*

결제가 환불된 시점입니다(해당하는 경우).

예시: `2023-12-01T05:00:00.401Z`

**refunds** `array\<object\>` *required*

이 결제에 대해 발행된 환불로, 최신순으로 정렬되며 실패하거나 취소된 환불 시도를 포함합니다. 최근 100개로 제한됩니다.

**하위 속성**

**amount** `number` *required*

지정된 통화로 표시된 환불 금액(소수)입니다. 예: \$10.43 USD의 경우 10.43.

예시: `6.9`

**created\_at** `string\<date-time\>` *required*

환불이 생성된 일시입니다.

예시: `2023-12-01T05:00:00.401Z`

**currency** `Currencies` *required*

환불 금액의 세 자리 ISO 통화 코드입니다.

사용 가능한 옵션: `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`

**id** `string` *required*

환불의 고유 식별자입니다.

예시: `rf_xxxxxxxxxxxxxxx`

**status** `RefundStatuses` *required*

환불의 현재 처리 상태로, pending, succeeded, failed 등이 있습니다.

사용 가능한 옵션: `pending`, `requires_action`, `succeeded`, `failed`, `canceled`

**resolutions** `array\<object\> | null` *required*

이 결제에 대해 고객이 연 해결 센터 케이스입니다. 컨텍스트의 행위자에게 payment:resolution\_center\_case:read 권한이 없는 경우 Null입니다.

**하위 속성**

**customer\_appealed** `boolean` *required*

최초 해결 결정 이후 고객이 이의를 제기했는지 여부입니다.

**customer\_response\_actions** `array\<ResolutionCenterCaseCustomerResponses\>` *required*

현재 고객이 사용할 수 있는 작업 목록입니다.

사용 가능한 옵션: `respond`, `appeal`, `withdraw`

**due\_date** `string\<date-time\> | null` *required*

다음 응답이 필요한 기한입니다. 현재 활성화된 기한이 없는 경우 Null입니다. Unix 타임스탬프입니다.

예시: `2023-12-01T05:00:00.401Z`

**id** `string` *required*

해결 케이스의 고유 식별자입니다.

예시: `reso_xxxxxxxxxxxxx`

**issue** `ResolutionCenterCaseIssueTypes` *required*

분쟁의 카테고리입니다.

사용 가능한 옵션: `forgot_to_cancel`, `item_not_received`, `significantly_not_as_described`, `unauthorized_transaction`, `product_unacceptable`

**merchant\_appealed** `boolean` *required*

최초 해결 결정 이후 판매자가 이의를 제기했는지 여부입니다.

**merchant\_response\_actions** `array\<ResolutionCenterCaseMerchantResponses\>` *required*

현재 판매자가 사용할 수 있는 작업 목록입니다.

사용 가능한 옵션: `accept`, `deny`, `request_more_info`, `appeal`, `respond`

**platform\_response\_actions** `array\<ResolutionCenterCasePlatformResponses\>` *required*

이 해결 케이스를 중재하기 위해 현재 Whop 플랫폼이 사용할 수 있는 작업 목록입니다.

사용 가능한 옵션: `request_buyer_info`, `request_merchant_info`, `merchant_wins`, `merchant_refund`

**status** `ResolutionCenterCaseStatuses` *required*

해결 케이스의 현재 상태로, 어느 당사자가 응답해야 하는지 또는 케이스가 종료되었는지를 나타냅니다.

사용 가능한 옵션: `merchant_response_needed`, `customer_response_needed`, `merchant_info_needed`, `customer_info_needed`, `under_platform_review`, `customer_won`, `merchant_won`, `customer_withdrew`

**retryable** `boolean` *required*

결제가 `open` 상태이고, 처리업체에서 다시 청구할 수 있으며, 멤버십이 `active`, `trialing` 또는 `past_due` 상태이고(또는 `drafted` 멤버십의 실패한 최초 결제이고), 인보이스 링크를 통해 결제되지 않았으며, 1회의 수동 재시도를 아직 사용하지 않은 경우 true입니다. 결제를 수동으로 재시도할 수 있는지 판단하는 데 사용됩니다. 회사가 결제를 받을 수 없는 경우 재시도가 거부될 수 있습니다.

**risk\_score** `integer | null` *required*

이 결제에 대한 Whop 자체 사기 위험 점수로, 0(최저 위험)부터 100(최고 위험)까지입니다. 결제가 점수화되지 않았거나 점수화가 아직 완료되지 않은 경우 Null입니다.

예시: `42`

**risk\_signals** `object | null` *required*

지원 중단되었습니다. 항상 null입니다.

**settlement\_amount** `number` *required*

이 결제에 대해 고객에게 청구된 총액으로, 세금을 포함하고 할인을 적용한 후의 금액입니다. currency 필드에 지정된 통화로 표시됩니다.

예시: `6.9`

**settlement\_currency** `Currencies` *required*

이 결제의 세 자리 ISO 통화 코드입니다(예: 'usd', 'eur').

사용 가능한 옵션: `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`

**settlement\_exchange\_rate** `number | null` *required*

지원 중단되었습니다. 항상 null을 반환합니다.

예시: `6.9`

**settlement\_time\_at** `string\<date-time\> | null` *required*

이 결제의 자금이 회사의 사용 가능 잔액에 반영되는 시점으로, UTC 자정입니다. 결제 시점에 알려지며 절대 변경되지 않습니다. `financial_activity.funds_available` 웹훅의 `posted_at`은 이를 정산하는 결산이 반영될 때 동일한 값을 가집니다. 두 값을 대조하여 이 자금을 이제 출금할 수 있음을 확인하세요.

예시: `2023-12-01T05:00:00.401Z`

**shipment** `object | null` *required*

이 결제에 연결된 배송입니다.

**하위 속성**

**carrier** `string | null` *required*

이 배송에 대해 감지된 배송업체입니다. 추적 업데이트로 확인될 때까지 Null입니다.

예시: `usps`

**id** `string` *required*

배송의 고유 식별자입니다.

예시: `ship_xxxxxxxxxxxxx`

**status** `ShipmentStatuses` *required*

이 배송의 현재 배송 상태입니다.

사용 가능한 옵션: `unknown`, `pre_transit`, `in_transit`, `out_for_delivery`, `delivered`, `available_for_pickup`, `return_to_sender`, `failure`, `cancelled`, `error`

**tracking\_number** `string` *required*

배송 진행 상황을 조회하는 데 사용되는 배송업체 지정 추적 번호입니다.

예시: `9400111899223456789012`

**tracking\_url** `string` *required*

이 배송의 진행 상황을 추적할 수 있는 고객용 URL입니다.

예시: `https://track.aftership.com/9400111899223456789012`

**shipping\_address** `object | null` *required*

실물 상품에 대해 고객이 제공한 배송 주소입니다. 배송 주소를 수집하지 않은 경우 Null입니다.

**하위 속성**

**city** `string | null` *required*

주소의 도시입니다.

**country** `string | null` *required*

주소의 국가입니다.

**line1** `string | null` *required*

주소의 첫 번째 줄입니다.

**line2** `string | null` *required*

주소의 두 번째 줄입니다.

**name** `string | null` *required*

고객의 이름입니다.

**postal\_code** `string | null` *required*

주소의 우편번호입니다.

**state** `string | null` *required*

주소의 주(州)입니다.

**sku** `string | null` *required*

판매자가 설정한, 이 결제에서 청구된 베리언트(장바구니의 경우 첫 번째 항목)의 재고 관리 단위(SKU)입니다. 결제 사유 SKU 접미사가 활성화된 계정은 청구 발생 사유가 표시된 SKU를 받습니다: 첫 구독 청구는 `-S`, 갱신은 `-R`, 일회성 구매는 `-C`, 결제 자체 메타데이터에 `upsell: true`가 있는 경우 `-U`, 아무것도 청구되지 않은 경우 `-F`입니다. 다른 결제 사유는 접미사 없는 SKU를 가집니다. 베리언트에 SKU가 없는 경우 Null입니다.

**status** `ReceiptStatus | null` *required*

이 결제의 현재 수명 주기 상태입니다(예: 'draft', 'open', 'paid', 'void').

사용 가능한 옵션: `draft`, `open`, `authorized`, `paid`, `pending`, `uncollectible`, `unresolved`, `void`

**substatus** `FriendlyReceiptStatus` *required*

결제의 친숙한 상태입니다.

사용 가능한 옵션: `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`

**subtotal** `number | null` *required*

크리에이터에게 표시할 소계입니다(구매자 수수료 제외).

예시: `6.9`

**tax\_amount** `number | null` *required*

계산된 판매세/부가가치세 금액입니다(해당하는 경우).

예시: `6.9`

**tax\_behavior** `ReceiptTaxBehaviors | null` *required*

결제에 적용된 세금 포함 유형으로, 세금이 최종 가격에 포함되는지 또는 추가로 부과되는지를 결정합니다.

사용 가능한 옵션: `exclusive`, `inclusive`, `unspecified`, `unable_to_collect`

**tax\_refunded\_amount** `number | null` *required*

환불된 세금 금액입니다(해당하는 경우).

예시: `6.9`

**three\_ds\_verified** `boolean` *required*

이 결제에 대해 3D Secure 인증이 완료되었는지 여부입니다.

**total** `number | null` *required*

크리에이터에게 표시할 합계입니다(구매자 수수료 제외).

예시: `6.9`

**updated\_at** `string\<date-time\>` *required*

결제가 마지막으로 업데이트된 일시입니다.

예시: `2023-12-01T05:00:00.401Z`

**usd\_total** `number | null` *required*

크리에이터에게 표시할 USD 합계입니다(구매자 수수료 제외).

예시: `6.9`

**user** `object | null` *required*

이 결제를 한 사용자입니다.

**하위 속성**

**email** `string | null` *required*

사용자의 이메일 주소입니다. 접근하려면 member:email:read 권한이 필요합니다. 권한이 없는 경우 Null입니다.

예시: `john.doe@example.com`

**id** `string` *required*

사용자의 고유 식별자입니다.

예시: `user_xxxxxxxxxxxxx`

**name** `string | null` *required*

공개 프로필에 표시되는 사용자의 표시 이름입니다.

예시: `John Doe`

**username** `string` *required*

공개 프로필에 표시되는 사용자의 고유 사용자 이름입니다.

예시: `johndoe42`

**verification\_checks** `object | null` *required*

이 결제에 대한 카드 발급사의 주소 및 카드 보안 코드 확인 결과입니다. 처리업체가 아무것도 반환하지 않은 경우 Null입니다.

**하위 속성**

**address\_line1** `string | null` *required*

고객이 입력한 청구지 도로명 주소가 카드 발급사에 등록된 주소와 일치했는지 여부입니다.

**authorization\_code** `string | null` *required*

이 청구에 대한 카드 발급사의 승인 코드입니다. 처리업체가 반환하지 않은 경우 Null입니다.

**card\_holder\_name** `string | null` *required*

고객이 입력한 카드 소유자 이름이 카드 발급사에 등록된 이름과 일치했는지 여부입니다.

**card\_security\_code** `string | null` *required*

고객이 입력한 CVV / CVC가 카드와 일치했는지 여부입니다.

**zip\_code** `string | null` *required*

고객이 입력한 청구지 우편번호가 카드 발급사에 등록된 우편번호와 일치했는지 여부입니다.

**voidable** `boolean` *required*

결제를 무효화하거나 취소할 수 있는 경우 true입니다. 결제가 더 이상 자격이 없으면 요청이 거부됩니다.


## Related topics

- [Payments](https://docs.whop.com/ko/elements/latest/payments/overview.md)
- [Payments API](https://docs.whop.com/ko/api-reference/payments/payment.md)
- [Retry Payment](https://docs.whop.com/ko/api-reference/payments/retry-payment.md)
