규칙이 작동하는 네 가지 방식
| 작업 | 동작 | 여러 규칙이 일치하는 경우 |
|---|---|---|
block | 승인 전에 결제가 거절됩니다. 구매자에게는 일반적인 거절 메시지가 표시됩니다. | review 및 enforce_3ds보다 우선 |
review | 적격 카드가 매입 없이 승인됩니다. 자동 매입은 승인 후 48시간으로 예약됩니다. 그 전에 매입하거나 무효화할 수 있습니다. 지원되지 않는 결제 수단은 검토를 건너뛰고 일반 결제 처리를 계속합니다. | enforce_3ds보다 우선 |
enforce_3ds | 구매자가 3D Secure를 통해 은행에서 결제를 확인합니다. | 가장 낮은 우선순위 |
allow | 결제가 다른 규칙을 건너뜁니다. Whop의 통제는 절대 건너뛰지 않습니다. | 세 가지 모두보다 우선 |
risk_score, amount_in_usd, card_country, card_bin, customer_email, ip_address를 읽을 수 있습니다. card_bin은 결제에 사용된 카드의 은행 식별 번호(BIN)로, 카드 번호의 처음 여섯 자리입니다. List fields는 각 필드가 허용하는 연산자와 값을 반환합니다.
확실하지 않은 경우에는 차단하기보다 인증을 요구하세요. 차단은 조건에 일치하는 실제 구매자까지 거부하지만, 인증 요구는 구매자가 카드 소유자임을 증명할 수 있게 합니다.
WHOP_API_KEY가 설정된 신뢰할 수 있는 서버 환경에서 이 예제를 실행하세요.
사용하는 언어의 첫 번째 예제에 있는 import와 클라이언트 설정을 재사용하세요.명백한 사기 차단하기
분쟁에서 가장 자주 보이는 패턴부터 시작하세요. 이 규칙은 미국 외에서 발급된 카드로 Whop 점수가 85 이상인 결제를 차단합니다.import { WhopClient } from "@whop/sdk";
const client = new WhopClient({ token: process.env.WHOP_API_KEY });
const rule = await client.paymentRules.create({
account_id: "biz_xxxxxxxxxxxxx",
name: "Block high-risk cards from outside the US",
action: "block",
conditions: {
all: [
{ field: "risk_score", operator: "gte", value: 85 },
{ field: "card_country", operator: "neq", value: "US" },
],
},
});
console.log(rule.id); // prule_xxxxxxxxxxxxx
import os
from whop_sdk import Whop
from whop_sdk.payment_rules import (
CreatePaymentRulesRequestConditions,
CreatePaymentRulesRequestConditionsAllItem,
)
client = Whop(token=os.environ["WHOP_API_KEY"])
rule = client.payment_rules.create(
account_id="biz_xxxxxxxxxxxxx",
name="Block high-risk cards from outside the US",
action="block",
conditions=CreatePaymentRulesRequestConditions(
all_=[
CreatePaymentRulesRequestConditionsAllItem(field="risk_score", operator="gte", value=85),
CreatePaymentRulesRequestConditionsAllItem(field="card_country", operator="neq", value="US"),
],
),
)
print(rule.id) # prule_xxxxxxxxxxxxx
require "whop_sdk"
client = Whop_sdk::Client.new(token: ENV.fetch("WHOP_API_KEY"))
rule = client.payment_rules.create(
account_id: "biz_xxxxxxxxxxxxx",
name: "Block high-risk cards from outside the US",
action: "block",
conditions: {
all: [
{ field: "risk_score", operator: "gte", value: 85 },
{ field: "card_country", operator: "neq", value: "US" }
]
}
)
puts rule.id # prule_xxxxxxxxxxxxx
use whop_sdk::prelude::*;
let config = ClientConfig {
token: Some(std::env::var("WHOP_API_KEY").unwrap()),
..Default::default()
};
let client = Whop::new(config).expect("Failed to build client");
let rule = client
.payment_rules
.create(
&CreatePaymentRulesRequest {
name: "Block high-risk cards from outside the US".to_string(),
action: CreatePaymentRulesRequestAction::Block,
conditions: CreatePaymentRulesRequestConditions {
all: vec![
CreatePaymentRulesRequestConditionsAllItem {
field: CreatePaymentRulesRequestConditionsAllItemField::RiskScore,
operator: CreatePaymentRulesRequestConditionsAllItemOperator::Gte,
value: PaymentRuleConditionValue::Integer(85),
},
CreatePaymentRulesRequestConditionsAllItem {
field: CreatePaymentRulesRequestConditionsAllItemField::CardCountry,
operator: CreatePaymentRulesRequestConditionsAllItemOperator::Neq,
value: PaymentRuleConditionValue::String("US".to_string()),
},
],
..Default::default()
},
account_id: Some("biz_xxxxxxxxxxxxx".to_string()),
metadata: None,
},
None,
)
.await?;
println!("{}", rule.id); // prule_xxxxxxxxxxxxx
import (
"context"
"fmt"
"log"
"os"
whopsdk "github.com/whopio/whopsdk-go/v2"
"github.com/whopio/whopsdk-go/v2/client"
"github.com/whopio/whopsdk-go/v2/option"
)
client := client.NewWhop(option.WithToken(os.Getenv("WHOP_API_KEY")))
rule, err := client.PaymentRules.Create(context.TODO(), &whopsdk.CreatePaymentRulesRequest{
AccountID: whopsdk.String("biz_xxxxxxxxxxxxx"),
Name: "Block high-risk cards from outside the US",
Action: whopsdk.CreatePaymentRulesRequestActionBlock,
Conditions: &whopsdk.CreatePaymentRulesRequestConditions{
All: []*whopsdk.CreatePaymentRulesRequestConditionsAllItem{
{
Field: whopsdk.CreatePaymentRulesRequestConditionsAllItemFieldRiskScore,
Operator: whopsdk.CreatePaymentRulesRequestConditionsAllItemOperatorGte,
Value: &whopsdk.PaymentRuleConditionValue{Integer: 85},
},
{
Field: whopsdk.CreatePaymentRulesRequestConditionsAllItemFieldCardCountry,
Operator: whopsdk.CreatePaymentRulesRequestConditionsAllItemOperatorNeq,
Value: &whopsdk.PaymentRuleConditionValue{String: "US"},
},
},
},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(rule.ID) // prule_xxxxxxxxxxxxx
import com.whop.api.WhopApiClient;
import com.whop.api.resources.paymentrules.requests.CreatePaymentRulesRequest;
import com.whop.api.resources.paymentrules.types.*;
import com.whop.api.types.PaymentRuleConditionValue;
import java.util.List;
var client = WhopApiClient.builder()
.token(System.getenv("WHOP_API_KEY"))
.build();
var rule = client.paymentRules().create(
CreatePaymentRulesRequest.builder()
.accountId("biz_xxxxxxxxxxxxx")
.name("Block high-risk cards from outside the US")
.action(CreatePaymentRulesRequestAction.BLOCK)
.conditions(CreatePaymentRulesRequestConditions.builder()
.all(List.of(
CreatePaymentRulesRequestConditionsAllItem.builder()
.field(CreatePaymentRulesRequestConditionsAllItemField.RISK_SCORE)
.operator(CreatePaymentRulesRequestConditionsAllItemOperator.GTE)
.value(PaymentRuleConditionValue.of(85))
.build(),
CreatePaymentRulesRequestConditionsAllItem.builder()
.field(CreatePaymentRulesRequestConditionsAllItemField.CARD_COUNTRY)
.operator(CreatePaymentRulesRequestConditionsAllItemOperator.NEQ)
.value(PaymentRuleConditionValue.of("US"))
.build()
))
.build())
.build()
);
System.out.println(rule.getId());
import Foundation
import WhopSDK
let client = Whop(token: ProcessInfo.processInfo.environment["WHOP_API_KEY"]!)
let rule = try await client.paymentRules.create(
request: .init(
accountId: "biz_xxxxxxxxxxxxx",
action: .block,
conditions: .init(all: [
.init(
field: .riskScore,
operator: .gte,
value: .int(85)
),
.init(
field: .cardCountry,
operator: .neq,
value: .string("US")
)
]),
name: "Block high-risk cards from outside the US"
)
)
print(rule.id)
curl "https://api.whop.com/api/v1/payment_rules" \
-H "Authorization: Bearer $WHOP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"account_id": "biz_xxxxxxxxxxxxx",
"name": "Block high-risk cards from outside the US",
"action": "block",
"conditions": {
"all": [
{ "field": "risk_score", "operator": "gte", "value": 85 },
{ "field": "card_country", "operator": "neq", "value": "US" }
]
}
}'
account_id를 전달하세요. 이를 생략하면 자격 증명의 기본 계정에 규칙이 적용되는데, 여러 계정을 관리하는 플랫폼에서는 실수하기 쉽습니다. 규칙은 매분 체크아웃에 게시되므로 새로 만들거나 변경한 규칙은 몇 분 내에 적용되기 시작합니다.
필요한 권한: 규칙 작성에는
payment:manage, 읽기에는 payment:basic:read가
필요합니다. 권한
가이드에서 권한을 추가하세요.대규모 주문에 인증 요구하기
도난 카드로 이루어진 대규모 주문은 가장 피하고 싶은 차지백입니다. 실제 고객의 대규모 주문은 가장 잃고 싶지 않은 판매입니다. 3D Secure 인증은 이 둘을 구분하며, 구매자가 인증을 통과하면 결제에three_ds_verified: true가 기록됩니다.
체크아웃에서 인증을 진행할 수 없는 경우 enforce_3ds는 건너뛰지만 결제에는 계속 기록됩니다. 여기에는 갱신과 같은 오프세션 결제, 자체 3D Secure 수준을 설정한 변형, 카드가 아닌 결제, 결제 처리업체가 인증을 요구할 수 없는 카드가 포함됩니다. American Express는 USD 결제에서만 인증을 요구합니다.
await client.paymentRules.create({
account_id: "biz_xxxxxxxxxxxxx",
name: "Challenge orders over $500",
action: "enforce_3ds",
conditions: {
all: [{ field: "amount_in_usd", operator: "gte", value: 500 }],
},
});
client.payment_rules.create(
account_id="biz_xxxxxxxxxxxxx",
name="Challenge orders over $500",
action="enforce_3ds",
conditions=CreatePaymentRulesRequestConditions(
all_=[CreatePaymentRulesRequestConditionsAllItem(field="amount_in_usd", operator="gte", value=500)],
),
)
client.payment_rules.create(
account_id: "biz_xxxxxxxxxxxxx",
name: "Challenge orders over $500",
action: "enforce_3ds",
conditions: {
all: [{ field: "amount_in_usd", operator: "gte", value: 500 }]
}
)
client
.payment_rules
.create(
&CreatePaymentRulesRequest {
name: "Challenge orders over $500".to_string(),
action: CreatePaymentRulesRequestAction::Enforce3Ds,
conditions: CreatePaymentRulesRequestConditions {
all: vec![CreatePaymentRulesRequestConditionsAllItem {
field: CreatePaymentRulesRequestConditionsAllItemField::AmountInUsd,
operator: CreatePaymentRulesRequestConditionsAllItemOperator::Gte,
value: PaymentRuleConditionValue::Integer(500),
}],
..Default::default()
},
account_id: Some("biz_xxxxxxxxxxxxx".to_string()),
metadata: None,
},
None,
)
.await?;
_, err = client.PaymentRules.Create(context.TODO(), &whopsdk.CreatePaymentRulesRequest{
AccountID: whopsdk.String("biz_xxxxxxxxxxxxx"),
Name: "Challenge orders over $500",
Action: whopsdk.CreatePaymentRulesRequestActionEnforce3Ds,
Conditions: &whopsdk.CreatePaymentRulesRequestConditions{
All: []*whopsdk.CreatePaymentRulesRequestConditionsAllItem{
{
Field: whopsdk.CreatePaymentRulesRequestConditionsAllItemFieldAmountInUsd,
Operator: whopsdk.CreatePaymentRulesRequestConditionsAllItemOperatorGte,
Value: &whopsdk.PaymentRuleConditionValue{Integer: 500},
},
},
},
})
if err != nil {
log.Fatal(err)
}
var rule = client.paymentRules().create(
CreatePaymentRulesRequest.builder()
.accountId("biz_xxxxxxxxxxxxx")
.name("Challenge orders over $500")
.action(CreatePaymentRulesRequestAction.valueOf("enforce_3ds"))
.conditions(CreatePaymentRulesRequestConditions.builder()
.all(List.of(
CreatePaymentRulesRequestConditionsAllItem.builder()
.field(CreatePaymentRulesRequestConditionsAllItemField.AMOUNT_IN_USD)
.operator(CreatePaymentRulesRequestConditionsAllItemOperator.GTE)
.value(PaymentRuleConditionValue.of(500))
.build()
))
.build())
.build()
);
System.out.println(rule.getId());
let rule = try await client.paymentRules.create(
request: .init(
accountId: "biz_xxxxxxxxxxxxx",
action: .enforce3ds,
conditions: .init(all: [
.init(
field: .amountInUsd,
operator: .gte,
value: .int(500)
)
]),
name: "Challenge orders over $500"
)
)
print(rule.id)
curl "https://api.whop.com/api/v1/payment_rules" \
-H "Authorization: Bearer $WHOP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"account_id": "biz_xxxxxxxxxxxxx",
"name": "Challenge orders over $500",
"action": "enforce_3ds",
"conditions": {
"all": [
{ "field": "amount_in_usd", "operator": "gte", "value": 500 }
]
}
}'
청구 전에 결제 검토하기
review 규칙은 적격 카드 결제를 매입하지 않고 승인합니다. 구매자는 체크아웃을 완료하고 승인 시점에 멤버십 액세스를 받습니다. 직접 처리하는 주문이나, 위험하지만 확실한 사기는 아닌 패턴에 사용하세요. 먼저 조치하지 않으면 Whop이 48시간 후에 자동으로 매입합니다:
- 금액을 받으려면 매입하세요. 결제가
paid가 되고 Whop이 주문 처리 신호인payment.succeeded를 보냅니다. - 보류를 해제하려면 무효화하세요. Whop이 액세스를 취소하고, 예약된 재고를 반환하고,
payment.canceled를 보냅니다.
payment.authorized를 보냅니다. 보류된 결제는 status: "authorized"와 substatus: "requires_capture"로 표시됩니다. auto_capture_at은 결제 상태 조회로 확인하세요.
이 규칙은 미국 외에서 발급된 카드로 이루어진 $250 이상의 카드 결제를 보류합니다.
await client.paymentRules.create({
account_id: "biz_xxxxxxxxxxxxx",
name: "Review large orders from abroad",
action: "review",
conditions: {
all: [
{ field: "amount_in_usd", operator: "gte", value: 250 },
{ field: "card_country", operator: "neq", value: "US" },
],
},
});
client.payment_rules.create(
account_id="biz_xxxxxxxxxxxxx",
name="Review large orders from abroad",
action="review",
conditions=CreatePaymentRulesRequestConditions(
all_=[
CreatePaymentRulesRequestConditionsAllItem(field="amount_in_usd", operator="gte", value=250),
CreatePaymentRulesRequestConditionsAllItem(field="card_country", operator="neq", value="US"),
],
),
)
client.payment_rules.create(
account_id: "biz_xxxxxxxxxxxxx",
name: "Review large orders from abroad",
action: "review",
conditions: {
all: [
{ field: "amount_in_usd", operator: "gte", value: 250 },
{ field: "card_country", operator: "neq", value: "US" }
]
}
)
client
.payment_rules
.create(
&CreatePaymentRulesRequest {
name: "Review large orders from abroad".to_string(),
action: CreatePaymentRulesRequestAction::Review,
conditions: CreatePaymentRulesRequestConditions {
all: vec![
CreatePaymentRulesRequestConditionsAllItem {
field: CreatePaymentRulesRequestConditionsAllItemField::AmountInUsd,
operator: CreatePaymentRulesRequestConditionsAllItemOperator::Gte,
value: PaymentRuleConditionValue::Integer(250),
},
CreatePaymentRulesRequestConditionsAllItem {
field: CreatePaymentRulesRequestConditionsAllItemField::CardCountry,
operator: CreatePaymentRulesRequestConditionsAllItemOperator::Neq,
value: PaymentRuleConditionValue::String("US".to_string()),
},
],
..Default::default()
},
account_id: Some("biz_xxxxxxxxxxxxx".to_string()),
metadata: None,
},
None,
)
.await?;
_, err = client.PaymentRules.Create(context.TODO(), &whopsdk.CreatePaymentRulesRequest{
AccountID: whopsdk.String("biz_xxxxxxxxxxxxx"),
Name: "Review large orders from abroad",
Action: whopsdk.CreatePaymentRulesRequestActionReview,
Conditions: &whopsdk.CreatePaymentRulesRequestConditions{
All: []*whopsdk.CreatePaymentRulesRequestConditionsAllItem{
{
Field: whopsdk.CreatePaymentRulesRequestConditionsAllItemFieldAmountInUsd,
Operator: whopsdk.CreatePaymentRulesRequestConditionsAllItemOperatorGte,
Value: &whopsdk.PaymentRuleConditionValue{Integer: 250},
},
{
Field: whopsdk.CreatePaymentRulesRequestConditionsAllItemFieldCardCountry,
Operator: whopsdk.CreatePaymentRulesRequestConditionsAllItemOperatorNeq,
Value: &whopsdk.PaymentRuleConditionValue{String: "US"},
},
},
},
})
if err != nil {
log.Fatal(err)
}
var rule = client.paymentRules().create(
CreatePaymentRulesRequest.builder()
.accountId("biz_xxxxxxxxxxxxx")
.name("Review large orders from abroad")
.action(CreatePaymentRulesRequestAction.REVIEW)
.conditions(CreatePaymentRulesRequestConditions.builder()
.all(List.of(
CreatePaymentRulesRequestConditionsAllItem.builder()
.field(CreatePaymentRulesRequestConditionsAllItemField.AMOUNT_IN_USD)
.operator(CreatePaymentRulesRequestConditionsAllItemOperator.GTE)
.value(PaymentRuleConditionValue.of(250))
.build(),
CreatePaymentRulesRequestConditionsAllItem.builder()
.field(CreatePaymentRulesRequestConditionsAllItemField.CARD_COUNTRY)
.operator(CreatePaymentRulesRequestConditionsAllItemOperator.NEQ)
.value(PaymentRuleConditionValue.of("US"))
.build()
))
.build())
.build()
);
System.out.println(rule.getId());
let rule = try await client.paymentRules.create(
request: .init(
accountId: "biz_xxxxxxxxxxxxx",
action: .review,
conditions: .init(all: [
.init(
field: .amountInUsd,
operator: .gte,
value: .int(250)
),
.init(
field: .cardCountry,
operator: .neq,
value: .string("US")
)
]),
name: "Review large orders from abroad"
)
)
print(rule.id)
curl "https://api.whop.com/api/v1/payment_rules" \
-H "Authorization: Bearer $WHOP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"account_id": "biz_xxxxxxxxxxxxx",
"name": "Review large orders from abroad",
"action": "review",
"conditions": {
"all": [
{ "field": "amount_in_usd", "operator": "gte", "value": 250 },
{ "field": "card_country", "operator": "neq", "value": "US" }
]
}
}'
await client.payments.capture({ id: "pay_xxxxxxxxxxxxx" });
client.payments.capture(id="pay_xxxxxxxxxxxxx")
client.payments.capture(id: "pay_xxxxxxxxxxxxx")
client.payments.capture("pay_xxxxxxxxxxxxx", None).await?;
_, err = client.Payments.Capture(context.TODO(), &whopsdk.CapturePaymentsRequest{
ID: "pay_xxxxxxxxxxxxx",
})
if err != nil {
log.Fatal(err)
}
client.payments().capture("pay_xxxxxxxxxxxxx");
_ = try await client.payments.capture(id: "pay_xxxxxxxxxxxxx")
curl -X POST "https://api.whop.com/api/v1/payments/pay_xxxxxxxxxxxxx/capture" \
-H "Authorization: Bearer $WHOP_API_KEY"
await client.payments.void({ id: "pay_xxxxxxxxxxxxx" });
client.payments.void(id="pay_xxxxxxxxxxxxx")
client.payments.void(id: "pay_xxxxxxxxxxxxx")
client.payments.void("pay_xxxxxxxxxxxxx", None).await?;
_, err = client.Payments.Void(context.TODO(), &whopsdk.VoidPaymentsRequest{
ID: "pay_xxxxxxxxxxxxx",
})
if err != nil {
log.Fatal(err)
}
client.payments().void_("pay_xxxxxxxxxxxxx");
_ = try await client.payments.void(id: "pay_xxxxxxxxxxxxx")
curl -X POST "https://api.whop.com/api/v1/payments/pay_xxxxxxxxxxxxx/void" \
-H "Authorization: Bearer $WHOP_API_KEY"
검토 제한 사항
- 온세션 카드만 보류할 수 있습니다. Apple Pay, Google Pay, 은행, 잔액, 그리고 갱신과 같은 오프세션 결제는 검토를 건너뜁니다. 일치 내역은 여전히
payment_rule_matches에 기록됩니다. capture: false로 생성된 결제는 자체 일정을 유지합니다. 검토 규칙은 이를 재정의하지 않습니다.- 매입은 전부 아니면 전무입니다. 일부를 돌려주려면 이후에 환불하세요.
- 결정하기 전에 구매자가 이미 상품을 받습니다. 무효화하는 경우 구매자에게 알리세요.
신뢰할 수 있는 구매자의 원활한 결제 유지하기
allow 규칙은 신뢰하는 구매자를 차단, 검토, 인증 요구 규칙에서 제외합니다.
await client.paymentRules.create({
account_id: "biz_xxxxxxxxxxxxx",
name: "Trusted customers",
action: "allow",
conditions: {
all: [
{
field: "customer_email",
operator: "in",
value: ["ava@example.com", "noah@example.com"],
},
],
},
});
client.payment_rules.create(
account_id="biz_xxxxxxxxxxxxx",
name="Trusted customers",
action="allow",
conditions=CreatePaymentRulesRequestConditions(
all_=[
CreatePaymentRulesRequestConditionsAllItem(
field="customer_email",
operator="in",
value=["ava@example.com", "noah@example.com"],
)
],
),
)
client.payment_rules.create(
account_id: "biz_xxxxxxxxxxxxx",
name: "Trusted customers",
action: "allow",
conditions: {
all: [
{ field: "customer_email", operator: "in", value: ["ava@example.com", "noah@example.com"] }
]
}
)
client
.payment_rules
.create(
&CreatePaymentRulesRequest {
name: "Trusted customers".to_string(),
action: CreatePaymentRulesRequestAction::Allow,
conditions: CreatePaymentRulesRequestConditions {
all: vec![CreatePaymentRulesRequestConditionsAllItem {
field: CreatePaymentRulesRequestConditionsAllItemField::CustomerEmail,
operator: CreatePaymentRulesRequestConditionsAllItemOperator::In,
value: PaymentRuleConditionValue::StringList(vec![
"ava@example.com".to_string(),
"noah@example.com".to_string(),
]),
}],
..Default::default()
},
account_id: Some("biz_xxxxxxxxxxxxx".to_string()),
metadata: None,
},
None,
)
.await?;
_, err = client.PaymentRules.Create(context.TODO(), &whopsdk.CreatePaymentRulesRequest{
AccountID: whopsdk.String("biz_xxxxxxxxxxxxx"),
Name: "Trusted customers",
Action: whopsdk.CreatePaymentRulesRequestActionAllow,
Conditions: &whopsdk.CreatePaymentRulesRequestConditions{
All: []*whopsdk.CreatePaymentRulesRequestConditionsAllItem{
{
Field: whopsdk.CreatePaymentRulesRequestConditionsAllItemFieldCustomerEmail,
Operator: whopsdk.CreatePaymentRulesRequestConditionsAllItemOperatorIn,
Value: &whopsdk.PaymentRuleConditionValue{
StringList: []string{"ava@example.com", "noah@example.com"},
},
},
},
},
})
if err != nil {
log.Fatal(err)
}
var rule = client.paymentRules().create(
CreatePaymentRulesRequest.builder()
.accountId("biz_xxxxxxxxxxxxx")
.name("Trusted customers")
.action(CreatePaymentRulesRequestAction.ALLOW)
.conditions(CreatePaymentRulesRequestConditions.builder()
.all(List.of(
CreatePaymentRulesRequestConditionsAllItem.builder()
.field(CreatePaymentRulesRequestConditionsAllItemField.CUSTOMER_EMAIL)
.operator(CreatePaymentRulesRequestConditionsAllItemOperator.IN)
.value(PaymentRuleConditionValue.of(List.of("ava@example.com", "noah@example.com")))
.build()
))
.build())
.build()
);
System.out.println(rule.getId());
let rule = try await client.paymentRules.create(
request: .init(
accountId: "biz_xxxxxxxxxxxxx",
action: .allow,
conditions: .init(all: [
.init(
field: .customerEmail,
operator: .`in`,
value: .stringArray(["ava@example.com", "noah@example.com"])
)
]),
name: "Trusted customers"
)
)
print(rule.id)
curl "https://api.whop.com/api/v1/payment_rules" \
-H "Authorization: Bearer $WHOP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"account_id": "biz_xxxxxxxxxxxxx",
"name": "Trusted customers",
"action": "allow",
"conditions": {
"all": [
{ "field": "customer_email", "operator": "in", "value": ["ava@example.com", "noah@example.com"] }
]
}
}'
규칙 강화하기
규칙의 동작은 생성 후 고정되므로, 규칙이 결정한 결제는 계속해서 그 규칙을 가리킵니다. 작업이나 조건을 변경하려면 규칙을 교체하세요. 기존 규칙은 삭제되고 새 ID를 가진 후속 규칙이 이름,metadata, 활성 상태를 이어받습니다. 이 예에서는 실제 구매자를 너무 많이 차단한 후 차단 임계값을 85에서 90으로 높입니다.
const successor = await client.paymentRules.replace({
id: "prule_xxxxxxxxxxxxx",
action: "block",
conditions: {
all: [
{ field: "risk_score", operator: "gte", value: 90 },
{ field: "card_country", operator: "neq", value: "US" },
],
},
});
console.log(successor.id); // a new prule_ ID
from whop_sdk.payment_rules import (
ReplacePaymentRulesRequestConditions,
ReplacePaymentRulesRequestConditionsAllItem,
)
successor = client.payment_rules.replace(
id="prule_xxxxxxxxxxxxx",
action="block",
conditions=ReplacePaymentRulesRequestConditions(
all_=[
ReplacePaymentRulesRequestConditionsAllItem(field="risk_score", operator="gte", value=90),
ReplacePaymentRulesRequestConditionsAllItem(field="card_country", operator="neq", value="US"),
],
),
)
print(successor.id) # a new prule_ ID
successor = client.payment_rules.replace(
id: "prule_xxxxxxxxxxxxx",
action: "block",
conditions: {
all: [
{ field: "risk_score", operator: "gte", value: 90 },
{ field: "card_country", operator: "neq", value: "US" }
]
}
)
puts successor.id # a new prule_ ID
let successor = client
.payment_rules
.replace(
&"prule_xxxxxxxxxxxxx".to_string(),
&ReplacePaymentRulesRequest {
action: ReplacePaymentRulesRequestAction::Block,
conditions: ReplacePaymentRulesRequestConditions {
all: vec![
ReplacePaymentRulesRequestConditionsAllItem {
field: ReplacePaymentRulesRequestConditionsAllItemField::RiskScore,
operator: ReplacePaymentRulesRequestConditionsAllItemOperator::Gte,
value: PaymentRuleConditionValue::Integer(90),
},
ReplacePaymentRulesRequestConditionsAllItem {
field: ReplacePaymentRulesRequestConditionsAllItemField::CardCountry,
operator: ReplacePaymentRulesRequestConditionsAllItemOperator::Neq,
value: PaymentRuleConditionValue::String("US".to_string()),
},
],
..Default::default()
},
},
None,
)
.await?;
println!("{}", successor.id); // a new prule_ ID
successor, err := client.PaymentRules.Replace(context.TODO(), &whopsdk.ReplacePaymentRulesRequest{
ID: "prule_xxxxxxxxxxxxx",
Action: whopsdk.ReplacePaymentRulesRequestActionBlock,
Conditions: &whopsdk.ReplacePaymentRulesRequestConditions{
All: []*whopsdk.ReplacePaymentRulesRequestConditionsAllItem{
{
Field: whopsdk.ReplacePaymentRulesRequestConditionsAllItemFieldRiskScore,
Operator: whopsdk.ReplacePaymentRulesRequestConditionsAllItemOperatorGte,
Value: &whopsdk.PaymentRuleConditionValue{Integer: 90},
},
{
Field: whopsdk.ReplacePaymentRulesRequestConditionsAllItemFieldCardCountry,
Operator: whopsdk.ReplacePaymentRulesRequestConditionsAllItemOperatorNeq,
Value: &whopsdk.PaymentRuleConditionValue{String: "US"},
},
},
},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(successor.ID) // a new prule_ ID
import com.whop.api.resources.paymentrules.requests.ReplacePaymentRulesRequest;
var successor = client.paymentRules().replace(
"prule_xxxxxxxxxxxxx",
ReplacePaymentRulesRequest.builder()
.action(ReplacePaymentRulesRequestAction.BLOCK)
.conditions(ReplacePaymentRulesRequestConditions.builder()
.all(List.of(
ReplacePaymentRulesRequestConditionsAllItem.builder()
.field(ReplacePaymentRulesRequestConditionsAllItemField.RISK_SCORE)
.operator(ReplacePaymentRulesRequestConditionsAllItemOperator.GTE)
.value(PaymentRuleConditionValue.of(90))
.build(),
ReplacePaymentRulesRequestConditionsAllItem.builder()
.field(ReplacePaymentRulesRequestConditionsAllItemField.CARD_COUNTRY)
.operator(ReplacePaymentRulesRequestConditionsAllItemOperator.NEQ)
.value(PaymentRuleConditionValue.of("US"))
.build()
))
.build())
.build()
);
System.out.println(successor.getId());
let successor = try await client.paymentRules.replace(
id: "prule_xxxxxxxxxxxxx",
request: .init(
action: .block,
conditions: .init(all: [
.init(
field: .riskScore,
operator: .gte,
value: .int(90)
),
.init(
field: .cardCountry,
operator: .neq,
value: .string("US")
)
])
)
)
print(successor.id)
curl "https://api.whop.com/api/v1/payment_rules/prule_xxxxxxxxxxxxx/replace" \
-H "Authorization: Bearer $WHOP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"action": "block",
"conditions": {
"all": [
{ "field": "risk_score", "operator": "gte", "value": 90 },
{ "field": "card_country", "operator": "neq", "value": "US" }
]
}
}'
status: "deleted"로 계속 조회할 수 있습니다.
효과 측정하기
각 결제는 일치한 규칙을 당시의 규칙 이름과 함께payment_rule_matches에 나열합니다.
{
"id": "pay_xxxxxxxxxxxxx",
"substatus": "blocked",
"risk_score": 91,
"payment_rule_matches": [
{
"id": "prule_xxxxxxxxxxxxx",
"name": "Block high-risk cards from outside the US",
"action": "block"
}
]
}
payment_rule_matches 및 payment_rule_matched_volume 지표를 payment_rule_ids 또는 action별로 분류하여 확인하세요.
다음 단계
결제 규칙 레퍼런스
모든 엔드포인트, 매개변수, 응답 필드입니다.
환불 및 분쟁
여전히 통과하는 차지백에 대응하세요.

