Fraud & Policies
Protect your business with fraud controls and retry policies.Fraud Policies
Set organization-level risk controls for payment intents.Available Controls
Get Fraud Policy
Set Fraud Policy
Merge Behavior
Policies are merged, not replaced:blocked_binsare added to existing listallowed_binsare added to existing list- Other fields are overwritten
Per-Request Override
Override fraud policy for a specific payment:Audit Trail
View policy changes:Retry Policies
Configure how failed subscription payments are retried.Get Retry Policy
Set Retry Policy
Delay Format
Policy Hierarchy
Policies are applied in order:- Plan-level — Specific to subscription plan
- Org-level — Default for organization (empty
plan_id) - Global — System default (3 retries at 15m, 1h, 24h)
List Retry Policies
Delete Retry Policy
Error Codes
Best Practices
Fraud Policies
- Start Conservative — Set lower limits initially
- Monitor Blocks — Review blocked payments regularly
- Whitelist Trusted — Use
allowed_binsfor known customers - Velocity Limits — Prevent card testing attacks
Retry Policies
- Gradual Delays — Start short, increase over time
- Plan-Specific — Higher-value plans may need more retries
- Notify Customers — Send emails before final retry
- Grace Period — Allow time for customers to update payment

