{"openapi":"3.1.0","info":{"title":"Routed.wtf Settlement API","version":"2026-09-24","description":"Exact-output stablecoin settlement: payment intents, hosted checkout, quotes, provider orders, signed receipts and webhooks. Amounts are integer strings in the smallest unit. All mutations require an Idempotency-Key header."},"servers":[{"url":"https://api.routed.wtf"}],"tags":[{"name":"Admin"},{"name":"Console"},{"name":"Merchants"},{"name":"API keys"},{"name":"Team"},{"name":"Agent payments"},{"name":"Agent authorizations"},{"name":"Metering"},{"name":"Conditions"},{"name":"Escrows"},{"name":"Disputes"},{"name":"Settlement policies"},{"name":"Execution plans"},{"name":"Payment links"},{"name":"Refunds"},{"name":"Webhooks"},{"name":"Payouts"},{"name":"Recurring"},{"name":"Exports"},{"name":"Payment intents"},{"name":"Public checkout"},{"name":"Conditional payments (payer)"},{"name":"Sandbox"},{"name":"Agent commerce"},{"name":"AP2 mandates"},{"name":"Capability negotiation"},{"name":"ACP checkout (protocol-native)"},{"name":"UCP checkout (protocol-native)"},{"name":"Beneficiaries"},{"name":"Fiat transfers"},{"name":"Enterprise"},{"name":"SCIM"},{"name":"Receipts"}],"paths":{"/api/admin/merchants":{"get":{"operationId":"get_api_admin_merchants","summary":"Search merchants","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":80}},{"name":"status","in":"query","required":false,"schema":{"type":"string","maxLength":32}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:merchants:read"}},"/api/admin/merchants/{id}":{"get":{"operationId":"get_api_admin_merchants_id","summary":"Merchant detail with live-activation requirements","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^mer_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:merchants:read"}},"/api/admin/merchants/{id}/activate-live":{"post":{"operationId":"post_api_admin_merchants_id_activate_live","summary":"Record verification results and activate live mode (fails closed)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^mer_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:merchants:activate","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ownership_verified":{"type":"boolean"},"kyb_approved":{"type":"boolean"},"max_intent_usd_minor":{"type":"string","pattern":"^[1-9]\\d{0,12}$"},"note":{"type":"string","minLength":8,"maxLength":500}},"required":["ownership_verified","kyb_approved","max_intent_usd_minor","note"]}}}}}},"/api/admin/merchants/{id}/status":{"post":{"operationId":"post_api_admin_merchants_id_status","summary":"Restrict, suspend or reinstate a merchant","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^mer_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:merchants:activate","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to":{"type":"string","enum":["IDENTITY_REQUIRED","RESTRICTED","SUSPENDED","ACTIVE_TEST","ACTIVE_LIVE","CLOSED"]},"reason":{"type":"string","minLength":8,"maxLength":500}},"required":["to","reason"]}}}}}},"/api/admin/merchants/{id}/verification":{"post":{"operationId":"post_api_admin_merchants_id_verification","summary":"Record ownership and KYB results without activating live mode","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^mer_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:merchants:activate","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ownership_verified":{"type":"boolean"},"kyb_status":{"type":"string","enum":["pending","approved","rejected"]},"note":{"type":"string","minLength":8,"maxLength":500}},"required":["note"]}}}}}},"/api/admin/reconciliation/runs":{"get":{"operationId":"get_api_admin_reconciliation_runs","summary":"Reconciliation runs","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:reconciliation:read"}},"/api/admin/reconciliation/runs/{id}":{"get":{"operationId":"get_api_admin_reconciliation_runs_id","summary":"Reconciliation run items","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^recon_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:reconciliation:read"}},"/api/admin/reconciliation/run":{"post":{"operationId":"post_api_admin_reconciliation_run","summary":"Run (or re-run) reconciliation for a provider and UTC day","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:reconciliation:resolve","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","maxLength":40},"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"environment":{"default":"test","type":"string","enum":["test","live"]}},"required":["provider","date"]}}}}}},"/api/admin/reconciliation/items/{id}/resolve":{"post":{"operationId":"post_api_admin_reconciliation_items_id_resolve","summary":"Resolve or write off a reconciliation exception","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:reconciliation:resolve","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"outcome":{"type":"string","enum":["RESOLVED","WRITTEN_OFF"]},"note":{"type":"string","minLength":8,"maxLength":1000}},"required":["outcome","note"]}}}}}},"/api/admin/orders/{id}/resync":{"post":{"operationId":"post_api_admin_orders_id_resync","summary":"Force a provider status re-sync for an order","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ord_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:provider_sync:requeue"}},"/api/admin/events/{id}/replay":{"post":{"operationId":"post_api_admin_events_id_replay","summary":"Replay a webhook event for a merchant","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^evt_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:webhooks:replay"}},"/api/admin/refunds":{"get":{"operationId":"get_api_admin_refunds","summary":"Refunds needing attention (manual review, failures, awaiting funding)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","maxLength":32}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:orders:read"}},"/api/admin/refunds/{id}/resolve":{"post":{"operationId":"post_api_admin_refunds_id_resolve","summary":"Resolve a refund under manual review with the evidence the platform holds","description":"`completed` needs the provider to report completion and a final on-chain transfer of the amount sent; `failed` needs the provider to report it did not deliver (the merchant funding is reversed on the ledger). There is no force-complete.","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^re_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:intents:resolve_review","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"decision":{"type":"string","enum":["completed","failed"]},"reason":{"type":"string","minLength":8,"maxLength":500}},"required":["decision","reason"]}}}}}},"/api/admin/plans/review":{"get":{"operationId":"get_api_admin_plans_review","summary":"Manual-review queue for execution plans (partial settlements, ambiguous outcomes, screening)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:orders:read"}},"/api/admin/plans/{id}":{"get":{"operationId":"get_api_admin_plans_id","summary":"Plan detail for operators: plan, steps, legs, open review items and the intent state","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plan_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:orders:read"}},"/api/admin/plans/{id}/resolve":{"post":{"operationId":"post_api_admin_plans_id_resolve","summary":"Resolve a plan in manual review (retry a step, recompile the remainder, or mark failed)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plan_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:intents:resolve_review","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolvePlanRequest"}}}}}},"/api/admin/conditions/review":{"get":{"operationId":"get_api_admin_conditions_review","summary":"Conditions awaiting a human (under review or conflicted)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}},"required":["object","data"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:conditions:decide"}},"/api/admin/conditions/{id}/decision":{"post":{"operationId":"post_api_admin_conditions_id_decision","summary":"Decide a condition under review (a second operator confirms above USD 1,000)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^cond_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["applied","pending_second_approval"]},"condition":{"$ref":"#/components/schemas/Condition"}},"required":["status","condition"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:conditions:decide","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorConditionDecision"}}}}}},"/api/admin/disputes":{"get":{"operationId":"get_api_admin_disputes","summary":"Dispute queue (newest first)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","maxLength":40}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Dispute"}}},"required":["object","data"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:disputes:decide"}},"/api/admin/disputes/{id}":{"get":{"operationId":"get_api_admin_disputes_id","summary":"A dispute with its escrow","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^dsp_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"dispute":{"$ref":"#/components/schemas/Dispute"},"escrow":{"$ref":"#/components/schemas/Escrow"}},"required":["dispute","escrow"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:disputes:decide"}},"/api/admin/disputes/{id}/evidence/{evidenceId}":{"get":{"operationId":"get_api_admin_disputes_id_evidence_evidenceId","summary":"Read one party’s evidence as the resolver (test mode; every read is audited)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^dsp_[0-9A-Za-z]{16,40}$"}},{"name":"evidenceId","in":"path","required":true,"schema":{"type":"string","pattern":"^evd_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:disputes:decide"}},"/api/admin/disputes/{id}/decision":{"post":{"operationId":"post_api_admin_disputes_id_decision","summary":"Record the resolver’s decision (release, refund or split); four eyes above USD 1,000","description":"Test mode only: live disputes need an approved dispute-resolution integration and are refused until one is configured.","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^dsp_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:disputes:decide","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeDecisionRequest"}}}}}},"/api/admin/escrows/{id}":{"get":{"operationId":"get_api_admin_escrows_id","summary":"An escrow with its conditions, milestones and movements","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^esc_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Escrow"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:escrows:read"}},"/api/admin/escrows/{id}/movements/{movementId}/not-executed":{"post":{"operationId":"post_api_admin_escrows_id_movements_movementId_not_executed","summary":"Resolve a release / refund in review that reconciliation shows did not execute","description":"Refused when the transfer is observed on chain (it is then confirmed by reconciliation). Otherwise the movement fails, its idempotency key is retired, and the escrow returns to FUNDED so the move can be requested again. Success can never be asserted by hand.","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^esc_[0-9A-Za-z]{16,40}$"}},{"name":"movementId","in":"path","required":true,"schema":{"type":"string","pattern":"^emv_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Escrow"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:escrows:resolve","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscrowOperatorAction"}}}}}},"/api/admin/escrows/{id}/{action}":{"post":{"operationId":"post_api_admin_escrows_id_action","summary":"Place or lift a legal hold (nothing moves while held)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^esc_[0-9A-Za-z]{16,40}$"}},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["legal-hold","lift-freeze"]}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Escrow"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:escrows:legal_hold","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscrowOperatorAction"}}}}}},"/api/admin/fiat/review":{"get":{"operationId":"get_api_admin_fiat_review","summary":"Fiat compliance queue: screening matches, held transfers, manual review","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:fiat:review"}},"/api/admin/fiat-transfers/{id}":{"get":{"operationId":"get_api_admin_fiat_transfers_id","summary":"A fiat transfer (operator view)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ft_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:fiat:review"}},"/api/admin/beneficiaries/{id}/screening":{"post":{"operationId":"post_api_admin_beneficiaries_id_screening","summary":"Decide a potential screening match (clear, or confirm the match and block)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ben_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:fiat:review","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"decision":{"type":"string","enum":["clear","confirmed_match"]},"reason":{"type":"string","minLength":5,"maxLength":500}},"required":["decision","reason"]}}}}}},"/api/admin/fiat-transfers/{id}/review":{"post":{"operationId":"post_api_admin_fiat_transfers_id_review","summary":"Approve or reject a transfer held for compliance review","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ft_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:fiat:review","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"decision":{"type":"string","enum":["approve","reject"]},"reason":{"type":"string","minLength":5,"maxLength":500}},"required":["decision","reason"]}}}}}},"/api/admin/fiat-transfers/{id}/resolve":{"post":{"operationId":"post_api_admin_fiat_transfers_id_resolve","summary":"Resolve a transfer in manual review after reconciling with the provider (resume polling, or fail it)","description":"Success is never asserted by hand: SUBMITTED / PROCESSING resume polling so the provider’s own status drives settlement; REJECTED / CANCELED fail the transfer.","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ft_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:fiat:review","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to":{"type":"string","enum":["SUBMITTED","PROCESSING","REJECTED","CANCELED"]},"reason":{"type":"string","minLength":5,"maxLength":500}},"required":["to","reason"]}}}}}},"/api/admin/kill-switches":{"get":{"operationId":"get_api_admin_kill_switches","summary":"Kill switches (engaged first)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:orders:read"},"post":{"operationId":"post_api_admin_kill_switches","summary":"Engage a kill switch (stops matching execution immediately, fail closed)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:kill_switches:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scope":{"type":"string","enum":["global_execution","merchant","principal","agent","protocol","provider","network","asset","verifier","rail"]},"value":{"type":"string","minLength":1,"maxLength":120},"environment":{"type":"string","enum":["test","live"]},"reason":{"type":"string","minLength":5,"maxLength":300}},"required":["scope","value","reason"]}}}}}},"/api/admin/kill-switches/{id}/release":{"post":{"operationId":"post_api_admin_kill_switches_id_release","summary":"Release a kill switch (dual control: the first call requests the release, a different operator confirms it)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ks_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:kill_switches:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","minLength":5,"maxLength":300}},"required":["reason"]}}}}}},"/api/admin/flags":{"get":{"operationId":"get_api_admin_flags","summary":"Feature flags with effective values and overrides","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:orders:read"}},"/api/admin/flags/{flag}":{"put":{"operationId":"put_api_admin_flags_flag","summary":"Override a feature flag (globally or for one merchant)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"flag","in":"path","required":true,"schema":{"type":"string","maxLength":64}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:flags:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"merchant_id":{"type":"string","pattern":"^mer_[0-9A-Za-z]{16,40}$"},"reason":{"type":"string","minLength":5,"maxLength":300}},"required":["enabled","reason"]}}}}}},"/api/admin/provider-certifications":{"get":{"operationId":"get_api_admin_provider_certifications","summary":"Provider certifications","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ProviderCertification"}}},"required":["object","data"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:orders:read"}},"/api/admin/providers/{name}/certification":{"put":{"operationId":"put_api_admin_providers_name_certification","summary":"Record a provider certification decision (live routing requires certified)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9_]{2,40}$"}},{"name":"environment","in":"query","required":false,"schema":{"default":"live","type":"string","enum":["test","live"]}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCertification"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:providers:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCertificationRequest"}}}}}},"/api/admin/incidents":{"post":{"operationId":"post_api_admin_incidents","summary":"Publish an incident to subscribers","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:providers:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"component":{"type":"string","minLength":2,"maxLength":80},"severity":{"type":"string","enum":["minor","major","critical"]},"title":{"type":"string","minLength":3,"maxLength":120},"message":{"type":"string","minLength":3,"maxLength":2000}},"required":["component","severity","title","message"]}}}}}},"/api/admin/auth/login":{"post":{"operationId":"post_api_admin_auth_login","summary":"Operator login (returns a session token for the admin console BFF)","tags":["Admin"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"admin_login","limit":10,"windowSeconds":900,"limitConfigKey":"RATE_LIMIT_ADMIN_LOGIN_PER_15_MIN"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorLoginRequest"}}}}}},"/api/admin/auth/two-factor":{"get":{"operationId":"get_api_admin_auth_two_factor","summary":"The current operator's two-factor sign-in status","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/admin/auth/two-factor/setup":{"post":{"operationId":"post_api_admin_auth_two_factor_setup","summary":"Start two-factor enrollment: a new authenticator secret (shown once)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"admin_two_factor","limit":10,"windowSeconds":900}}},"/api/admin/auth/two-factor/activate":{"post":{"operationId":"post_api_admin_auth_two_factor_activate","summary":"Confirm enrollment with a code; returns recovery codes (shown once)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"admin_two_factor","limit":10,"windowSeconds":900},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorTwoFactorCode"}}}}}},"/api/admin/operators/{id}/two-factor/reset":{"post":{"operationId":"post_api_admin_operators_id_two_factor_reset","summary":"Reset another operator's two-factor sign-in (lost authenticator and recovery codes)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^op_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:operators:manage","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","minLength":8,"maxLength":500}},"required":["reason"]}}}}}},"/api/admin/auth/logout":{"post":{"operationId":"post_api_admin_auth_logout","summary":"Revoke the operator session","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/admin/me":{"get":{"operationId":"get_api_admin_me","summary":"Current operator and permissions","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/admin/orders":{"get":{"operationId":"get_api_admin_orders","summary":"Search orders (masked)","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":128}},{"name":"status","in":"query","required":false,"schema":{"type":"string","maxLength":32}},{"name":"provider","in":"query","required":false,"schema":{"type":"string","maxLength":40}},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["test","live"]}},{"name":"review_only","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:orders:read"}},"/api/admin/orders/{internalId}":{"get":{"operationId":"get_api_admin_orders_internalId","summary":"Order and intent detail with timeline, polling history, webhooks, receipt and support context","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[{"name":"internalId","in":"path","required":true,"schema":{"type":"string","maxLength":64}},{"name":"reveal","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"reason","in":"query","required":false,"schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:orders:read"}},"/api/admin/provider-health":{"get":{"operationId":"get_api_admin_provider_health","summary":"Provider health, capability metadata and recent error rates","tags":["Admin"],"security":[{"operatorSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-permission":"admin:orders:read"}},"/api/console/auth/login":{"post":{"operationId":"post_api_console_auth_login","summary":"Merchant console login (returns a session token for the console BFF)","tags":["Console"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"console_login","limit":10,"windowSeconds":900},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsoleLoginRequest"}}}}}},"/api/console/auth/logout":{"post":{"operationId":"post_api_console_auth_logout","summary":"Revoke the console session","tags":["Console"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/console/auth/password-reset":{"post":{"operationId":"post_api_console_auth_password_reset","summary":"Email a password reset link (same response whether or not the account exists)","tags":["Console"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"password_reset","limit":5,"windowSeconds":3600},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetRequest"}}}}}},"/api/console/auth/signup":{"post":{"operationId":"post_api_console_auth_signup","summary":"Start a self-serve sign-up: emails a link to confirm and choose a password","description":"The response is the same whether or not the email already has an account. Nothing is created until the emailed link is completed; the new merchant starts in test mode.","tags":["Console"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"signup","limit":5,"windowSeconds":3600},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRequest"}}}}}},"/api/console/auth/signup/{token}":{"get":{"operationId":"get_api_console_auth_signup_token","summary":"Whether a sign-up link is still usable","tags":["Console"],"security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","pattern":"^sgn_[0-9A-Za-z]{40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"signup_check","limit":30,"windowSeconds":900}}},"/api/console/auth/signup/complete":{"post":{"operationId":"post_api_console_auth_signup_complete","summary":"Finish sign-up: set the password, create the organization and merchant, sign in","tags":["Console"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"signup_complete","limit":10,"windowSeconds":900},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupCompleteRequest"}}}}}},"/api/console/auth/password-reset/{token}":{"get":{"operationId":"get_api_console_auth_password_reset_token","summary":"Whether a password reset link is still usable","tags":["Console"],"security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","pattern":"^pwr_[0-9A-Za-z]{40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"password_reset_check","limit":30,"windowSeconds":900}}},"/api/console/auth/password-reset/complete":{"post":{"operationId":"post_api_console_auth_password_reset_complete","summary":"Set a new password with a reset link (signs out every session)","tags":["Console"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"password_reset_complete","limit":10,"windowSeconds":900},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetCompleteRequest"}}}}}},"/api/console/me":{"get":{"operationId":"get_api_console_me","summary":"Current user, accessible merchants, active merchant/mode and permissions","tags":["Console"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/console/session":{"post":{"operationId":"post_api_console_session","summary":"Switch the active merchant or test/live mode","tags":["Console"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsoleSwitchRequest"}}}}}},"/api/console/invitations/accept":{"post":{"operationId":"post_api_console_invitations_accept","summary":"Accept a team invitation and start a session","tags":["Console"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"console_login","limit":10,"windowSeconds":900},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptInvitationRequest"}}}}}},"/api/console/roles":{"get":{"operationId":"get_api_console_roles","summary":"Console roles and permissions","tags":["Console"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/api/console/team":{"get":{"operationId":"get_api_console_team","summary":"Team members of the active organization","tags":["Console"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:read"]}},"/v1/merchants":{"post":{"operationId":"post_v1_merchants","summary":"Create a merchant in your organization (test mode until live activation)","tags":["Merchants"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Merchant"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMerchantRequest"}}}}}},"/v1/merchants/{id}":{"get":{"operationId":"get_v1_merchants_id","summary":"Retrieve a merchant in your organization","tags":["Merchants"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^mer_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Merchant"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:read"]}},"/v1/merchant":{"get":{"operationId":"get_v1_merchant","summary":"The authenticated merchant, including the live-activation checklist","tags":["Merchants"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Merchant"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:read"]},"patch":{"operationId":"patch_v1_merchant","summary":"Update brand, settlement wallet, support email and notification settings","description":"Changing `default_settlement` is a high-risk operation: API keys must sign the request, and console users re-enter their password (`step_up_password`). Owners and admins are emailed, and live payments do not use the new wallet until it is verified again.","tags":["Merchants"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Merchant"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"type":"string","minLength":1,"maxLength":80},"brand_color":{"anyOf":[{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"},{"type":"null"}]},"logo_url":{"anyOf":[{"type":"string","maxLength":500,"format":"uri"},{"type":"null"}]},"support_email":{"anyOf":[{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"default_settlement":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64}},"required":["asset_id","address"]},"notification_settings":{"type":"object","properties":{"customer_receipts":{"type":"boolean"},"failure_alerts_email":{"anyOf":[{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]}}},"checkout_return_origins":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":200}},"step_up_password":{"type":"string","maxLength":256}}}}}}}},"/v1/merchant/onboarding/{step}":{"post":{"operationId":"post_v1_merchant_onboarding_step","summary":"Complete a merchant-owned onboarding step","tags":["Merchants"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"step","in":"path","required":true,"schema":{"type":"string","enum":["agreement","settlement_destination","webhooks_or_polling"]}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Merchant"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"]}},"/v1/merchant/live-activation":{"post":{"operationId":"post_v1_merchant_live_activation","summary":"Submit the merchant for live-mode review","tags":["Merchants"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Merchant"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"]}},"/v1/api-keys":{"get":{"operationId":"get_v1_api_keys","summary":"List API keys (secrets are never returned after creation)","tags":["API keys"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["test","live","all"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["api_keys:write"]},"post":{"operationId":"post_v1_api_keys","summary":"Create an API key with a subset of your own scopes","description":"The secret (and request-signing secret for secret keys) is returned exactly once. API-key callers must sign this request.","tags":["API keys"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/RequestSignature"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKey"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["api_keys:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyRequest"}}}}}},"/v1/api-keys/{id}":{"delete":{"operationId":"delete_v1_api_keys_id","summary":"Revoke an API key (immediate and permanent)","tags":["API keys"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^key_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKey"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["api_keys:write"]}},"/v1/team/invitations":{"post":{"operationId":"post_v1_team_invitations","summary":"Invite a team member (console only)","tags":["Team"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInvitationRequest"}}}}},"get":{"operationId":"get_v1_team_invitations","summary":"Pending team invitations (email masked)","tags":["Team"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:read"]}},"/v1/team/invitations/{id}":{"delete":{"operationId":"delete_v1_team_invitations_id","summary":"Revoke a pending invitation (its link stops working)","tags":["Team"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"]}},"/v1/team/members/{id}":{"delete":{"operationId":"delete_v1_team_members_id","summary":"Remove a member from the organization (access ends immediately)","tags":["Team"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^usr_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"]}},"/v1/protocols":{"get":{"operationId":"get_v1_protocols","summary":"Supported agent payment protocols, versions, schemes, networks and assets","tags":["Agent payments"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProtocolCapabilitiesList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:read"]}},"/v1/protocols/{protocol}/capabilities":{"get":{"operationId":"get_v1_protocols_protocol_capabilities","summary":"Capabilities of one protocol adapter in this mode","tags":["Agent payments"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"protocol","in":"path","required":true,"schema":{"type":"string","enum":["x402","mpp"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProtocolCapabilities"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:read"]}},"/v1/protocols/{protocol}/challenges":{"post":{"operationId":"post_v1_protocols_protocol_challenges","summary":"Create a payment challenge for a paid resource request","description":"Returns the protocol transaction and, in `response`, the exact HTTP status and headers (e.g. `402` + `PAYMENT-REQUIRED`, or `WWW-Authenticate: Payment`) your resource server sends to the agent. Each challenge is a payment intent settled by direct transfer to your wallet.","tags":["Agent payments"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"protocol","in":"path","required":true,"schema":{"type":"string","enum":["x402","mpp"]}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProtocolTransaction"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:write"],"x-rate-limit":{"bucket":"protocol_challenges","limit":1200,"windowSeconds":60,"by":"merchant"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProtocolChallengeRequest"}}}}}},"/v1/protocols/{protocol}/verify":{"post":{"operationId":"post_v1_protocols_protocol_verify","summary":"Verify an agent's payment (headers exactly as received) and bind it to the plan","description":"Idempotent by the signed authorization: repeating the same paid request returns the same protocol transaction without a second charge; a reused nonce for other terms is rejected as a replay. On failure `response` carries the protocol error to return to the agent. Failed verifications are throttled per agent wallet, principal, IP and merchant.","tags":["Agent payments"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"protocol","in":"path","required":true,"schema":{"type":"string","enum":["x402","mpp"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProtocolTransaction"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:write"],"x-rate-limit":{"bucket":"protocol_verify","limit":1200,"windowSeconds":60,"by":"merchant"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyProtocolPaymentRequest"}}}}}},"/v1/protocols/{protocol}/settle":{"post":{"operationId":"post_v1_protocols_protocol_settle","summary":"Settle a verified, bound payment (facilitator broadcast; finality is verified on chain)","description":"Idempotent. `response` carries the success header for the agent (`PAYMENT-RESPONSE` / `Payment-Receipt`). The protocol transaction becomes SETTLED, and the receipt is issued, only after the transfer is observed on chain with finality.","tags":["Agent payments"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"protocol","in":"path","required":true,"schema":{"type":"string","enum":["x402","mpp"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProtocolTransaction"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettleProtocolPaymentRequest"}}}}}},"/v1/protocol-transactions":{"get":{"operationId":"get_v1_protocol_transactions","summary":"List recent protocol transactions (newest first)","tags":["Agent payments"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"ending_before","in":"query","required":false,"schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProtocolTransactionList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:read"]}},"/v1/protocol-transactions/{id}":{"get":{"operationId":"get_v1_protocol_transactions_id","summary":"Retrieve a protocol transaction","tags":["Agent payments"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ptx_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProtocolTransaction"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:read"]}},"/v1/agent-principals":{"post":{"operationId":"post_v1_agent_principals","summary":"Register an agent principal (the person or organization an agent acts for) and its agents","description":"Agents are identified by the public wallet address they pay from. Never send private keys.","tags":["Agent authorizations"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentPrincipal"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgentPrincipalRequest"}}}}},"get":{"operationId":"get_v1_agent_principals","summary":"List agent principals","tags":["Agent authorizations"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentPrincipalList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:read"]}},"/v1/agent-principals/{id}":{"get":{"operationId":"get_v1_agent_principals_id","summary":"Retrieve an agent principal","tags":["Agent authorizations"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^agp_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentPrincipal"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:read"]}},"/v1/agent-principals/{id}/agents":{"post":{"operationId":"post_v1_agent_principals_id_agents","summary":"Add an agent (wallet identity) to a principal","tags":["Agent authorizations"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^agp_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentPrincipal"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityInput"}}}}}},"/v1/agent-principals/{id}/{action}":{"post":{"operationId":"post_v1_agent_principals_id_action","summary":"Disable or re-enable a principal (disabled principals cannot pay)","tags":["Agent authorizations"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^agp_[0-9A-Za-z]{16,40}$"}},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["disable","enable"]}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentPrincipal"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:write"]}},"/v1/agent-principals/{id}/agents/{agent_id}/{action}":{"post":{"operationId":"post_v1_agent_principals_id_agents_agent_id_action","summary":"Disable or re-enable one agent (wallet identity) of a principal","tags":["Agent authorizations"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^agp_[0-9A-Za-z]{16,40}$"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","pattern":"^agi_[0-9A-Za-z]{16,40}$"}},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["disable","enable"]}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentPrincipal"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:write"]}},"/v1/agent-authorizations":{"post":{"operationId":"post_v1_agent_authorizations","summary":"Authorize an agent to spend within platform-enforced limits","description":"Limits are enforced by the platform even where the payment protocol has no equivalent field: per transaction, per day, per month, allowed protocols/assets/networks/resources and a replay window. `inspection_token` is returned once so the principal can inspect usage.","tags":["Agent authorizations"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAuthorization"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgentAuthorizationRequest"}}}}},"get":{"operationId":"get_v1_agent_authorizations","summary":"List agent authorizations","tags":["Agent authorizations"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"principal_id","in":"query","required":false,"schema":{"type":"string","pattern":"^agp_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAuthorizationList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:read"]}},"/v1/agent-authorizations/{id}":{"get":{"operationId":"get_v1_agent_authorizations_id","summary":"Retrieve an agent authorization","tags":["Agent authorizations"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^aga_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAuthorization"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:read"]}},"/v1/agent-authorizations/{id}/revoke":{"post":{"operationId":"post_v1_agent_authorizations_id_revoke","summary":"Revoke immediately (in-flight unsettled payments are stopped before funds move)","tags":["Agent authorizations"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^aga_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAuthorization"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokeAgentAuthorizationRequest"}}}}}},"/v1/agent-authorizations/{id}/{action}":{"post":{"operationId":"post_v1_agent_authorizations_id_action","summary":"Suspend or resume an agent authorization","tags":["Agent authorizations"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^aga_[0-9A-Za-z]{16,40}$"}},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["suspend","resume"]}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAuthorization"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:write"]}},"/v1/agent-authorizations/{id}/usage":{"get":{"operationId":"get_v1_agent_authorizations_id_usage","summary":"Spend used and reserved today/this month, recent payments and metered usage","tags":["Agent authorizations"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^aga_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAuthorizationUsage"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:read"]}},"/v1/meters":{"post":{"operationId":"post_v1_meters","summary":"Define a meter (unit, price and settlement checkpoints) before usage","tags":["Metering"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Meter"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMeterRequest"}}}}},"get":{"operationId":"get_v1_meters","summary":"List meters","tags":["Metering"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeterList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:read"]}},"/v1/meters/{id}":{"get":{"operationId":"get_v1_meters_id","summary":"Retrieve a meter","tags":["Metering"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^mtr_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Meter"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:read"]}},"/v1/meters/{id}/{action}":{"post":{"operationId":"post_v1_meters_id_action","summary":"Disable or re-enable a meter (outstanding billing records can still be settled)","tags":["Metering"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^mtr_[0-9A-Za-z]{16,40}$"}},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["disable","enable"]}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Meter"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:write"]}},"/v1/meters/{id}/usage":{"post":{"operationId":"post_v1_meters_id_usage","summary":"Record a usage event (deduplicated by source_event_id)","description":"Refused with `authorization_limit_exceeded` (and not recorded) when the projected spend would exceed the agent authorization: stop serving. When the event reaches a checkpoint, the priced `billing_record` and its payment challenge (`settlement.response`) are returned; `usage_settlement_required` means an earlier checkpoint must be paid first.","tags":["Metering"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^mtr_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageEventResult"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["usage:write"],"x-rate-limit":{"bucket":"usage_events","limit":6000,"windowSeconds":60,"by":"merchant"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordUsageRequest"}}}}}},"/v1/meters/{id}/checkpoints":{"post":{"operationId":"post_v1_meters_id_checkpoints","summary":"Price an authorization's unbilled usage now (e.g. at session end) and get its payment challenge","tags":["Metering"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^mtr_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckpointResult"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["usage:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCheckpointRequest"}}}}}},"/v1/billing-records":{"get":{"operationId":"get_v1_billing_records","summary":"List billing records (priced usage)","tags":["Metering"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"meter_id","in":"query","required":false,"schema":{"type":"string","pattern":"^mtr_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingRecordList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:read"]}},"/v1/billing-records/{id}":{"get":{"operationId":"get_v1_billing_records_id","summary":"Retrieve a billing record (immutable pricing, usage range and settlement)","tags":["Metering"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^bill_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingRecord"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["agents:read"]}},"/v1/billing-records/{id}/challenges":{"post":{"operationId":"post_v1_billing_records_id_challenges","summary":"Get (or re-issue) the payment challenge for an unpaid billing record","tags":["Metering"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^bill_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProtocolTransaction"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:write"]}},"/v1/verifier-configurations":{"post":{"operationId":"post_v1_verifier_configurations","summary":"Register a verifier (webhook source, attestors, oracles or approvers)","description":"Only public keys (EVM addresses) are accepted — never private keys. A merchant-affiliated verifier must disclose the relationship. For PLATFORM_WEBHOOK the HMAC signing secret is returned once.","tags":["Conditions"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifierConfiguration"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["conditions:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateVerifierConfigurationRequest"}}}}},"get":{"operationId":"get_v1_verifier_configurations","summary":"List verifier configurations","tags":["Conditions"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifierConfigurationList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["conditions:read"]}},"/v1/verifier-configurations/{id}":{"get":{"operationId":"get_v1_verifier_configurations_id","summary":"Retrieve a verifier configuration","tags":["Conditions"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^vcfg_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifierConfiguration"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["conditions:read"]}},"/v1/verifier-configurations/{id}/revoke":{"post":{"operationId":"post_v1_verifier_configurations_id_revoke","summary":"Revoke a verifier (e.g. a compromised key)","description":"Conditions it satisfied whose funds are still held are reversed by a new, superseding verification result. Nothing already released changes.","tags":["Conditions"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^vcfg_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"verifier_configuration"},"livemode":{"type":"boolean"},"type":{"type":"string","enum":["TIME","BUYER_APPROVAL","MERCHANT_FULFILLMENT","PLATFORM_WEBHOOK","SIGNED_ATTESTATION","COMPUTE_RESULT","ORACLE_EVENT","MILESTONE","NO_DISPUTE_WINDOW","MULTI_APPROVAL"]},"name":{"type":"string"},"schema_version":{"type":"string"},"public_keys":{"type":"array","items":{"type":"string"}},"threshold":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"affiliation":{"type":"string","enum":["independent","merchant","platform"]},"self_dealing_disclosure":{"type":["string","null"]},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"config_hash":{"type":"string"},"status":{"type":"string","enum":["active","revoked"]},"webhook_url":{"type":["string","null"]},"webhook_secret":{"type":["string","null"]},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"reversed_conditions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","object","livemode","type","name","schema_version","public_keys","threshold","affiliation","self_dealing_disclosure","config","config_hash","status","webhook_url","webhook_secret","revoked_at","created_at","reversed_conditions"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["conditions:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":300}},"required":["reason"]}}}}}},"/v1/payment-intents/{id}/conditions":{"get":{"operationId":"get_v1_payment_intents_id_conditions","summary":"A conditional payment's conditions with evidence hashes and signed verification results","tags":["Conditions"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConditionList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["conditions:read"]}},"/v1/payment-intents/{id}/evidence":{"post":{"operationId":"post_v1_payment_intents_id_evidence","summary":"Submit evidence for one of the payment’s conditions","description":"Files (PDF, PNG, JPEG, JSON, text; max 5 MB each) are content-checked and malware-scanned, stored encrypted, and only their SHA-256 hashes are ever shown. Invalid evidence is recorded and refused with `evidence_invalid` (422).","tags":["Conditions"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Condition"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["conditions:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitEvidenceRequest"}}}}}},"/v1/conditions/{id}":{"get":{"operationId":"get_v1_conditions_id","summary":"Retrieve a condition","tags":["Conditions"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^cond_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Condition"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["conditions:read"]}},"/v1/conditions/{id}/evidence":{"post":{"operationId":"post_v1_conditions_id_evidence","summary":"Submit evidence for a condition (of a conditional payment or of an escrow)","description":"Same checks as payment-intent evidence: files (PDF, PNG, JPEG, JSON, text; max 5 MB each) are content-checked and malware-scanned, stored encrypted, and only their SHA-256 hashes are shown.","tags":["Conditions"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^cond_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Condition"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["conditions:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"payload":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"files":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"content_type":{"type":"string","maxLength":80},"content_base64":{"type":"string","maxLength":7000000}},"required":["name","content_type","content_base64"]}}}}}}}}},"/v1/hold-adapters":{"get":{"operationId":"get_v1_hold_adapters","summary":"Hold adapters: who holds the funds, supported assets and durations, and availability","tags":["Escrows"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["escrows:read"]}},"/v1/conditions/{id}/recheck":{"post":{"operationId":"post_v1_conditions_id_recheck","summary":"Re-evaluate a condition (state conditions now; satisfied evidence against the current verifier)","tags":["Conditions"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^cond_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Condition"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["conditions:write"]}},"/v1/escrows":{"post":{"operationId":"post_v1_escrows","summary":"Create an escrow with release conditions or milestones","description":"The release destination is fixed at creation and enforced by the database. Test mode holds funds with the sandbox escrow; live holds need an approved hold adapter and are refused until one is configured.","tags":["Escrows"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Escrow"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["escrows:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEscrowRequest"}}}}},"get":{"operationId":"get_v1_escrows","summary":"List escrows","tags":["Escrows"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"ending_before","in":"query","required":false,"schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscrowList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["escrows:read"]}},"/v1/escrows/{id}":{"get":{"operationId":"get_v1_escrows_id","summary":"Retrieve an escrow (balances, conditions, milestones, pending signature actions)","tags":["Escrows"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^esc_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Escrow"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["escrows:read"]}},"/v1/escrows/{id}/fund":{"post":{"operationId":"post_v1_escrows_id_fund","summary":"Create (or return) the payment intent that funds the escrow through the hosted checkout","tags":["Escrows"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^esc_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"escrow":{"$ref":"#/components/schemas/Escrow"},"payment_intent":{"$ref":"#/components/schemas/PaymentIntent"}},"required":["escrow","payment_intent"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["escrows:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundEscrowRequest"}}}}}},"/v1/escrows/{id}/release":{"post":{"operationId":"post_v1_escrows_id_release","summary":"Release held funds to the fixed destination (all conditions must be satisfied)","tags":["Escrows"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^esc_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/RequestSignature"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Escrow"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["escrows:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoveEscrowFundsRequest"}}}}}},"/v1/escrows/{id}/refund":{"post":{"operationId":"post_v1_escrows_id_refund","summary":"Return held funds to the payer's fixed refund destination","tags":["Escrows"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^esc_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/RequestSignature"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Escrow"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["escrows:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoveEscrowFundsRequest"}}}}}},"/v1/escrows/{id}/milestones":{"post":{"operationId":"post_v1_escrows_id_milestones","summary":"Amend unreleased milestones with the payer’s consent (new signed version)","tags":["Escrows"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^esc_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Escrow"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["escrows:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmendMilestonesRequest"}}}}}},"/v1/milestones/{id}/submit":{"post":{"operationId":"post_v1_milestones_id_submit","summary":"Submit a deliverable for a milestone (starts its review window)","tags":["Escrows"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ms_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Milestone"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["escrows:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitMilestoneRequest"}}}}}},"/v1/milestones/{id}/approve":{"post":{"operationId":"post_v1_milestones_id_approve","summary":"Relay the payer's approval (or rejection) of a submitted milestone","description":"Requires the payer’s buyer-access token: a merchant cannot approve its own milestone.","tags":["Escrows"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ms_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Milestone"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["escrows:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"decision":{"default":"approve","type":"string","enum":["approve","reject"]},"reason":{"type":"string","maxLength":300},"payer_token":{"type":"string","pattern":"^btok_[0-9A-Za-z]{16,80}$"}},"required":["payer_token"]}}}}}},"/v1/milestones/{id}/dispute":{"post":{"operationId":"post_v1_milestones_id_dispute","summary":"Open a dispute about a milestone (the escrow must define a dispute policy)","tags":["Disputes"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ms_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["disputes:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["reason"]}}}}}},"/v1/escrows/{id}/disputes":{"post":{"operationId":"post_v1_escrows_id_disputes","summary":"Open a dispute on a funded escrow (optionally about one condition)","tags":["Disputes"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^esc_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["disputes:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenDisputeRequest"}}}}}},"/v1/disputes":{"get":{"operationId":"get_v1_disputes","summary":"List disputes","tags":["Disputes"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"ending_before","in":"query","required":false,"schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["disputes:read"]}},"/v1/disputes/{id}":{"get":{"operationId":"get_v1_disputes_id","summary":"Retrieve a dispute (evidence is shown as hashes only)","tags":["Disputes"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^dsp_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["disputes:read"]}},"/v1/disputes/{id}/evidence":{"post":{"operationId":"post_v1_disputes_id_evidence","summary":"Add the merchant’s statement and files to a dispute","tags":["Disputes"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^dsp_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["disputes:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeEvidenceRequest"}}}}}},"/v1/disputes/{id}/{action}":{"post":{"operationId":"post_v1_disputes_id_action","summary":"Appeal a decision within its appeal window, or withdraw a dispute the merchant opened","tags":["Disputes"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^dsp_[0-9A-Za-z]{16,40}$"}},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["appeal","withdraw"]}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["disputes:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["reason"]}}}}}},"/v1/policy-destinations":{"post":{"operationId":"post_v1_policy_destinations","summary":"Register a settlement destination wallet referenced by settlement policies","description":"The address is validated for the network, encrypted at rest and immutable. Ownership must be verified before an active policy may use it.","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyDestination"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePolicyDestinationRequest"}}}}},"get":{"operationId":"get_v1_policy_destinations","summary":"List policy destinations","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyDestinationList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:read"]}},"/v1/policy-destinations/{id}":{"get":{"operationId":"get_v1_policy_destinations_id","summary":"Retrieve a policy destination (including its ownership challenge)","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^dest_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyDestination"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:read"]}},"/v1/policy-destinations/{id}/verify":{"post":{"operationId":"post_v1_policy_destinations_id_verify","summary":"Verify destination ownership (wallet signature, or attestation with step-up)","description":"`signature`: sign the ownership challenge with the destination wallet (EIP-191 personal_sign on EVM networks, an ed25519 message signature on Solana). `attestation`: console users re-enter their password; API keys must sign the request.","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^dest_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyDestination"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyPolicyDestinationRequest"}}}}}},"/v1/policy-destinations/{id}/disable":{"post":{"operationId":"post_v1_policy_destinations_id_disable","summary":"Disable a destination (refused while an active policy uses it)","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^dest_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyDestination"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:write"]}},"/v1/settlement-policies/validate":{"post":{"operationId":"post_v1_settlement_policies_validate","summary":"Validate a policy document without saving it (live validation)","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyValidation"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:read"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatePolicyRequest"}}}}}},"/v1/settlement-policies":{"post":{"operationId":"post_v1_settlement_policies","summary":"Create a settlement policy (version 1), optionally activating it","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementPolicy"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSettlementPolicyRequest"}}}}},"get":{"operationId":"get_v1_settlement_policies","summary":"List settlement policies","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementPolicyList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:read"]}},"/v1/settlement-policies/{id}":{"get":{"operationId":"get_v1_settlement_policies_id","summary":"Retrieve a settlement policy with every (immutable) version","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pol_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementPolicy"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:read"]}},"/v1/settlement-policies/{id}/versions":{"post":{"operationId":"post_v1_settlement_policies_id_versions","summary":"Add a new immutable version, optionally activating it","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pol_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementPolicy"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePolicyVersionRequest"}}}}}},"/v1/settlement-policies/{id}/activate":{"post":{"operationId":"post_v1_settlement_policies_id_activate","summary":"Activate a version (re-validated against current destinations and capabilities)","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pol_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementPolicy"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivatePolicyRequest"}}}}}},"/v1/settlement-policies/{id}/deactivate":{"post":{"operationId":"post_v1_settlement_policies_id_deactivate","summary":"Deactivate a policy (new intents can no longer use it)","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pol_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementPolicy"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:write"]}},"/v1/settlement-policies/{id}/simulate":{"post":{"operationId":"post_v1_settlement_policies_id_simulate","summary":"Simulate a policy: dry-run plan with live quotes, or replay recent stored quotes","tags":["Settlement policies"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pol_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["policies:read"],"x-rate-limit":{"bucket":"quotes","limit":30,"windowSeconds":60,"by":"merchant"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulatePolicyRequest"}}}}}},"/v1/payment-intents/{id}/plans":{"post":{"operationId":"post_v1_payment_intents_id_plans","summary":"Compile an execution plan for a funding asset (or a dry run)","tags":["Execution plans"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionPlanResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["plans:write"],"x-rate-limit":{"bucket":"quotes","limit":60,"windowSeconds":60,"by":"merchant"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateExecutionPlanRequest"}}}}}},"/v1/execution-plans/{id}":{"get":{"operationId":"get_v1_execution_plans_id","summary":"Retrieve an execution plan with step and leg status","tags":["Execution plans"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plan_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionPlanResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["plans:read"]}},"/v1/execution-plans/{id}/authorize":{"post":{"operationId":"post_v1_execution_plans_id_authorize","summary":"Authorize a plan on behalf of the payer (bound to the plan hash)","description":"Use when the payer accepted the plan in your own interface. The plan hash you show must be the hash you send; a mismatch or a second authorization is rejected.","tags":["Execution plans"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plan_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionPlanResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["plans:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizeExecutionPlanRequest"}}}}}},"/v1/execution-plans/{id}/cancel":{"post":{"operationId":"post_v1_execution_plans_id_cancel","summary":"Cancel a plan before any deposit instructions were issued","tags":["Execution plans"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plan_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionPlanResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["plans:write"]}},"/v1/execution-plans/{id}/explanation":{"get":{"operationId":"get_v1_execution_plans_id_explanation","summary":"Human-readable explanation with every candidate route and its rejection reasons","tags":["Execution plans"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plan_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionPlanExplanation"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["plans:read"]}},"/v1/payment-links":{"post":{"operationId":"post_v1_payment_links","summary":"Create a reusable or single-use payment link","tags":["Payment links"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentLink"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payment_links:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePaymentLinkRequest"}}}}},"get":{"operationId":"get_v1_payment_links","summary":"List payment links","tags":["Payment links"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"ending_before","in":"query","required":false,"schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentLinkList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payment_links:read"]}},"/v1/payment-links/{id}":{"get":{"operationId":"get_v1_payment_links_id","summary":"Retrieve a payment link","tags":["Payment links"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plink_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentLink"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payment_links:read"]},"patch":{"operationId":"patch_v1_payment_links_id","summary":"Update a payment link (optimistic concurrency via version)","tags":["Payment links"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plink_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentLink"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payment_links:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePaymentLinkRequest"}}}}}},"/v1/payment-links/{id}/deactivate":{"post":{"operationId":"post_v1_payment_links_id_deactivate","summary":"Deactivate a payment link","tags":["Payment links"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plink_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentLink"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payment_links:write"]}},"/v1/payment-links/{id}/activate":{"post":{"operationId":"post_v1_payment_links_id_activate","summary":"Reactivate a payment link","tags":["Payment links"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plink_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentLink"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payment_links:write"]}},"/v1/refunds":{"post":{"operationId":"post_v1_refunds","summary":"Refund a settled payment (merchant-funded, routed through a provider)","description":"Refunds go to the payer’s refund address on file. A different destination requires the refunds:write_new_destination scope and a Route-Request-Signature (API keys) or password step-up (console). The response includes provider deposit instructions the merchant must fund.","tags":["Refunds"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Refund"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["refunds:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/CreateRefundRequest"},{"type":"object","properties":{"step_up_password":{"type":"string","maxLength":256}}}]}}}}},"get":{"operationId":"get_v1_refunds","summary":"List refunds","tags":["Refunds"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"ending_before","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"payment_intent_id","in":"query","required":false,"schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["refunds:read"]}},"/v1/refunds/{id}":{"get":{"operationId":"get_v1_refunds_id","summary":"Retrieve a refund","tags":["Refunds"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^re_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Refund"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["refunds:read"]}},"/v1/webhook-endpoints":{"post":{"operationId":"post_v1_webhook_endpoints","summary":"Create a webhook endpoint (the signing secret is returned once)","tags":["Webhooks"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["webhooks:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookEndpointRequest"}}}}},"get":{"operationId":"get_v1_webhook_endpoints","summary":"List webhook endpoints","tags":["Webhooks"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["webhooks:read"]}},"/v1/webhook-endpoints/{id}":{"patch":{"operationId":"patch_v1_webhook_endpoints_id","summary":"Update an endpoint or rotate its signing secret","tags":["Webhooks"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^we_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["webhooks:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookEndpointRequest"}}}}},"delete":{"operationId":"delete_v1_webhook_endpoints_id","summary":"Delete (permanently disable) an endpoint","tags":["Webhooks"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^we_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["webhooks:write"]}},"/v1/webhook-events":{"get":{"operationId":"get_v1_webhook_events","summary":"Event log with delivery attempts","tags":["Webhooks"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"ending_before","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"type","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"resource_id","in":"query","required":false,"schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEventList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["webhooks:read"]}},"/v1/webhook-events/{id}/replay":{"post":{"operationId":"post_v1_webhook_events_id_replay","summary":"Replay an event to its endpoints (or one endpoint)","tags":["Webhooks"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^evt_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["webhooks:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplayWebhookEventRequest"}}}}}},"/v1/batches":{"post":{"operationId":"post_v1_batches","summary":"Upload a payout batch (validated in full before execution)","description":"Rows are validated (asset, amount precision, address, memo, duplicates) and must match the control totals. Re-uploading the same file returns the existing batch. Large batches require a second approver. API-key callers must sign this request.","tags":["Payouts"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/RequestSignature"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutBatch"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payouts:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePayoutBatchRequest"}}}}},"get":{"operationId":"get_v1_batches","summary":"List payout batches (newest first; rows are not included)","tags":["Payouts"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"ending_before","in":"query","required":false,"schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutBatchList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payouts:read"]}},"/v1/batches/{id}":{"get":{"operationId":"get_v1_batches_id","summary":"Retrieve a payout batch with per-row status","tags":["Payouts"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pob_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutBatch"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payouts:read"]}},"/v1/batches/{id}/approve":{"post":{"operationId":"post_v1_batches_id_approve","summary":"Approve a batch (must be a different person than the submitter)","tags":["Payouts"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pob_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutBatch"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["approvals:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovePayoutBatchRequest"}}}}}},"/v1/batches/{id}/cancel":{"post":{"operationId":"post_v1_batches_id_cancel","summary":"Cancel a batch that has not been submitted","tags":["Payouts"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pob_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutBatch"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payouts:write"]}},"/v1/batches/{id}/reconciliation.csv":{"get":{"operationId":"get_v1_batches_id_reconciliation_csv","summary":"Download the batch reconciliation (CSV)","tags":["Payouts"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pob_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"text/csv":{"schema":{"type":"string"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payouts:read"]}},"/v1/recurring-schedules":{"post":{"operationId":"post_v1_recurring_schedules","summary":"Create a recurring invoice schedule (never pulls funds)","tags":["Recurring"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecurringSchedule"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["recurring:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRecurringScheduleRequest"}}}}},"get":{"operationId":"get_v1_recurring_schedules","summary":"List recurring schedules","tags":["Recurring"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"ending_before","in":"query","required":false,"schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecurringScheduleList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["recurring:read"]}},"/v1/recurring-schedules/{id}":{"get":{"operationId":"get_v1_recurring_schedules_id","summary":"Retrieve a recurring schedule with upcoming occurrences","tags":["Recurring"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^rsch_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecurringSchedule"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["recurring:read"]}},"/v1/recurring-schedules/{id}/{action}":{"post":{"operationId":"post_v1_recurring_schedules_id_action","summary":"Pause, resume or cancel a schedule","tags":["Recurring"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^rsch_[0-9A-Za-z]{16,40}$"}},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["pause","resume","cancel"]}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecurringSchedule"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["recurring:write"]}},"/v1/exports/transactions.csv":{"get":{"operationId":"get_v1_exports_transactions_csv","summary":"Transactions CSV for a date range (UTC, max 366 days)","tags":["Exports"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"text/csv":{"schema":{"type":"string"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["exports:read"],"x-rate-limit":{"bucket":"exports","limit":20,"windowSeconds":3600,"by":"merchant"}}},"/v1/exports/receipts.jsonl":{"get":{"operationId":"get_v1_exports_receipts_jsonl","summary":"Signed receipts issued in a date range, one per line (UTC, max 366 days, 50,000 receipts)","description":"Each line is exactly the receipt `GET /v1/receipts/:id` returns and verifies offline against `/.well-known/receipt-keys.json`. Superseded receipts are included. `Receipts-Truncated: true` means the range holds more receipts: narrow it.","tags":["Exports"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/x-ndjson":{"schema":{"type":"string"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["exports:read"],"x-rate-limit":{"bucket":"exports","limit":20,"windowSeconds":3600,"by":"merchant"}}},"/v1/payment-intents":{"post":{"operationId":"post_v1_payment_intents","summary":"Create a payment intent","description":"Declare the settlement outcome (exact output). The payer chooses how to pay on the hosted page or through a supported protocol. Returns the hosted URL.","tags":["Payment intents"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntent"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payment_intents:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePaymentIntentRequest"}}}}},"get":{"operationId":"get_v1_payment_intents","summary":"List payment intents","tags":["Payment intents"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"ending_before","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["DRAFT","OPEN","QUOTED","AUTHORIZED","FUNDING_PENDING","FUNDED","CONDITION_PENDING","ROUTING","PARTIALLY_SETTLED","SETTLED","RECEIPT_ISSUED","EXPIRED","REVIEW_REQUIRED","REFUND_PENDING","REFUNDED","FAILED","CANCELED"]}},{"name":"external_reference","in":"query","required":false,"schema":{"type":"string","maxLength":128}},{"name":"created_gte","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},{"name":"created_lte","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntentList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payment_intents:read"]}},"/v1/payment-intents/{id}":{"get":{"operationId":"get_v1_payment_intents_id","summary":"Retrieve a payment intent","tags":["Payment intents"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntent"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payment_intents:read"]}},"/v1/payment-intents/{id}/timeline":{"get":{"operationId":"get_v1_payment_intents_id_timeline","summary":"A payment's history: status changes, order milestones, refunds and receipts","tags":["Payment intents"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/TimelineEntry"}}},"required":["object","data"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payment_intents:read"]}},"/v1/payment-intents/{id}/cancel":{"post":{"operationId":"post_v1_payment_intents_id_cancel","summary":"Cancel a payment intent before the payer authorizes it","tags":["Payment intents"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntent"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["payment_intents:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":200}}}}}}}},"/.well-known/payment-capabilities":{"get":{"operationId":"get__well_known_payment_capabilities","summary":"Machine-readable agent payment capabilities (protocols, versions, networks, assets, receipts)","tags":["Agent payments"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentCapabilities"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":600,"windowSeconds":60}}},"/api/agent-authorizations/{id}/usage":{"get":{"operationId":"get_api_agent_authorizations_id_usage","summary":"Payer inspection of an agent authorization (requires the inspection token)","description":"Send the inspection token as `Authorization: Bearer insp_…`. The `token` query parameter is still accepted for links shared before the header was supported, but it can leak into logs and referrers.","tags":["Agent payments"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^aga_[0-9A-Za-z]{16,40}$"}},{"name":"token","in":"query","required":false,"schema":{"type":"string","pattern":"^insp_[0-9A-Za-z]{16,80}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentAuthorizationUsage"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":120,"windowSeconds":60}}},"/api/protocol-transactions/{id}":{"get":{"operationId":"get_api_protocol_transactions_id","summary":"Status of an agent payment and its receipt once issued (payer view)","tags":["Agent payments"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ptx_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProtocolTransactionStatus"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":240,"windowSeconds":60}}},"/api/assets":{"get":{"operationId":"get_api_assets","summary":"List supported assets and networks","tags":["Public checkout"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":300,"windowSeconds":60}}},"/api/pairs/{from}/{to}":{"get":{"operationId":"get_api_pairs_from_to","summary":"Deposit limits and indicative rates for a pair across eligible providers","tags":["Public checkout"],"security":[],"parameters":[{"name":"from","in":"path","required":true,"schema":{"type":"string","maxLength":40}},{"name":"to","in":"path","required":true,"schema":{"type":"string","maxLength":40}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pair"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":300,"windowSeconds":60}}},"/api/payment-intents":{"post":{"operationId":"post_api_payment_intents","summary":"Create a payment link from the minimal hosted form (no account required)","description":"Creates an exact-output payment intent owned by the public payment-link workspace. Merchants should use POST /v1/payment-intents.","tags":["Public checkout"],"security":[],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPaymentIntent"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_create","limit":20,"windowSeconds":3600},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePaymentIntentRequest"}}}}}},"/api/payment-intents/{id}":{"get":{"operationId":"get_api_payment_intents_id","summary":"Hosted checkout view of a payment intent","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPaymentIntent"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":300,"windowSeconds":60}}},"/api/payment-intents/{id}/quotes":{"post":{"operationId":"post_api_payment_intents_id_quotes","summary":"Quote the payer asset for a payment intent (exact output when supported)","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"quotes","limit":30,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateIntentQuoteRequest"}}}}}},"/api/payment-intents/{id}/confirm":{"post":{"operationId":"post_api_payment_intents_id_confirm","summary":"Confirm a quote and create the provider order (returns deposit instructions)","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicOrder"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"orders","limit":10,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmIntentRequest"}}}}}},"/api/quotes":{"post":{"operationId":"post_api_quotes","summary":"Consumer swap quote (secondary /swap surface)","tags":["Public checkout"],"security":[],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"quotes","limit":30,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSwapQuoteRequest"}}}}}},"/api/orders":{"post":{"operationId":"post_api_orders","summary":"Create a consumer swap order from a swap quote","tags":["Public checkout"],"security":[],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicOrder"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"orders","limit":10,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSwapOrderRequest"}}}}}},"/api/orders/{id}":{"get":{"operationId":"get_api_orders_id","summary":"Live order status (public order lookup)","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ord_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicOrder"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"tracking","limit":240,"windowSeconds":60}}},"/api/receipts/{id}":{"get":{"operationId":"get_api_receipts_id","summary":"Signed settlement receipt (payer view)","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^rcpt_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Receipt"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":120,"windowSeconds":60}}},"/api/orders/{id}/notifications":{"post":{"operationId":"post_api_orders_id_notifications","summary":"Subscribe to email status notifications for an order","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ord_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"notifications","limit":5,"windowSeconds":3600},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationSubscriptionRequest"}}}}}},"/api/support":{"post":{"operationId":"post_api_support","summary":"Open an order-linked support case","description":"Support automatically receives the public and provider order ids. Support will never ask for a seed phrase or private key.","tags":["Public checkout"],"security":[],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"support","limit":10,"windowSeconds":3600},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportRequest"}}}}}},"/api/events":{"post":{"operationId":"post_api_events","summary":"Record a client-side funnel event (non-identifying, allowlisted events only)","tags":["Public checkout"],"security":[],"parameters":[],"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"client_events","limit":120,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientAnalyticsEvent"}}}}}},"/api/payment-links/{id}":{"get":{"operationId":"get_api_payment_links_id","summary":"Public view of a payment link","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plink_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPaymentLink"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":300,"windowSeconds":60}}},"/api/payment-links/{id}/open":{"post":{"operationId":"post_api_payment_links_id_open","summary":"Open a payment link: returns the payment intent to pay (new per payer for reusable links)","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plink_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_create","limit":30,"windowSeconds":3600},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenPaymentLinkRequest"}}}}}},"/api/milestones/{id}":{"get":{"operationId":"get_api_milestones_id","summary":"A milestone's named approver or submitter views it through their private link","tags":["Conditional payments (payer)"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ms_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilestoneReview"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"milestone_party_reads","limit":60,"windowSeconds":60}}},"/api/milestones/{id}/submission":{"post":{"operationId":"post_api_milestones_id_submission","summary":"A milestone's named submitter submits the deliverable through their private link","tags":["Conditional payments (payer)"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ms_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilestoneReview"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"milestone_party_submissions","limit":10,"windowSeconds":3600},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitMilestoneRequest"}}}}}},"/api/payment-intents/{id}/conditions":{"get":{"operationId":"get_api_payment_intents_id_conditions","summary":"The conditional terms the payer accepts before paying (plain language, with a terms hash)","tags":["Conditional payments (payer)"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConditionalTerms"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":120,"windowSeconds":60}}},"/api/payment-intents/{id}/conditions/accept":{"post":{"operationId":"post_api_payment_intents_id_conditions_accept","summary":"Accept the conditions (bound to their hash) and fix the refund address","description":"Returns the buyer access token exactly once. Keep it: it is the only way to approve, dispute or add evidence without an account. The platform stores only its hash.","tags":["Conditional payments (payer)"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuyerAccess"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"buyer_accept","limit":10,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptConditionsRequest"}}}}}},"/api/escrows/{id}":{"get":{"operationId":"get_api_escrows_id","summary":"Payer view of an escrow: balances, conditions, milestones and the open dispute","tags":["Conditional payments (payer)"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^esc_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Escrow"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":120,"windowSeconds":60}}},"/api/escrows/{id}/conditions":{"get":{"operationId":"get_api_escrows_id_conditions","summary":"Payer view of the conditions with evidence hashes and signed verification results","tags":["Conditional payments (payer)"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^esc_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}},"required":["object","data"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":120,"windowSeconds":60}}},"/api/conditions/{id}/decision":{"post":{"operationId":"post_api_conditions_id_decision","summary":"The payer approves or rejects a buyer-approval condition","tags":["Conditional payments (payer)"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^cond_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Condition"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"buyer_actions","limit":30,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuyerConditionDecision"}}}}}},"/api/milestones/{id}/decision":{"post":{"operationId":"post_api_milestones_id_decision","summary":"The milestone's approver (the payer, or the named approver with their link code) approves (releasing it) or rejects a submitted milestone","tags":["Conditional payments (payer)"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ms_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Escrow"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"buyer_actions","limit":30,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveMilestoneRequest"}}}}}},"/api/escrows/{id}/disputes":{"post":{"operationId":"post_api_escrows_id_disputes","summary":"The payer opens a dispute while funds are held","tags":["Conditional payments (payer)"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^esc_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"buyer_disputes","limit":5,"windowSeconds":3600},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenDisputeRequest"}}}}}},"/api/disputes/{id}":{"get":{"operationId":"get_api_disputes_id","summary":"Payer view of a dispute (evidence as hashes only)","tags":["Conditional payments (payer)"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^dsp_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":120,"windowSeconds":60}}},"/api/disputes/{id}/evidence":{"post":{"operationId":"post_api_disputes_id_evidence","summary":"The payer adds a statement and files to a dispute","tags":["Conditional payments (payer)"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^dsp_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"buyer_actions","limit":30,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeEvidenceRequest"}}}}}},"/api/disputes/{id}/{action}":{"post":{"operationId":"post_api_disputes_id_action","summary":"The payer appeals a decision in its appeal window, or withdraws a dispute they opened","tags":["Conditional payments (payer)"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^dsp_[0-9A-Za-z]{16,40}$"}},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["appeal","withdraw"]}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dispute"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"buyer_actions","limit":30,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["reason"]}}}}}},"/api/verifier-webhooks/{id}":{"post":{"operationId":"post_api_verifier_webhooks_id","summary":"Signed inbound events from a PLATFORM_WEBHOOK verifier","description":"Body: `{ \"id\": \"<unique event id>\", \"condition_id\": \"cond_…\", \"status\": \"satisfied\" | \"rejected\", \"occurred_at\": \"<RFC 3339>\" }`. Header `Route-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of \"t.body\">` with the configuration secret. Events outside the 5-minute window or reused event ids are refused or acknowledged as duplicates.","tags":["Conditions"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^vcfg_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"received":{"type":"boolean","const":true},"duplicate":{"type":"boolean"},"outcome":{"type":["string","null"]}},"required":["received","duplicate","outcome"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"verifier_webhooks","limit":300,"windowSeconds":60}}},"/api/merchant-logos/{id}":{"get":{"operationId":"get_api_merchant_logos_id","summary":"A merchant's logo for hosted pages (fetched server-side, raster images only)","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^mer_[0-9A-Za-z]{16,40}$"}},{"name":"v","in":"query","required":false,"schema":{"type":"string","maxLength":32}}],"responses":{"200":{"description":"Success","content":{"image/png":{"schema":{"type":"string"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":300,"windowSeconds":60}}},"/api/payment-intents/{id}/plans":{"post":{"operationId":"post_api_payment_intents_id_plans","summary":"Compile an execution plan for the payer’s funding asset (multi-output payments)","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionPlanResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"quotes","limit":30,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateExecutionPlanRequest"}}}}}},"/api/execution-plans/{id}":{"get":{"operationId":"get_api_execution_plans_id","summary":"Payer view of an execution plan: legs, deposit instructions and status","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plan_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionPlanResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":300,"windowSeconds":60}}},"/api/execution-plans/{id}/explanation":{"get":{"operationId":"get_api_execution_plans_id_explanation","summary":"Why this route: selected providers, fees, timing, fallbacks and non-atomicity","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plan_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionPlanExplanation"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":300,"windowSeconds":60}}},"/api/execution-plans/{id}/authorize":{"post":{"operationId":"post_api_execution_plans_id_authorize","summary":"Payer authorizes the plan they reviewed (bound to its plan hash)","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plan_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionPlanResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"orders","limit":20,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizeExecutionPlanRequest"}}}}}},"/api/execution-plans/{id}/steps/{step}/transfer":{"post":{"operationId":"post_api_execution_plans_id_steps_step_transfer","summary":"Report the transaction hash of a direct transfer (verified on-chain before success)","tags":["Public checkout"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^plan_[0-9A-Za-z]{16,40}$"}},{"name":"step","in":"path","required":true,"schema":{"type":"string","pattern":"^transfer_[a-z0-9_]{1,32}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionPlanResponse"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"orders","limit":20,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitDirectTransferRequest"}}}}}},"/v1/commerce/catalog":{"get":{"operationId":"get_v1_commerce_catalog","summary":"The merchant catalog agents buy from (ACP / UCP)","description":"Merchant-authoritative items, prices, tax rates, availability, shipping options and policy links. In test mode, without a stored catalog, the sandbox catalog is served (`source: \"sandbox\"`); in live mode, without one, every item is refused.","tags":["Agent commerce"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:read"]},"put":{"operationId":"put_v1_commerce_catalog","summary":"Replace the merchant catalog (versioned and audited)","description":"Prices are decimals in the catalog currency and must fit its minor units. Open checkout sessions keep the totals they were quoted with; new sessions and updates use the new catalog.","tags":["Agent commerce"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommerceCatalogRequest"}}}}}},"/v1/protocols/ap2/verify":{"post":{"operationId":"post_v1_protocols_ap2_verify","summary":"Verify an AP2 v0.2 Checkout Mandate and Payment Mandate (no side effects)","description":"Verifies SD-JWT signatures against the merchant's trusted issuers, key binding (`sd_hash`), disclosures, expiry, `aud`/`nonce` (the values you issued), payee, amount/currency against the merchant-signed checkout, and every open-mandate constraint. Failures return a signed AP2 Checkout Receipt with `status: \"Error\"`.","tags":["AP2 mandates"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ap2Verification"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:read"],"x-rate-limit":{"bucket":"ap2_verify","limit":600,"windowSeconds":60,"by":"merchant"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ap2VerifyRequest"}}}}}},"/v1/protocols/ap2/intents":{"post":{"operationId":"post_v1_protocols_ap2_intents","summary":"Create a canonical payment intent from verified AP2 mandates","description":"Human-present and delegated (open-mandate) flows. Platform limits apply in addition to mandate limits: merchant caps, the live pilot cap and, when `agent_authorization_id` is given, that authorization's per-transaction/day/month limits (required for delegated payments in live mode). Open-mandate budget and recurrence usage is tracked and only grows. The payment instrument must be `com.routewtf.crypto_checkout`; the payer funds the intent through the hosted checkout.","tags":["AP2 mandates"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ap2Intent"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:write"],"x-rate-limit":{"bucket":"ap2_intents","limit":300,"windowSeconds":60,"by":"merchant"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ap2CreateIntentRequest"}}}}}},"/v1/protocols/ap2/mandates/{id}":{"get":{"operationId":"get_v1_protocols_ap2_mandates_id","summary":"Retrieve an AP2 mandate: status, cumulative usage, linked intent/receipt and AP2 receipts","tags":["AP2 mandates"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^mdt_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ap2Mandate"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:read"]}},"/v1/protocols/ap2/mandates/{id}/revoke":{"post":{"operationId":"post_v1_protocols_ap2_mandates_id_revoke","summary":"Revoke an AP2 mandate (open mandates stop authorizing; a pending payment is canceled)","tags":["AP2 mandates"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^mdt_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ap2Mandate"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokeAp2MandateRequest"}}}}}},"/.well-known/settlement-capabilities":{"get":{"operationId":"get__well_known_settlement_capabilities","summary":"Settlement capability discovery (protocol versions, assets, rails, limits, finality, receipts)","description":"Cacheable for `max-age` seconds; `expires_at` is authoritative. While an emergency kill switch is engaged the document is served with `no-cache` and reflects the suspension.","tags":["Capability negotiation"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementCapabilities"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":600,"windowSeconds":60}}},"/v1/capability-negotiations":{"post":{"operationId":"post_v1_capability_negotiations","summary":"Negotiate capabilities with a counterparty (intersection of offered and supported)","tags":["Capability negotiation"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilityNegotiation"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCapabilityNegotiationRequest"}}}}},"get":{"operationId":"get_v1_capability_negotiations","summary":"Recent capability negotiations, newest first (each with its current status)","tags":["Capability negotiation"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/CapabilityNegotiation"}}},"required":["object","data"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:read"]}},"/v1/settlement-capabilities":{"get":{"operationId":"get_v1_settlement_capabilities","summary":"The capability document as it applies to your account (flags, version pins, limits)","tags":["Capability negotiation"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MerchantSettlementCapabilities"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:read"]}},"/v1/capability-negotiations/{id}":{"get":{"operationId":"get_v1_capability_negotiations_id","summary":"Retrieve a capability negotiation (honours expiry and emergency revocation)","tags":["Capability negotiation"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^cneg_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilityNegotiation"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:read"]}},"/v1/capability-negotiations/{id}/revoke":{"post":{"operationId":"post_v1_capability_negotiations_id_revoke","summary":"Revoke a capability negotiation","tags":["Capability negotiation"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^cneg_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilityNegotiation"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["protocols:write"]}},"/v1/protocols/acp/checkout_sessions":{"post":{"operationId":"post_v1_protocols_acp_checkout_sessions","summary":"ACP: create checkout session","description":"ACP 2026-04-17 wire format (not the platform envelope). Requires `Authorization: Bearer <secret key>` with `protocols:write`, `API-Version: 2026-04-17` and, on POST, `Idempotency-Key`. No delegated-card payment handler is offered (no approved PSP); buyers pay via `continue_url` (hosted crypto checkout) and the session completes when the canonical intent settles.","tags":["ACP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/protocols/acp/checkout_sessions/{id}":{"get":{"operationId":"get_v1_protocols_acp_checkout_sessions_id","summary":"ACP: retrieve checkout session","description":"ACP 2026-04-17 wire format (not the platform envelope). Requires `Authorization: Bearer <secret key>` with `protocols:write`, `API-Version: 2026-04-17` and, on POST, `Idempotency-Key`. No delegated-card payment handler is offered (no approved PSP); buyers pay via `continue_url` (hosted crypto checkout) and the session completes when the canonical intent settles.","tags":["ACP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"operationId":"post_v1_protocols_acp_checkout_sessions_id","summary":"ACP: update checkout session","description":"ACP 2026-04-17 wire format (not the platform envelope). Requires `Authorization: Bearer <secret key>` with `protocols:write`, `API-Version: 2026-04-17` and, on POST, `Idempotency-Key`. No delegated-card payment handler is offered (no approved PSP); buyers pay via `continue_url` (hosted crypto checkout) and the session completes when the canonical intent settles.","tags":["ACP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/protocols/acp/checkout_sessions/{id}/complete":{"post":{"operationId":"post_v1_protocols_acp_checkout_sessions_id_complete","summary":"ACP: complete checkout session (idempotent)","description":"ACP 2026-04-17 wire format (not the platform envelope). Requires `Authorization: Bearer <secret key>` with `protocols:write`, `API-Version: 2026-04-17` and, on POST, `Idempotency-Key`. No delegated-card payment handler is offered (no approved PSP); buyers pay via `continue_url` (hosted crypto checkout) and the session completes when the canonical intent settles.","tags":["ACP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/protocols/acp/checkout_sessions/{id}/cancel":{"post":{"operationId":"post_v1_protocols_acp_checkout_sessions_id_cancel","summary":"ACP: cancel checkout session","description":"ACP 2026-04-17 wire format (not the platform envelope). Requires `Authorization: Bearer <secret key>` with `protocols:write`, `API-Version: 2026-04-17` and, on POST, `Idempotency-Key`. No delegated-card payment handler is offered (no approved PSP); buyers pay via `continue_url` (hosted crypto checkout) and the session completes when the canonical intent settles.","tags":["ACP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/.well-known/ucp":{"get":{"operationId":"get__well_known_ucp","summary":"UCP business profile (keys[] JWK set)","tags":["UCP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/.well-known/ucp-profile.json":{"get":{"operationId":"get__well_known_ucp_profile_json","summary":"UCP business profile (spec §26.9 path)","tags":["UCP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/protocols/ucp/checkout-sessions":{"post":{"operationId":"post_v1_protocols_ucp_checkout_sessions","summary":"UCP: create checkout","description":"UCP 2026-08-25 wire format. Requires the merchant API key (`Authorization: Bearer` or `X-API-Key`), `Request-Id`, `UCP-Agent: profile=\"https://…/.well-known/ucp\"` (a pre-approved platform), RFC 9421 `Signature`/`Signature-Input` with RFC 9530 `Content-Digest` on POST/PUT, and `Idempotency-Key` on POST/PUT. Business refusals are HTTP 200 `error_response`; transport failures use `{code, content}`.","tags":["UCP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/protocols/ucp/checkout-sessions/{id}":{"get":{"operationId":"get_v1_protocols_ucp_checkout_sessions_id","summary":"UCP: get checkout","description":"UCP 2026-08-25 wire format. Requires the merchant API key (`Authorization: Bearer` or `X-API-Key`), `Request-Id`, `UCP-Agent: profile=\"https://…/.well-known/ucp\"` (a pre-approved platform), RFC 9421 `Signature`/`Signature-Input` with RFC 9530 `Content-Digest` on POST/PUT, and `Idempotency-Key` on POST/PUT. Business refusals are HTTP 200 `error_response`; transport failures use `{code, content}`.","tags":["UCP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"put":{"operationId":"put_v1_protocols_ucp_checkout_sessions_id","summary":"UCP: update checkout (full replacement)","description":"UCP 2026-08-25 wire format. Requires the merchant API key (`Authorization: Bearer` or `X-API-Key`), `Request-Id`, `UCP-Agent: profile=\"https://…/.well-known/ucp\"` (a pre-approved platform), RFC 9421 `Signature`/`Signature-Input` with RFC 9530 `Content-Digest` on POST/PUT, and `Idempotency-Key` on POST/PUT. Business refusals are HTTP 200 `error_response`; transport failures use `{code, content}`.","tags":["UCP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"operationId":"post_v1_protocols_ucp_checkout_sessions_id","summary":"UCP: update checkout (spec §26.9 POST alias of PUT)","description":"UCP 2026-08-25 wire format. Requires the merchant API key (`Authorization: Bearer` or `X-API-Key`), `Request-Id`, `UCP-Agent: profile=\"https://…/.well-known/ucp\"` (a pre-approved platform), RFC 9421 `Signature`/`Signature-Input` with RFC 9530 `Content-Digest` on POST/PUT, and `Idempotency-Key` on POST/PUT. Business refusals are HTTP 200 `error_response`; transport failures use `{code, content}`.","tags":["UCP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/protocols/ucp/checkout-sessions/{id}/complete":{"post":{"operationId":"post_v1_protocols_ucp_checkout_sessions_id_complete","summary":"UCP: complete checkout","description":"UCP 2026-08-25 wire format. Requires the merchant API key (`Authorization: Bearer` or `X-API-Key`), `Request-Id`, `UCP-Agent: profile=\"https://…/.well-known/ucp\"` (a pre-approved platform), RFC 9421 `Signature`/`Signature-Input` with RFC 9530 `Content-Digest` on POST/PUT, and `Idempotency-Key` on POST/PUT. Business refusals are HTTP 200 `error_response`; transport failures use `{code, content}`.","tags":["UCP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/protocols/ucp/checkout-sessions/{id}/cancel":{"post":{"operationId":"post_v1_protocols_ucp_checkout_sessions_id_cancel","summary":"UCP: cancel checkout","description":"UCP 2026-08-25 wire format. Requires the merchant API key (`Authorization: Bearer` or `X-API-Key`), `Request-Id`, `UCP-Agent: profile=\"https://…/.well-known/ucp\"` (a pre-approved platform), RFC 9421 `Signature`/`Signature-Input` with RFC 9530 `Content-Digest` on POST/PUT, and `Idempotency-Key` on POST/PUT. Business refusals are HTTP 200 `error_response`; transport failures use `{code, content}`.","tags":["UCP checkout (protocol-native)"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/beneficiaries":{"post":{"operationId":"post_v1_beneficiaries","summary":"Register a bank or on-chain beneficiary","description":"Rail-specific validation (ABA routing checksum, IBAN mod-97, UK sort code, Pix keys, on-chain address formats) and sanctions screening run immediately. Account details are encrypted and never returned; duplicates are detected by a keyed hash. The beneficiary must then be verified (provider validation or micro-deposits) and pass its cooling-off period before it can receive funds.","tags":["Beneficiaries"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Beneficiary"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["beneficiaries:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBeneficiaryRequest"}}}}},"get":{"operationId":"get_v1_beneficiaries","summary":"List beneficiaries (masked)","tags":["Beneficiaries"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"ending_before","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["PENDING_VERIFICATION","VERIFIED","REJECTED","DISABLED"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BeneficiaryList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["beneficiaries:read"]}},"/v1/beneficiaries/{id}":{"get":{"operationId":"get_v1_beneficiaries_id","summary":"Retrieve a beneficiary (masked)","tags":["Beneficiaries"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ben_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Beneficiary"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["beneficiaries:read"]}},"/v1/beneficiaries/{id}/verify":{"post":{"operationId":"post_v1_beneficiaries_id_verify","summary":"Verify a beneficiary (provider validation or micro-deposits)","description":"`provider_validation` asks the fiat provider to validate the account. `micro_deposit` sends two small deposits; confirm with the two amounts (three attempts). A verified beneficiary is usable after its cooling-off period (default 24 hours).","tags":["Beneficiaries"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ben_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Beneficiary"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["beneficiaries:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyBeneficiaryRequest"}}}}}},"/v1/beneficiaries/{id}/disable":{"post":{"operationId":"post_v1_beneficiaries_id_disable","summary":"Disable a beneficiary (transfers not yet at a provider are canceled)","tags":["Beneficiaries"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ben_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Beneficiary"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["beneficiaries:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisableBeneficiaryRequest"}}}}}},"/v1/fiat-quotes":{"post":{"operationId":"post_v1_fiat_quotes","summary":"Quote a stablecoin→fiat, fiat→stablecoin or fiat→fiat transfer","description":"Returns fees, the effective and reference FX rates, the rail cutoff (rolled past weekends and bank holidays), the expected settlement time, the rail’s return risk, and for off-ramps the provider deposit address the stablecoin must be sent to. Quotes are single-use and expire (TTL).","tags":["Fiat transfers"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiatQuote"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["fiat:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFiatQuoteRequest"}}}}}},"/v1/fiat-transfers":{"post":{"operationId":"post_v1_fiat_transfers","summary":"Create a fiat transfer from a quote (high-risk: signed)","description":"Off-ramps name their funding: `payment_intent_output` (a payment output that settles into the quote’s deposit address; the transfer is submitted once that output settles) or `onchain_deposit` (a verified deposit). On-ramps and fiat-to-fiat transfers are funded at the provider (see `funding.instructions`). The beneficiary must be verified, screened and past its cooling-off period. Idempotent per Idempotency-Key.","tags":["Fiat transfers"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/RequestSignature"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiatTransfer"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["fiat:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFiatTransferRequest"}}}}},"get":{"operationId":"get_v1_fiat_transfers","summary":"List fiat transfers","tags":["Fiat transfers"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"starting_after","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"ending_before","in":"query","required":false,"schema":{"type":"string","maxLength":64}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["BENEFICIARY_REQUIRED","BENEFICIARY_REVIEW","QUOTED","FUNDING_PENDING","FUNDED","SUBMITTED","PROCESSING","SETTLED","RETURN_PENDING","RETURNED","REJECTED","CANCELED","MANUAL_REVIEW"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiatTransferList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["fiat:read"]}},"/v1/fiat-transfers/{id}":{"get":{"operationId":"get_v1_fiat_transfers_id","summary":"Retrieve a fiat transfer","tags":["Fiat transfers"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ft_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiatTransfer"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["fiat:read"]}},"/v1/fiat-transfers/{id}/returns":{"get":{"operationId":"get_v1_fiat_transfers_id_returns","summary":"List returns of a fiat transfer","tags":["Fiat transfers"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ft_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiatReturnList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["fiat:read"]}},"/v1/fiat-transfers/{id}/cancel":{"post":{"operationId":"post_v1_fiat_transfers_id_cancel","summary":"Cancel a fiat transfer where the rail still allows it","description":"Possible before funding, before submission, and for batch rails (ACH, wire, SEPA) until the processing window. Instant rails (RTP, SEPA Instant, Faster Payments, Pix) cannot be canceled once submitted.","tags":["Fiat transfers"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^ft_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiatTransfer"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["fiat:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelFiatTransferRequest"}}}}}},"/v1/approval-policies":{"post":{"operationId":"post_v1_approval_policies","summary":"Create an approval policy","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalPolicy"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["approvals:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApprovalPolicyRequest"}}}}},"get":{"operationId":"get_v1_approval_policies","summary":"List approval policies (workspace and organization)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalPolicyList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["approvals:read"]}},"/v1/approval-policies/{id}/{action}":{"post":{"operationId":"post_v1_approval_policies_id_action","summary":"Enable or disable an approval policy","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^appol_[0-9A-Za-z]{16,40}$"}},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["enable","disable"]}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalPolicy"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["approvals:write"]}},"/v1/approval-requests":{"get":{"operationId":"get_v1_approval_requests","summary":"Approval requests (newest first)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","maxLength":20}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRequestList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["approvals:read"]}},"/v1/approval-requests/{id}":{"get":{"operationId":"get_v1_approval_requests_id","summary":"Retrieve an approval request","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^apr_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRequest"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["approvals:read"]}},"/v1/approval-requests/{id}/decision":{"post":{"operationId":"post_v1_approval_requests_id_decision","summary":"Approve or reject (console users with an approver role; never your own request)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^apr_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRequest"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["approvals:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecideApprovalRequest"}}}}}},"/v1/approval-requests/{id}/cancel":{"post":{"operationId":"post_v1_approval_requests_id_cancel","summary":"Cancel a pending approval request","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^apr_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRequest"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["approvals:write"]}},"/v1/velocity-limits":{"post":{"operationId":"post_v1_velocity_limits","summary":"Set a velocity limit (count and/or USD amount per window)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VelocityLimit"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VelocityLimitRequest"}}}}},"get":{"operationId":"get_v1_velocity_limits","summary":"List velocity limits","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VelocityLimitList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:read"]}},"/v1/velocity-limits/{id}/disable":{"post":{"operationId":"post_v1_velocity_limits_id_disable","summary":"Disable a velocity limit","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VelocityLimit"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"]}},"/v1/provider-preferences":{"get":{"operationId":"get_v1_provider_preferences","summary":"Provider allow/deny preferences and the resulting eligible providers","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderPreferences"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:read"]},"put":{"operationId":"put_v1_provider_preferences","summary":"Set provider preferences (narrow only: never overrides certification or compliance)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderPreferences"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderPreferencesRequest"}}}}}},"/v1/destination-controls":{"get":{"operationId":"get_v1_destination_controls","summary":"Destination allowlist and cooling-off periods, with any scheduled loosening","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DestinationControls"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:read"]},"put":{"operationId":"put_v1_destination_controls","summary":"Set destination controls (tightening applies now; loosening is scheduled)","description":"Turning the allowlist on or lengthening a cooling-off period applies at once. Turning the allowlist off or shortening a cooling-off period takes effect after at least 24 hours (and not before the current cooling-off periods), and can be cancelled until then. API-key callers must sign this request.","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/RequestSignature"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DestinationControls"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DestinationControlsRequest"}}}}}},"/v1/destination-controls/cancel-pending":{"post":{"operationId":"post_v1_destination_controls_cancel_pending","summary":"Cancel a scheduled loosening of the destination controls","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DestinationControls"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"]}},"/v1/provider-credentials":{"get":{"operationId":"get_v1_provider_credentials","summary":"Your own provider accounts (bring-your-own credentials) and the providers that accept them","description":"Your own provider accounts are enabled on request, only where the provider contract allows it. Secrets are never returned.","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCredentialList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:read"]},"post":{"operationId":"post_v1_provider_credentials","summary":"Add your own provider account (replaces the active one for that provider)","description":"Quotes and orders for your payments then use your account instead of the platform account. The provider flag, live-money rules, certification and your provider preferences still apply. API-key callers must sign this request.","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/RequestSignature"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCredential"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCredentialRequest"}}}}}},"/v1/provider-credentials/{id}/revoke":{"post":{"operationId":"post_v1_provider_credentials_id_revoke","summary":"Revoke your own provider account","description":"New quotes and orders stop using it at once; orders already placed keep being tracked with it.","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^pcred_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCredential"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"]}},"/v1/provider-sla":{"get":{"operationId":"get_v1_provider_sla","summary":"Measured provider SLA metrics (last 24 hours) with certification status","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ProviderSla"}}},"required":["object","data"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:read"]}},"/v1/data-residency":{"get":{"operationId":"get_v1_data_residency","summary":"Data residency region and retention","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResidencyPolicy"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:read"]},"put":{"operationId":"put_v1_data_residency","summary":"Set data residency and retention (owners)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResidencyPolicy"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResidencyRequest"}}}}}},"/v1/incident-subscriptions":{"post":{"operationId":"post_v1_incident_subscriptions","summary":"Subscribe to platform incidents (email or HTTPS webhook)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentSubscription"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentSubscriptionRequest"}}}}},"get":{"operationId":"get_v1_incident_subscriptions","summary":"List incident subscriptions","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentSubscriptionList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:read"]}},"/v1/incident-subscriptions/{id}/status":{"post":{"operationId":"post_v1_incident_subscriptions_id_status","summary":"Enable or disable an incident subscription","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^isub_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentSubscription"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["active","disabled"]}},"required":["status"]}}}}}},"/v1/audit-export-sinks/{id}/status":{"post":{"operationId":"post_v1_audit_export_sinks_id_status","summary":"Pause or resume an audit export sink (resuming clears a failing state; the cursor is kept)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^asink_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditExportSink"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["active","paused"]}},"required":["status"]}}}}}},"/v1/audit-export-sinks":{"post":{"operationId":"post_v1_audit_export_sinks","summary":"Export audit events to a SIEM endpoint (signed, hash-chained batches)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditExportSink"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditExportSinkRequest"}}}}},"get":{"operationId":"get_v1_audit_export_sinks","summary":"List audit export sinks","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditExportSinkList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["merchants:read"]}},"/v1/custom-roles":{"post":{"operationId":"post_v1_custom_roles","summary":"Create a custom role (never more than your own permissions)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomRole"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCustomRoleRequest"}}}}},"get":{"operationId":"get_v1_custom_roles","summary":"List custom roles","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomRoleList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/members/{id}/role":{"put":{"operationId":"put_v1_members_id_role","summary":"Assign a built-in or custom role to a member","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^usr_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","const":"membership"},"user_id":{"type":"string"},"role":{"type":"string"}},"required":["object","user_id","role"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignRoleRequest"}}}}}},"/v1/teams":{"post":{"operationId":"post_v1_teams","summary":"Create a team","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Team"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTeamRequest"}}}}},"get":{"operationId":"get_v1_teams","summary":"List teams","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/scim-tokens":{"post":{"operationId":"post_v1_scim_tokens","summary":"Create a SCIM 2.0 provisioning token (shown once)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScimToken"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string","minLength":2,"maxLength":60}},"required":["label"]}}}}},"get":{"operationId":"get_v1_scim_tokens","summary":"List SCIM tokens (the tokens themselves are never shown again)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScimTokenList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/scim-tokens/{id}/revoke":{"post":{"operationId":"post_v1_scim_tokens_id_revoke","summary":"Revoke a SCIM token","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^scim_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScimToken"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/sso-connections":{"post":{"operationId":"post_v1_sso_connections","summary":"Register an SSO connection (activation is not yet available)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SsoConnection"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SsoConnectionRequest"}}}}},"get":{"operationId":"get_v1_sso_connections","summary":"List SSO connections","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SsoConnectionList"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/sso-connections/{id}/disable":{"post":{"operationId":"post_v1_sso_connections_id_disable","summary":"Disable an SSO connection","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^sso_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SsoConnection"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/sso-connections/{id}/activate":{"post":{"operationId":"post_v1_sso_connections_id_activate","summary":"Activate an SSO connection (refused until assertion verification ships)","tags":["Enterprise"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^sso_[0-9A-Za-z]{16,40}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/scim/v2/ServiceProviderConfig":{"get":{"operationId":"get_scim_v2_ServiceProviderConfig","summary":"SCIM service provider configuration","tags":["SCIM"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"scim","limit":600,"windowSeconds":60}}},"/scim/v2/Users":{"get":{"operationId":"get_scim_v2_Users","summary":"List provisioned users","tags":["SCIM"],"security":[],"parameters":[{"name":"filter","in":"query","required":false,"schema":{"type":"string","maxLength":300}},{"name":"startIndex","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"count","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":0,"maximum":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"scim","limit":600,"windowSeconds":60}},"post":{"operationId":"post_scim_v2_Users","summary":"Provision a user","tags":["SCIM"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"scim","limit":600,"windowSeconds":60}}},"/scim/v2/Users/{id}":{"get":{"operationId":"get_scim_v2_Users_id","summary":"Retrieve a provisioned user","tags":["SCIM"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^usr_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"scim","limit":600,"windowSeconds":60}},"patch":{"operationId":"patch_scim_v2_Users_id","summary":"Update a provisioned user (replace active / name)","tags":["SCIM"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^usr_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"scim","limit":600,"windowSeconds":60}},"delete":{"operationId":"delete_scim_v2_Users_id","summary":"Deprovision a user","tags":["SCIM"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^usr_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"scim","limit":600,"windowSeconds":60}}},"/.well-known/receipt-keys.json":{"get":{"operationId":"get__well_known_receipt_keys_json","summary":"Receipt verification key set (JWKS with validity windows; retired keys stay published)","tags":["Receipts"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptKeySet"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"public_read","limit":600,"windowSeconds":60}}},"/v1/receipts/verify":{"post":{"operationId":"post_v1_receipts_verify","summary":"Verify a receipt online (hash, signature, key validity, supersession)","tags":["Receipts"],"security":[],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptVerification"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-rate-limit":{"bucket":"receipt_verify","limit":120,"windowSeconds":60},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyReceiptBody"}}}}}},"/v1/receipts/{id}":{"get":{"operationId":"get_v1_receipts_id","summary":"Retrieve a receipt","tags":["Receipts"],"security":[{"apiKey":[]},{"consoleSession":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^rcpt_[0-9A-Za-z]{16,40}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Receipt"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-required-scopes":["receipts:read"]}}},"components":{"schemas":{"Money":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"network_id":{"type":"string","pattern":"^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$","description":"CAIP-2 network identifier","example":"eip155:8453"},"amount_atomic":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},"decimals":{"type":"integer","minimum":0,"maximum":36}},"required":["asset_id","network_id","amount_atomic","decimals"],"description":"Crypto amount with asset, network, unit and precision."},"FiatMoney":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$","example":"USD"},"amount_minor":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"}},"required":["currency","amount_minor"],"description":"Fiat amount in ISO 4217 minor units."},"Metadata":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":40},"additionalProperties":{"type":"string","maxLength":500},"description":"Up to 50 string key/value pairs. Never put secrets or personal data here."},"ErrorEnvelope":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["code","message","request_id","retryable","details"]}},"required":["error"]},"Event":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["payment_intent.created","payment_intent.updated","payment_intent.quoted","payment_intent.authorized","payment_intent.funding_pending","payment_intent.funded","payment_intent.condition_pending","payment_intent.routing","payment_intent.partially_settled","payment_intent.settled","payment_intent.receipt_issued","payment_intent.expired","payment_intent.canceled","payment_intent.review_required","payment_intent.refund_pending","payment_intent.refunded","payment_intent.failed","payment_intent.underpaid","payment_intent.overpaid","order.created","order.status_changed","receipt.issued","receipt.superseded","refund.created","refund.action_required","refund.updated","refund.completed","refund.failed","payout.updated","payout_batch.updated","payment_link.updated","execution_plan.compiled","execution_plan.authorized","execution_plan.completed","execution_plan.partially_completed","execution_plan.updated","settlement_policy.updated","agent_authorization.revoked","agent_authorization.exhausted","usage.threshold_reached","billing_record.priced","billing_record.settled","billing_record.failed","protocol_transaction.settled","protocol_transaction.failed","condition.updated","condition.satisfied","condition.reversed","escrow.updated","escrow.funded","escrow.closed","milestone.updated","dispute.opened","dispute.updated","dispute.resolved","beneficiary.updated","fiat_transfer.updated","approval_request.created","approval_request.decided","reconciliation.exception"]},"api_version":{"type":"string"},"sequence":{"type":"integer","minimum":1,"maximum":9007199254740991},"occurred_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"livemode":{"type":"boolean"},"resource":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["type","id","version"]},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"previous_attributes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","type","api_version","sequence","occurred_at","livemode","resource","data","previous_attributes"]},"LineItem":{"type":"object","properties":{"id":{"type":"string","maxLength":64},"name":{"type":"string","minLength":1,"maxLength":200},"quantity":{"type":"integer","minimum":1,"maximum":1000000},"unit_amount":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"sku":{"type":"string","maxLength":64}},"required":["name","quantity","unit_amount"]},"AmountRule":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"exact"},"value":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"}},"required":["type","value"]},{"type":"object","properties":{"type":{"type":"string","const":"minimum"},"value":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"}},"required":["type","value"]},{"type":"object","properties":{"type":{"type":"string","const":"percentage"},"value":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"}},"required":["type","value"]},{"type":"object","properties":{"type":{"type":"string","const":"remainder"}},"required":["type"]}]},"DestinationInput":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"onchain_wallet"},"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64}},"required":["type","address"]},{"type":"object","properties":{"type":{"type":"string","const":"provider_account"},"provider":{"type":"string","maxLength":40},"account_reference":{"type":"string","maxLength":128}},"required":["type","provider","account_reference"]},{"type":"object","properties":{"type":{"type":"string","const":"fiat_beneficiary"},"beneficiary_id":{"type":"string","maxLength":64}},"required":["type","beneficiary_id"]}]},"IntentOutputInput":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_]{1,32}$"},"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","example":"USD"},"rail":{"type":"string","maxLength":32},"amount":{"$ref":"#/components/schemas/AmountRule"},"destination":{"$ref":"#/components/schemas/DestinationInput"},"priority":{"default":0,"type":"integer","minimum":0,"maximum":1000},"fallbacks":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","example":"USD"},"destination":{"$ref":"#/components/schemas/DestinationInput"}}}},"fee_payer":{"default":"sender","type":"string","enum":["sender","recipient","split"]},"release_condition_ids":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","maxLength":64}},"compliance":{"default":{"screening_required":true},"type":"object","properties":{"screening_required":{"default":true,"type":"boolean"}}}},"required":["amount","destination"]},"FundingPolicy":{"type":"object","properties":{"accepted_assets":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"}},"excluded_assets":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"}},"allow_variable_rate":{"default":false,"type":"boolean"},"require_refund_address":{"default":false,"type":"boolean"},"preference":{"default":"minimize_cost","type":"string","enum":["minimize_cost","minimize_time"]},"max_payer_cost_bps":{"type":"integer","minimum":0,"maximum":10000}}},"IntentConditionInput":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_]{1,32}$"},"class":{"type":"string","enum":["TIME","BUYER_APPROVAL","MERCHANT_FULFILLMENT","PLATFORM_WEBHOOK","SIGNED_ATTESTATION","COMPUTE_RESULT","ORACLE_EVENT","MILESTONE","NO_DISPUTE_WINDOW","MULTI_APPROVAL"]},"verifier_configuration_id":{"type":"string","maxLength":64},"config":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"on_timeout":{"default":"review","type":"string","enum":["refund","release","review"]},"dispute_eligible":{"default":false,"type":"boolean"},"human_review_required":{"default":false,"type":"boolean"}},"required":["id","class"]},"PresentationAmountInput":{"type":"object","properties":{"value":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","example":"USD"},"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"}},"required":["value"]},"CreatePaymentIntentRequest":{"type":"object","properties":{"amount":{"$ref":"#/components/schemas/PresentationAmountInput"},"description":{"type":"string","maxLength":500},"line_items":{"maxItems":100,"type":"array","items":{"$ref":"#/components/schemas/LineItem"}},"settlement":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64}},"required":["asset_id","address"]},"outputs":{"minItems":1,"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/IntentOutputInput"}},"settlement_policy_id":{"type":"string","maxLength":64},"external_reference":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[\\x20-\\x7E]+$","example":"INV-1048"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"expires_in_seconds":{"type":"integer","minimum":60,"maximum":7776000},"max_total_fee_bps":{"type":"integer","minimum":0,"maximum":10000},"accepted_interfaces":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"string","enum":["hosted_checkout","api","swap","x402","mpp","ap2","acp","ucp"]}},"funding_policy":{"$ref":"#/components/schemas/FundingPolicy"},"conditions":{"maxItems":10,"type":"array","items":{"$ref":"#/components/schemas/IntentConditionInput"}},"customer_email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"return_url":{"type":"string","maxLength":2048},"metadata":{"$ref":"#/components/schemas/Metadata"}},"required":["amount"]},"IntentOutput":{"type":"object","properties":{"id":{"type":"string"},"asset_id":{"anyOf":[{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},{"type":"null"}]},"network_id":{"anyOf":[{"type":"string","pattern":"^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$","description":"CAIP-2 network identifier","example":"eip155:8453"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string","pattern":"^[A-Z]{3}$","example":"USD"},{"type":"null"}]},"rail":{"type":["string","null"]},"amount_rule":{"$ref":"#/components/schemas/AmountRule"},"target_amount":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"target_fiat_amount":{"anyOf":[{"$ref":"#/components/schemas/FiatMoney"},{"type":"null"}]},"destination":{"type":"object","properties":{"type":{"type":"string","enum":["onchain_wallet","provider_account","fiat_beneficiary"]},"address":{"type":["string","null"]},"address_masked":{"type":["string","null"]},"memo":{"type":["string","null"]},"beneficiary_id":{"type":["string","null"]}},"required":["type","address","address_masked","memo","beneficiary_id"]},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fee_payer":{"type":"string","enum":["sender","recipient","split"]},"fallbacks":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","example":"USD"},"destination":{"$ref":"#/components/schemas/DestinationInput"}}}},"status":{"type":"string","enum":["PENDING","IN_PROGRESS","SETTLED","FAILED","REFUNDED","MANUAL_REVIEW"]},"settled_amount":{"anyOf":[{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},{"type":"null"}]},"settle_txid":{"type":["string","null"]}},"required":["id","asset_id","network_id","currency","rail","amount_rule","target_amount","target_fiat_amount","destination","priority","fee_payer","fallbacks","status","settled_amount","settle_txid"]},"PaymentIntent":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"payment_intent"},"version":{"type":"integer","minimum":1,"maximum":9007199254740991},"resource_version":{"type":"integer","minimum":1,"maximum":9007199254740991},"livemode":{"type":"boolean"},"merchant_id":{"type":"string"},"external_reference":{"type":["string","null"]},"status":{"type":"string","enum":["DRAFT","OPEN","QUOTED","AUTHORIZED","FUNDING_PENDING","FUNDED","CONDITION_PENDING","ROUTING","PARTIALLY_SETTLED","SETTLED","RECEIPT_ISSUED","EXPIRED","REVIEW_REQUIRED","REFUND_PENDING","REFUNDED","FAILED","CANCELED"]},"presentation":{"type":"object","properties":{"amount":{"anyOf":[{"$ref":"#/components/schemas/FiatMoney"},{"$ref":"#/components/schemas/Money"}]},"description":{"type":["string","null"]},"line_items":{"type":"array","items":{"$ref":"#/components/schemas/LineItem"}}},"required":["amount","description","line_items"]},"outputs":{"type":"array","items":{"$ref":"#/components/schemas/IntentOutput"}},"settlement_policy":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","version"]},{"type":"null"}]},"funding_policy":{"$ref":"#/components/schemas/FundingPolicy"},"accepted_interfaces":{"type":"array","items":{"type":"string","enum":["hosted_checkout","api","swap","x402","mpp","ap2","acp","ucp"]}},"conditions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"class":{"type":"string","enum":["TIME","BUYER_APPROVAL","MERCHANT_FULFILLMENT","PLATFORM_WEBHOOK","SIGNED_ATTESTATION","COMPUTE_RESULT","ORACLE_EVENT","MILESTONE","NO_DISPUTE_WINDOW","MULTI_APPROVAL"]},"status":{"type":"string"}},"required":["id","class","status"]}},"escrow_id":{"type":["string","null"]},"max_total_fee_bps":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"hosted_url":{"type":"string"},"return_url":{"type":["string","null"]},"latest_order_id":{"type":["string","null"]},"latest_plan_id":{"type":["string","null"]},"receipt_id":{"type":["string","null"]},"amount_refundable":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"request_id":{"type":"string"}},"required":["id","object","version","resource_version","livemode","merchant_id","external_reference","status","presentation","outputs","settlement_policy","funding_policy","accepted_interfaces","conditions","escrow_id","max_total_fee_bps","hosted_url","return_url","latest_order_id","latest_plan_id","receipt_id","amount_refundable","metadata","expires_at","created_at","updated_at"]},"PublicPaymentIntent":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"public_payment_intent"},"livemode":{"type":"boolean"},"status":{"type":"string","enum":["DRAFT","OPEN","QUOTED","AUTHORIZED","FUNDING_PENDING","FUNDED","CONDITION_PENDING","ROUTING","PARTIALLY_SETTLED","SETTLED","RECEIPT_ISSUED","EXPIRED","REVIEW_REQUIRED","REFUND_PENDING","REFUNDED","FAILED","CANCELED"]},"merchant":{"type":"object","properties":{"display_name":{"type":"string"},"brand_color":{"type":["string","null"]},"logo_url":{"type":["string","null"]}},"required":["display_name","brand_color","logo_url"]},"presentation":{"type":"object","properties":{"amount":{"anyOf":[{"$ref":"#/components/schemas/FiatMoney"},{"$ref":"#/components/schemas/Money"}]},"description":{"type":["string","null"]},"line_items":{"type":"array","items":{"$ref":"#/components/schemas/LineItem"}}},"required":["amount","description","line_items"]},"recipient_receives":{"type":"array","items":{"type":"object","properties":{"output_id":{"type":"string"},"status":{"type":"string"},"asset_id":{"type":["string","null"]},"symbol":{"type":["string","null"]},"network_id":{"type":["string","null"]},"network_name":{"type":["string","null"]},"currency":{"type":["string","null"]},"amount":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"amount_rule":{"type":"string","enum":["exact","minimum","percentage","remainder"]}},"required":["output_id","status","asset_id","symbol","network_id","network_name","currency","amount","amount_rule"]}},"external_reference":{"type":["string","null"]},"accepted_assets":{"type":"array","items":{"type":"string"}},"require_refund_address":{"type":"boolean"},"conditions_summary":{"type":"array","items":{"type":"string"}},"conditional":{"anyOf":[{"type":"object","properties":{"escrow_id":{"type":"string"},"terms_accepted":{"type":"boolean"},"escrow_status":{"type":"string"}},"required":["escrow_id","terms_accepted","escrow_status"]},{"type":"null"}]},"latest_order_id":{"type":["string","null"]},"execution_mode":{"type":"string","enum":["quote","plan"]},"latest_plan_id":{"type":["string","null"]},"receipt_id":{"type":["string","null"]},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"return_url":{"type":["string","null"]}},"required":["id","object","livemode","status","merchant","presentation","recipient_receives","external_reference","accepted_assets","require_refund_address","conditions_summary","conditional","latest_order_id","execution_mode","latest_plan_id","receipt_id","expires_at","return_url"]},"TimelineEntry":{"type":"object","properties":{"at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"kind":{"type":"string","enum":["intent","order","refund","receipt"]},"status":{"type":"string"},"title":{"type":"string"},"detail":{"type":["string","null"]},"reference":{"type":["string","null"]}},"required":["at","kind","status","title","detail","reference"]},"FeeLine":{"type":"object","properties":{"kind":{"type":"string","enum":["provider","network","platform","liquidity","fx","rail"]},"embedded_in_rate":{"type":"boolean"},"amount":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"description":{"type":"string"}},"required":["kind","embedded_in_rate","amount","description"]},"Quote":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"quote"},"payment_intent_id":{"type":["string","null"]},"provider":{"type":"string"},"provider_display_name":{"type":"string"},"provider_terms_url":{"type":"string"},"deposit":{"$ref":"#/components/schemas/Money"},"settle":{"$ref":"#/components/schemas/Money"},"settle_amount_guaranteed":{"type":"boolean","description":"True when output is exact; false means estimated."},"rate_type":{"type":"string","enum":["fixed","variable"]},"rate":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Settle units per deposit unit (display only).","example":"1000.00"},"fees":{"type":"array","items":{"$ref":"#/components/schemas/FeeLine"}},"total_payer_cost_bps":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"min_deposit":{"$ref":"#/components/schemas/Money"},"max_deposit":{"$ref":"#/components/schemas/Money"},"refund_address_required":{"type":"boolean"},"deposit_memo_required":{"type":"boolean"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"explanation":{"type":["string","null"]}},"required":["id","object","payment_intent_id","provider","provider_display_name","provider_terms_url","deposit","settle","settle_amount_guaranteed","rate_type","rate","fees","total_payer_cost_bps","min_deposit","max_deposit","refund_address_required","deposit_memo_required","expires_at","created_at","explanation"]},"CreateIntentQuoteRequest":{"type":"object","properties":{"deposit_asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"}},"required":["deposit_asset_id"]},"PayerAcknowledgements":{"type":"object","properties":{"provider_terms":{"type":"boolean","const":true},"network_warning":{"type":"boolean","const":true},"high_value":{"type":"boolean"},"memo_required":{"type":"boolean"}},"required":["provider_terms","network_warning"]},"ConfirmIntentRequest":{"type":"object","properties":{"quote_id":{"type":"string","maxLength":64},"refund_address":{"type":"string","minLength":1,"maxLength":128},"refund_memo":{"type":"string","minLength":1,"maxLength":64},"acknowledgements":{"$ref":"#/components/schemas/PayerAcknowledgements"},"notification_email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["quote_id","acknowledgements"]},"CreateSwapQuoteRequest":{"type":"object","properties":{"deposit_asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"settle_asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"deposit_amount":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"settle_amount":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"}},"required":["deposit_asset_id","settle_asset_id"]},"CreateSwapOrderRequest":{"type":"object","properties":{"quote_id":{"type":"string","maxLength":64},"settle_address":{"type":"string","minLength":1,"maxLength":128},"settle_memo":{"type":"string","minLength":1,"maxLength":64},"refund_address":{"type":"string","minLength":1,"maxLength":128},"refund_memo":{"type":"string","minLength":1,"maxLength":64},"exchange_deposit_address":{"default":false,"type":"boolean"},"acknowledgements":{"type":"object","properties":{"provider_terms":{"type":"boolean","const":true},"network_warning":{"type":"boolean","const":true},"high_value":{"type":"boolean"},"memo_required":{"type":"boolean"}},"required":["provider_terms","network_warning"]}},"required":["quote_id","settle_address","acknowledgements"]},"DepositInstructions":{"type":"object","properties":{"address":{"type":"string","description":"Exactly as returned by the provider for this order."},"memo":{"type":["string","null"]},"memo_required":{"type":"boolean"},"amount":{"$ref":"#/components/schemas/Money"},"asset_symbol":{"type":"string"},"network_name":{"type":"string"},"qr_payload":{"type":"string","description":"Chain URI when safely supported, otherwise the bare address."},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["address","memo","memo_required","amount","asset_symbol","network_name","qr_payload","expires_at","warnings"]},"PublicOrder":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"order"},"livemode":{"type":"boolean"},"payment_intent_id":{"type":["string","null"]},"status":{"type":"string","enum":["DRAFT","QUOTE_READY","ORDER_CREATED","WAITING_FOR_DEPOSIT","DEPOSIT_DETECTED","CONFIRMING","CONVERTING","SENDING","COMPLETE","EXPIRED","REVIEW_REQUIRED","REFUND_PENDING","REFUNDED","FAILED"]},"intent_status":{"anyOf":[{"type":"string","enum":["DRAFT","OPEN","QUOTED","AUTHORIZED","FUNDING_PENDING","FUNDED","CONDITION_PENDING","ROUTING","PARTIALLY_SETTLED","SETTLED","RECEIPT_ISSUED","EXPIRED","REVIEW_REQUIRED","REFUND_PENDING","REFUNDED","FAILED","CANCELED"]},{"type":"null"}]},"milestone":{"anyOf":[{"type":"string","enum":["waiting_for_deposit","deposit_detected","confirming","converting","sending","complete"]},{"type":"null"}]},"display":{"type":"object","properties":{"title":{"type":"string"},"message":{"type":"string"},"action":{"type":"string","enum":["none","send_deposit","do_not_send","contact_support","follow_provider_instructions","refresh_quote"]},"tone":{"type":"string","enum":["neutral","progress","attention","error","success"]}},"required":["title","message","action","tone"]},"provider":{"type":"string"},"provider_display_name":{"type":"string"},"rate_type":{"type":"string","enum":["fixed","variable"]},"deposit":{"$ref":"#/components/schemas/Money"},"deposit_received":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"settle_estimated":{"$ref":"#/components/schemas/Money"},"settle_sent":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"settle_amount_guaranteed":{"type":"boolean"},"settle_address_masked":{"type":"string"},"deposit_instructions":{"anyOf":[{"$ref":"#/components/schemas/DepositInstructions"},{"type":"null"}]},"deposit_txid":{"type":["string","null"]},"deposit_tx_url":{"type":["string","null"]},"settle_txid":{"type":["string","null"]},"settle_tx_url":{"type":["string","null"]},"refund_txid":{"type":["string","null"]},"provider_instructions_url":{"type":["string","null"]},"return_url":{"type":["string","null"]},"merchant_display_name":{"type":["string","null"]},"receipt_id":{"type":["string","null"]},"timeline":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","enum":["DRAFT","QUOTE_READY","ORDER_CREATED","WAITING_FOR_DEPOSIT","DEPOSIT_DETECTED","CONFIRMING","CONVERTING","SENDING","COMPLETE","EXPIRED","REVIEW_REQUIRED","REFUND_PENDING","REFUNDED","FAILED"]},"at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"message":{"type":"string"}},"required":["status","at","message"]}},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","payment_intent_id","status","intent_status","milestone","display","provider","provider_display_name","rate_type","deposit","deposit_received","settle_estimated","settle_sent","settle_amount_guaranteed","settle_address_masked","deposit_instructions","deposit_txid","deposit_tx_url","settle_txid","settle_tx_url","refund_txid","provider_instructions_url","return_url","merchant_display_name","receipt_id","timeline","expires_at","created_at","updated_at"]},"NotificationSubscriptionRequest":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["email"]},"SupportRequest":{"type":"object","properties":{"order_id":{"type":"string","maxLength":64},"payment_intent_id":{"type":"string","maxLength":64},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"category":{"type":"string","enum":["payment_not_detected","wrong_network","missing_memo","underpayment","overpayment","refund","verification","other"]},"message":{"type":"string","minLength":10,"maxLength":5000}},"required":["email","category","message"]},"Pair":{"type":"object","properties":{"object":{"type":"string","const":"pair"},"deposit_asset_id":{"type":"string"},"settle_asset_id":{"type":"string"},"providers":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"min_deposit":{"$ref":"#/components/schemas/Money"},"max_deposit":{"$ref":"#/components/schemas/Money"},"indicative_rate":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"exact_output":{"type":"boolean"},"fixed_rate":{"type":"boolean"},"variable_rate":{"type":"boolean"}},"required":["provider","min_deposit","max_deposit","indicative_rate","exact_output","fixed_rate","variable_rate"]}}},"required":["object","deposit_asset_id","settle_asset_id","providers"]},"Asset":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"asset"},"symbol":{"type":"string"},"name":{"type":"string"},"network_id":{"type":"string"},"network_name":{"type":"string"},"decimals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"memo_type":{"type":"string","enum":["none","memo","destination_tag"]},"contract_address":{"type":["string","null"]},"popular":{"type":"boolean"},"deposit_enabled":{"type":"boolean"},"settle_enabled":{"type":"boolean"},"shares_address_format_with":{"type":"array","items":{"type":"string"}}},"required":["id","object","symbol","name","network_id","network_name","decimals","memo_type","contract_address","popular","deposit_enabled","settle_enabled","shares_address_format_with"]},"ClientAnalyticsEvent":{"type":"object","properties":{"event":{"type":"string","enum":["payer_asset_selected","swap_viewed","send_asset_selected","receive_asset_selected","amount_entered","quote_failed","continue_clicked","address_validation_failed","review_viewed","deposit_copied","wallet_send_started","wallet_send_submitted"]},"properties":{"default":{},"type":"object","propertyNames":{"type":"string","pattern":"^[a-z_]{1,32}$"},"additionalProperties":{"anyOf":[{"type":"string","maxLength":64},{"type":"number"},{"type":"boolean"}]}}},"required":["event"]},"ExecutionStep":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"},"type":{"type":"string","enum":["COLLECT_ONCHAIN","COLLECT_FIAT","VERIFY_AUTHORIZATION","SCREEN_PARTIES","SWAP","BRIDGE","WAIT_FINALITY","WAIT_CONDITION","SPLIT","SETTLE_ONCHAIN","OFFRAMP","SETTLE_FIAT","REFUND","ISSUE_RECEIPT"]},"depends_on":{"type":"array","items":{"type":"string"}},"provider":{"type":["string","null"]},"input":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},{"type":"null"}]},"output":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},{"type":"null"}]},"output_id":{"type":["string","null"]},"retry_policy":{"type":"object","properties":{"max_attempts":{"type":"integer","minimum":1,"maximum":20},"backoff_seconds":{"maxItems":20,"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["max_attempts","backoff_seconds"]},"timeout_seconds":{"type":"integer","minimum":1,"maximum":9007199254740991},"compensation":{"type":"string","enum":["none","refund_payer","reverse_swap","release_hold","return_fiat","manual_review"]},"params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/__shared#/$defs/schema0"}}},"required":["id","type","depends_on","provider","input","output","output_id","retry_policy","timeout_seconds","compensation","params"]},"Constraint":{"type":"object","properties":{"type":{"type":"string","enum":["max_total_fee_bps","complete_within_seconds","settle_before","min_route_success_rate","exact_output","allowed_providers","denied_providers","jurisdiction","compliance_approval_required","max_payer_cost_bps"]},"value":{"$ref":"#/components/schemas/__shared#/$defs/schema0"}},"required":["type","value"]},"CostBreakdown":{"type":"object","properties":{"denomination":{"type":"string"},"total_minor":{"type":"string"},"payer_cost_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"components":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["provider","network","platform","liquidity","fx","rail","compiler"]},"embedded_in_rate":{"type":"boolean"},"amount":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},{"type":"null"}]},"denomination_amount_minor":{"type":"string"},"step_id":{"type":["string","null"]},"description":{"type":"string"}},"required":["kind","embedded_in_rate","amount","denomination_amount_minor","step_id","description"]}}},"required":["denomination","total_minor","payer_cost_bps","components"]},"ExecutionPlan":{"type":"object","properties":{"intent_id":{"type":"string"},"intent_version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"quote_id":{"type":["string","null"]},"compiler_version":{"type":"string"},"capability_snapshot_id":{"type":"string"},"policy_version_id":{"type":["string","null"]},"funding":{"type":"object","properties":{"asset_id":{"type":["string","null"]},"currency":{"type":["string","null"]},"amount":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]}},"required":["asset_id","currency","amount"]},"steps":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionStep"}},"hard_constraints":{"type":"array","items":{"$ref":"#/components/schemas/Constraint"}},"estimated_cost":{"$ref":"#/components/schemas/CostBreakdown"},"estimated_completion_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"supersedes_plan_id":{"type":["string","null"]},"id":{"type":"string"},"object":{"type":"string","const":"execution_plan"},"status":{"type":"string","enum":["COMPILED","AUTHORIZED","EXECUTING","COMPLETED","PARTIALLY_COMPLETED","COMPENSATING","FAILED","CANCELED","EXPIRED","SUPERSEDED","MANUAL_REVIEW"]},"plan_hash":{"type":"string"},"step_states":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["PENDING","READY","RESERVED","SUBMITTED","IN_PROGRESS","AWAITING_FINALITY","AWAITING_CONDITION","SUCCEEDED","COMPENSATING","COMPENSATED","FAILED_RETRYABLE","FAILED_TERMINAL","MANUAL_REVIEW"]},"attempts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","status","attempts"]}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["intent_id","intent_version","quote_id","compiler_version","capability_snapshot_id","policy_version_id","funding","steps","hard_constraints","estimated_cost","estimated_completion_seconds","expires_at","supersedes_plan_id","id","object","status","plan_hash","created_at"]},"ReceiptPayload":{"type":"object","properties":{"receipt_version":{"type":"string","const":"2026-09-24"},"identity":{"type":"object","properties":{"receipt_id":{"type":"string"},"kind":{"type":"string","enum":["final","interim","superseding"]},"environment":{"type":"string","enum":["test","live"]},"issuer":{"type":"object","properties":{"name":{"type":"string"},"verification_url":{"type":"string"},"key_set_url":{"type":"string"}},"required":["name","verification_url","key_set_url"]},"issued_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["receipt_id","kind","environment","issuer","issued_at"]},"intent":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"external_reference":{"type":["string","null"]},"merchant_id":{"type":"string"},"merchant_display_name":{"type":"string"},"presentation_amount":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"description":{"type":["string","null"]}},"required":["id","version","external_reference","merchant_id","merchant_display_name","presentation_amount","description"]},"authorization":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["hosted_checkout_confirmation","api_confirmation","protocol_authorization","agent_authorization","mandate"]},"reference":{"type":"string"},"plan_hash":{"type":["string","null"]},"authorized_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"conditions_hash":{"type":["string","null"]}},"required":["type","reference","plan_hash","authorized_at","conditions_hash"]},{"type":"null"}]},"funding":{"anyOf":[{"type":"object","properties":{"method":{"type":"string","enum":["onchain","fiat","protocol"]},"amount_expected":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"amount_received":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},{"type":"null"}]},"txid":{"type":["string","null"]},"confirmed_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"provider":{"type":["string","null"]},"provider_order_id":{"type":["string","null"]},"public_order_id":{"type":["string","null"]},"legs":{"type":"array","items":{"type":"object","properties":{"output_id":{"type":"string"},"step_id":{"type":"string"},"kind":{"type":"string","enum":["provider_swap","direct_transfer"]},"amount_expected":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"amount_received":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},{"type":"null"}]},"txid":{"type":["string","null"]},"provider":{"type":["string","null"]},"public_order_id":{"type":["string","null"]}},"required":["output_id","step_id","kind","amount_expected","amount_received","txid","provider","public_order_id"]}}},"required":["method","amount_expected","amount_received","txid","confirmed_at","provider","provider_order_id","public_order_id"]},{"type":"null"}]},"execution_plan":{"anyOf":[{"type":"object","properties":{"plan_id":{"type":"string"},"plan_hash":{"type":"string"},"compiler_version":{"type":"string"},"capability_snapshot_id":{"type":"string"},"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"provider":{"type":["string","null"]},"status":{"type":"string"}},"required":["id","type","provider","status"]}}},"required":["plan_id","plan_hash","compiler_version","capability_snapshot_id","steps"]},{"type":"null"}]},"outputs":{"type":"array","items":{"type":"object","properties":{"output_id":{"type":"string"},"amount_rule":{"type":"string"},"target":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},{"type":"null"}]},"settled":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},{"type":"null"}]},"destination_masked":{"type":"string"},"txid":{"type":["string","null"]},"status":{"type":"string"},"settled_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]}},"required":["output_id","amount_rule","target","settled","destination_masked","txid","status","settled_at"]}},"fees":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"embedded_in_rate":{"type":"boolean"},"amount":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},{"type":"null"}]},"denomination_amount_minor":{"type":["string","null"]},"description":{"type":"string"}},"required":["kind","embedded_in_rate","amount","denomination_amount_minor","description"]}},"quoted_rate":{"type":["string","null"]},"effective_rate":{"type":["string","null"]},"rate_type":{"anyOf":[{"type":"string","enum":["fixed","variable"]},{"type":"null"}]},"rounding_remainder":{"type":["string","null"]}},"required":["items","quoted_rate","effective_rate","rate_type","rounding_remainder"]},"conditions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"class":{"type":"string"},"status":{"type":"string"},"verifier":{"type":["string","null"]},"evidence_hashes":{"type":"array","items":{"type":"string"}},"verification_result_ids":{"type":"array","items":{"type":"string"}},"decision":{"type":["string","null"]},"decided_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]}},"required":["id","class","status","verifier","evidence_hashes","verification_result_ids","decision","decided_at"]}},"escrow":{"type":"object","properties":{"id":{"type":"string"},"hold_adapter":{"type":"string"},"responsible_entity":{"type":"string"},"terms_hash":{"type":"string"},"funded":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"released":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"refunded":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"movements":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["fund","release","refund"]},"amount":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"txid":{"type":["string","null"]},"reason":{"type":"string"}},"required":["id","kind","amount","txid","reason"]}},"dispute":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"outcome":{"type":["string","null"]},"decision_id":{"type":["string","null"]}},"required":["id","status","outcome","decision_id"]},{"type":"null"}]}},"required":["id","hold_adapter","responsible_entity","terms_hash","funded","released","refunded","movements","dispute"]},"fiat":{"type":"array","items":{"type":"object","properties":{"transfer_id":{"type":"string"},"direction":{"type":"string","enum":["offramp","onramp","fiat_to_fiat"]},"rail":{"type":"string"},"provider":{"type":"string"},"status":{"type":"string"},"output_id":{"type":["string","null"]},"source":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"target":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"beneficiary_masked":{"type":"string"},"settled_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"settlement_meaning":{"type":"string"},"reversible":{"type":"boolean"},"return_window":{"type":["string","null"]},"return_risk_until":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"return_risk_disclosure":{"type":"string"},"fees":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"amount":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"embedded_in_rate":{"type":"boolean"},"billed_separately":{"type":"boolean"},"description":{"type":"string"}},"required":["kind","amount","embedded_in_rate","billed_separately","description"]}},"returns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"reason_code":{"type":"string"},"amount":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"returned_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","reason_code","amount","returned_at"]}},"ledger_transaction_ids":{"type":"array","items":{"type":"string"}}},"required":["transfer_id","direction","rail","provider","status","output_id","source","target","beneficiary_masked","settled_at","settlement_meaning","reversible","return_window","return_risk_until","return_risk_disclosure","fees","returns","ledger_transaction_ids"]}},"protocol":{"type":"object","properties":{"interface":{"type":"string"},"protocol":{"type":["string","null"]},"protocol_version":{"type":["string","null"]},"transaction_id":{"type":["string","null"]},"envelope_hashes":{"type":"array","items":{"type":"string"}}},"required":["interface","protocol","protocol_version","transaction_id","envelope_hashes"]},"finality":{"type":"object","properties":{"state":{"type":"string","enum":["final","provisional","return_risk"]},"confirmations":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"return_risk_until":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"notes":{"type":"array","items":{"type":"string"}}},"required":["state","confirmations","return_risk_until","notes"]},"ledger":{"type":"object","properties":{"transaction_ids":{"type":"array","items":{"type":"string"}},"balanced":{"type":"boolean"},"reconciled":{"type":"boolean"}},"required":["transaction_ids","balanced","reconciled"]},"usage":{"type":"object","properties":{"billing_record_id":{"type":"string"},"meter_id":{"type":"string"},"unit":{"type":"string"},"quantity":{"type":"string"},"event_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"first_event_id":{"type":"string"},"last_event_id":{"type":"string"}},"required":["billing_record_id","meter_id","unit","quantity","event_count","from","to","first_event_id","last_event_id"]},"refunds":{"type":"array","items":{"type":"object","properties":{"refund_id":{"type":"string"},"amount":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"status":{"type":"string"},"txid":{"type":["string","null"]}},"required":["refund_id","amount","status","txid"]}},"supersedes":{"type":["string","null"]}},"required":["receipt_version","identity","intent","authorization","funding","execution_plan","outputs","fees","conditions","protocol","finality","ledger","refunds","supersedes"]},"ReceiptSignature":{"type":"object","properties":{"kid":{"type":"string"},"alg":{"type":"string","const":"ES256"},"protected":{"type":"string","description":"base64url(JWS protected header)"},"signature":{"type":"string","description":"base64url(ECDSA P-256 signature, JOSE r||s form)"}},"required":["kid","alg","protected","signature"]},"Receipt":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"receipt"},"payload":{"$ref":"#/components/schemas/ReceiptPayload"},"payload_hash":{"type":"string"},"signatures":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/ReceiptSignature"}},"verification":{"type":"object","properties":{"url":{"type":"string"},"key_set_url":{"type":"string"}},"required":["url","key_set_url"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","payload","payload_hash","signatures","verification","created_at"]},"VerifyReceiptRequest":{"type":"object","properties":{"receipt":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"receipt"},"payload":{"$ref":"#/components/schemas/ReceiptPayload"},"payload_hash":{"type":"string"},"signatures":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/ReceiptSignature"}},"verification":{"type":"object","properties":{"url":{"type":"string"},"key_set_url":{"type":"string"}},"required":["url","key_set_url"]},"created_at":{"type":"string"}},"required":["id","object","payload","payload_hash","signatures","verification"]}},"required":["receipt"]},"ReceiptVerification":{"type":"object","properties":{"object":{"type":"string","const":"receipt_verification"},"valid":{"type":"boolean"},"payload_hash_matches":{"type":"boolean"},"signature_valid":{"type":"boolean"},"key_id":{"type":["string","null"]},"key_status":{"type":"string","enum":["active","retired","revoked","unknown"]},"superseded_by":{"type":["string","null"]},"reasons":{"type":"array","items":{"type":"string"}}},"required":["object","valid","payload_hash_matches","signature_valid","key_id","key_status","superseded_by","reasons"]},"ReceiptKey":{"type":"object","properties":{"kty":{"type":"string","const":"EC"},"crv":{"type":"string","const":"P-256"},"x":{"type":"string"},"y":{"type":"string"},"kid":{"type":"string"},"alg":{"type":"string","const":"ES256"},"use":{"type":"string","const":"sig"},"not_before":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"not_after":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"status":{"type":"string","enum":["active","retired","revoked"]},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"environment":{"type":"string","enum":["test","live"]}},"required":["kty","crv","x","y","kid","alg","use","not_before","not_after","status","revoked_at","environment"]},"ReceiptKeySet":{"type":"object","properties":{"keys":{"type":"array","items":{"$ref":"#/components/schemas/ReceiptKey"}}},"required":["keys"]},"CreateMerchantRequest":{"type":"object","properties":{"display_name":{"type":"string","minLength":1,"maxLength":80},"legal_name":{"type":"string","maxLength":200},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"brand_color":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"},"support_email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"default_settlement":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64}},"required":["asset_id","address"]},"metadata":{"$ref":"#/components/schemas/Metadata"}},"required":["display_name"]},"UpdateMerchantSettingsRequest":{"type":"object","properties":{"display_name":{"type":"string","minLength":1,"maxLength":80},"brand_color":{"anyOf":[{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"},{"type":"null"}]},"logo_url":{"anyOf":[{"type":"string","maxLength":500,"format":"uri"},{"type":"null"}]},"support_email":{"anyOf":[{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"default_settlement":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64}},"required":["asset_id","address"]},"notification_settings":{"type":"object","properties":{"customer_receipts":{"type":"boolean"},"failure_alerts_email":{"anyOf":[{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]}}},"checkout_return_origins":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":200}}}},"Merchant":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"merchant"},"display_name":{"type":"string"},"legal_name":{"type":["string","null"]},"status":{"type":"string","enum":["DRAFT","IDENTITY_REQUIRED","UNDER_REVIEW","ACTIVE_TEST","ACTIVE_LIVE","RESTRICTED","SUSPENDED","CLOSED"]},"country":{"type":["string","null"]},"brand_color":{"type":["string","null"]},"logo_url":{"type":["string","null"]},"default_settlement":{"anyOf":[{"type":"object","properties":{"asset_id":{"type":"string"},"address_masked":{"type":"string"},"verified":{"type":"boolean"}},"required":["asset_id","address_masked","verified"]},{"type":"null"}]},"support_email_masked":{"type":["string","null"]},"checkout_return_origins":{"type":"array","items":{"type":"string"}},"notification_settings":{"type":"object","properties":{"customer_receipts":{"type":"boolean"},"failure_alerts_email_masked":{"type":["string","null"]}},"required":["customer_receipts","failure_alerts_email_masked"]},"live_activation":{"type":"object","properties":{"eligible":{"type":"boolean"},"requirements":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"description":{"type":"string"},"satisfied":{"type":"boolean"},"owner":{"type":"string","enum":["merchant","operator"]}},"required":["id","description","satisfied","owner"]}}},"required":["eligible","requirements"]},"review_request":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","display_name","legal_name","status","country","brand_color","logo_url","default_settlement","support_email_masked","checkout_return_origins","notification_settings","live_activation","review_request","created_at"]},"CreateApiKeyRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"environment":{"default":"test","type":"string","enum":["test","live"]},"kind":{"default":"restricted","type":"string","enum":["secret","restricted"]},"scopes":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"string","enum":["payment_intents:read","payment_intents:write","payment_links:read","payment_links:write","refunds:read","refunds:write","refunds:write_new_destination","payouts:read","payouts:write","webhooks:read","webhooks:write","exports:read","receipts:read","policies:read","policies:write","plans:read","plans:write","agents:read","agents:write","protocols:read","protocols:write","usage:write","conditions:read","conditions:write","escrows:read","escrows:write","disputes:read","disputes:write","beneficiaries:read","beneficiaries:write","fiat:read","fiat:write","approvals:read","approvals:write","merchants:read","merchants:write","api_keys:write","reports:read","recurring:read","recurring:write"]}},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"approval_request_id":{"type":"string","maxLength":64}},"required":["name","scopes"]},"ApiKey":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"api_key"},"name":{"type":"string"},"environment":{"type":"string","enum":["test","live"]},"kind":{"type":"string","enum":["secret","restricted"]},"prefix":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"secret":{"type":"string"},"signing_secret":{"type":"string"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","name","environment","kind","prefix","scopes","last_used_at","expires_at","revoked_at","created_at"]},"CreatePaymentLinkRequest":{"type":"object","properties":{"kind":{"type":"string","enum":["reusable","single_use"]},"title":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":500},"amount_type":{"default":"fixed","type":"string","enum":["fixed","payer_chosen"]},"amount":{"type":"object","properties":{"value":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","example":"USD"}},"required":["value","currency"]},"payer_amount":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$","example":"USD"},"minimum":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"maximum":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"}},"required":["currency","minimum","maximum"]},"settlement":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64}},"required":["asset_id","address"]},"reference_prefix":{"type":"string","pattern":"^[\\w\\-.:/#]{1,40}$"},"intent_expires_in_seconds":{"type":"integer","minimum":600,"maximum":2592000},"funding_policy":{"$ref":"#/components/schemas/FundingPolicy"},"collect_email":{"type":"boolean"},"max_uses":{"type":"integer","minimum":1,"maximum":1000000},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"return_url":{"type":"string","maxLength":2048},"metadata":{"$ref":"#/components/schemas/Metadata"}},"required":["kind","title"]},"UpdatePaymentLinkRequest":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":120},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"max_uses":{"anyOf":[{"type":"integer","minimum":1,"maximum":1000000},{"type":"null"}]},"metadata":{"$ref":"#/components/schemas/Metadata"},"version":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["version"]},"PaymentLink":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"payment_link"},"livemode":{"type":"boolean"},"kind":{"type":"string","enum":["reusable","single_use"]},"status":{"type":"string","enum":["ACTIVE","INACTIVE","COMPLETED","EXPIRED"]},"title":{"type":"string"},"description":{"type":["string","null"]},"amount_type":{"type":"string","enum":["fixed","payer_chosen"]},"amount":{"anyOf":[{"$ref":"#/components/schemas/FiatMoney"},{"type":"null"}]},"payer_amount":{"anyOf":[{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/FiatMoney"},"maximum":{"$ref":"#/components/schemas/FiatMoney"}},"required":["minimum","maximum"]},{"type":"null"}]},"settlement":{"type":"object","properties":{"asset_id":{"type":"string"},"address_masked":{"type":"string"}},"required":["asset_id","address_masked"]},"url":{"type":"string"},"return_url":{"type":["string","null"]},"uses_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"paid_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"max_uses":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","kind","status","title","description","amount_type","amount","payer_amount","settlement","url","return_url","uses_count","paid_count","max_uses","expires_at","metadata","version","created_at"]},"PublicPaymentLink":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"public_payment_link"},"livemode":{"type":"boolean"},"status":{"type":"string","enum":["ACTIVE","INACTIVE","COMPLETED","EXPIRED"]},"title":{"type":"string"},"description":{"type":["string","null"]},"amount_type":{"type":"string","enum":["fixed","payer_chosen"]},"amount":{"anyOf":[{"$ref":"#/components/schemas/FiatMoney"},{"type":"null"}]},"payer_amount":{"anyOf":[{"type":"object","properties":{"minimum":{"$ref":"#/components/schemas/FiatMoney"},"maximum":{"$ref":"#/components/schemas/FiatMoney"}},"required":["minimum","maximum"]},{"type":"null"}]},"merchant":{"type":"object","properties":{"display_name":{"type":"string"},"brand_color":{"type":["string","null"]},"logo_url":{"type":["string","null"]}},"required":["display_name","brand_color","logo_url"]},"collect_email":{"type":"boolean"}},"required":["id","object","livemode","status","title","description","amount_type","amount","payer_amount","merchant","collect_email"]},"OpenPaymentLinkRequest":{"type":"object","properties":{"customer_email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"amount":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"}}},"CreateRefundRequest":{"type":"object","properties":{"payment_intent_id":{"type":"string","maxLength":64},"amount_atomic":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},"reason":{"type":"string","enum":["requested_by_customer","duplicate","fraudulent","order_canceled","overpayment","other"]},"reason_detail":{"type":"string","maxLength":500},"destination":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64}},"required":["asset_id","address"]},"approval_request_id":{"type":"string","maxLength":64}},"required":["payment_intent_id","reason"]},"Refund":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"refund"},"livemode":{"type":"boolean"},"payment_intent_id":{"type":"string"},"status":{"type":"string","enum":["REQUESTED","VALIDATING","ACTION_REQUIRED","SUBMITTED","CONFIRMING","COMPLETED","FAILED","CANCELED","MANUAL_REVIEW"]},"reason":{"type":"string","enum":["requested_by_customer","duplicate","fraudulent","order_canceled","overpayment","other"]},"source":{"type":"string","enum":["provider_return","merchant_funded"]},"destination":{"type":"object","properties":{"kind":{"type":"string","enum":["original","changed"]},"asset_id":{"type":"string"},"address_masked":{"type":"string"}},"required":["kind","asset_id","address_masked"]},"amount":{"$ref":"#/components/schemas/Money"},"deducted_costs":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"net_amount_estimated":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"net_amount_sent":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"funding_instructions":{"anyOf":[{"type":"object","properties":{"address":{"type":"string"},"memo":{"type":["string","null"]},"amount":{"$ref":"#/components/schemas/Money"},"network_name":{"type":"string"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["address","memo","amount","network_name","expires_at"]},{"type":"null"}]},"provider":{"type":["string","null"]},"provider_reference":{"type":["string","null"]},"txid":{"type":["string","null"]},"initiated_by":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"}},"required":["type","id"]},"failure_reason":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"completed_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]}},"required":["id","object","livemode","payment_intent_id","status","reason","source","destination","amount","deducted_costs","net_amount_estimated","net_amount_sent","funding_instructions","provider","provider_reference","txid","initiated_by","failure_reason","created_at","updated_at","completed_at"]},"CreateWebhookEndpointRequest":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"description":{"type":"string","maxLength":200},"enabled_events":{"minItems":1,"maxItems":61,"type":"array","items":{"anyOf":[{"type":"string","const":"*"},{"type":"string","enum":["payment_intent.created","payment_intent.updated","payment_intent.quoted","payment_intent.authorized","payment_intent.funding_pending","payment_intent.funded","payment_intent.condition_pending","payment_intent.routing","payment_intent.partially_settled","payment_intent.settled","payment_intent.receipt_issued","payment_intent.expired","payment_intent.canceled","payment_intent.review_required","payment_intent.refund_pending","payment_intent.refunded","payment_intent.failed","payment_intent.underpaid","payment_intent.overpaid","order.created","order.status_changed","receipt.issued","receipt.superseded","refund.created","refund.action_required","refund.updated","refund.completed","refund.failed","payout.updated","payout_batch.updated","payment_link.updated","execution_plan.compiled","execution_plan.authorized","execution_plan.completed","execution_plan.partially_completed","execution_plan.updated","settlement_policy.updated","agent_authorization.revoked","agent_authorization.exhausted","usage.threshold_reached","billing_record.priced","billing_record.settled","billing_record.failed","protocol_transaction.settled","protocol_transaction.failed","condition.updated","condition.satisfied","condition.reversed","escrow.updated","escrow.funded","escrow.closed","milestone.updated","dispute.opened","dispute.updated","dispute.resolved","beneficiary.updated","fiat_transfer.updated","approval_request.created","approval_request.decided","reconciliation.exception"]}]}}},"required":["url","enabled_events"]},"UpdateWebhookEndpointRequest":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"description":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"enabled_events":{"minItems":1,"type":"array","items":{"anyOf":[{"type":"string","const":"*"},{"type":"string","enum":["payment_intent.created","payment_intent.updated","payment_intent.quoted","payment_intent.authorized","payment_intent.funding_pending","payment_intent.funded","payment_intent.condition_pending","payment_intent.routing","payment_intent.partially_settled","payment_intent.settled","payment_intent.receipt_issued","payment_intent.expired","payment_intent.canceled","payment_intent.review_required","payment_intent.refund_pending","payment_intent.refunded","payment_intent.failed","payment_intent.underpaid","payment_intent.overpaid","order.created","order.status_changed","receipt.issued","receipt.superseded","refund.created","refund.action_required","refund.updated","refund.completed","refund.failed","payout.updated","payout_batch.updated","payment_link.updated","execution_plan.compiled","execution_plan.authorized","execution_plan.completed","execution_plan.partially_completed","execution_plan.updated","settlement_policy.updated","agent_authorization.revoked","agent_authorization.exhausted","usage.threshold_reached","billing_record.priced","billing_record.settled","billing_record.failed","protocol_transaction.settled","protocol_transaction.failed","condition.updated","condition.satisfied","condition.reversed","escrow.updated","escrow.funded","escrow.closed","milestone.updated","dispute.opened","dispute.updated","dispute.resolved","beneficiary.updated","fiat_transfer.updated","approval_request.created","approval_request.decided","reconciliation.exception"]}]}},"status":{"type":"string","enum":["enabled","disabled"]},"rotate_secret":{"type":"boolean"},"rotate_overlap_hours":{"type":"integer","minimum":0,"maximum":168}}},"WebhookEndpoint":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"webhook_endpoint"},"livemode":{"type":"boolean"},"url":{"type":"string"},"description":{"type":["string","null"]},"enabled_events":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["enabled","disabled"]},"secret_id":{"type":"string"},"secret":{"type":"string"},"previous_secret_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","url","description","enabled_events","status","secret_id","previous_secret_expires_at","created_at"]},"WebhookEventSummary":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"event"},"type":{"type":"string"},"sequence":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resource":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"}},"required":["type","id"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"deliveries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"endpoint_id":{"type":"string"},"status":{"type":"string"},"attempts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"last_response_status":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"next_attempt_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"replay_of":{"type":["string","null"]}},"required":["id","endpoint_id","status","attempts","last_response_status","next_attempt_at","replay_of"]}}},"required":["id","object","type","sequence","resource","created_at","deliveries"]},"ReplayWebhookEventRequest":{"type":"object","properties":{"endpoint_id":{"type":"string","maxLength":64}}},"CreatePayoutBatchRequest":{"type":"object","properties":{"name":{"type":"string","maxLength":120},"csv":{"type":"string","maxLength":5242880},"rows":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"amount":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64},"reference":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[\\x20-\\x7E]+$","example":"INV-1048"},"beneficiary_name":{"type":"string","maxLength":120}},"required":["asset_id","amount","address"]}},"control_totals":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"additionalProperties":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"}}},"required":["control_totals"]},"Payout":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"payout"},"row_number":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"status":{"type":"string","enum":["PENDING","VALIDATED","REJECTED","QUEUED","SUBMITTED","PROCESSING","COMPLETED","FAILED","CANCELED","MANUAL_REVIEW"]},"amount":{"$ref":"#/components/schemas/Money"},"destination_masked":{"type":"string"},"reference":{"type":["string","null"]},"validation_errors":{"type":"array","items":{"type":"string"}},"provider_payout_id":{"type":["string","null"]},"txid":{"type":["string","null"]},"failure_reason":{"type":["string","null"]}},"required":["id","object","row_number","status","amount","destination_masked","reference","validation_errors","provider_payout_id","txid","failure_reason"]},"PayoutBatch":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"payout_batch"},"livemode":{"type":"boolean"},"status":{"type":"string","enum":["DRAFT","VALIDATING","VALIDATION_FAILED","AWAITING_APPROVAL","APPROVED","SUBMITTED","PROCESSING","COMPLETED","PARTIALLY_COMPLETED","FAILED","CANCELED"]},"name":{"type":["string","null"]},"provider":{"type":"string"},"file_sha256":{"type":"string"},"row_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"totals":{"type":"array","items":{"$ref":"#/components/schemas/Money"}},"validation_errors":{"type":"array","items":{"type":"object","properties":{"row":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"errors":{"type":"array","items":{"type":"string"}}},"required":["row","errors"]}},"requires_approval":{"type":"boolean"},"approved_by":{"type":["string","null"]},"completed_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"items":{"type":"array","items":{"$ref":"#/components/schemas/Payout"}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"submitted_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"completed_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]}},"required":["id","object","livemode","status","name","provider","file_sha256","row_count","totals","validation_errors","requires_approval","approved_by","completed_count","failed_count","created_at","submitted_at","completed_at"]},"CreateRecurringScheduleRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"rule":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"amount":{"type":"object","properties":{"value":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","example":"USD"}},"required":["value","currency"]},"line_items":{"maxItems":50,"type":"array","items":{"$ref":"#/components/schemas/LineItem"}},"settlement":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64}},"required":["asset_id","address"]},"settlement_policy_id":{"type":"string","pattern":"^pol_[0-9A-Za-z]{16,40}$"},"customer_email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"reference_template":{"type":"string","minLength":1,"maxLength":64},"grace_period_hours":{"type":"integer","minimum":0,"maximum":2160},"max_reminders":{"type":"integer","minimum":0,"maximum":10},"reminder_interval_hours":{"type":"integer","minimum":1,"maximum":720},"intent_expires_in_seconds":{"type":"integer","minimum":3600,"maximum":7776000}},"required":["name","rule","amount","reference_template"]},"RecurringSchedule":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"recurring_schedule"},"livemode":{"type":"boolean"},"status":{"type":"string","enum":["ACTIVE","PAUSED","COMPLETED","CANCELED"]},"name":{"type":"string"},"rule":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"amount":{"$ref":"#/components/schemas/FiatMoney"},"settlement":{"anyOf":[{"type":"object","properties":{"asset_id":{"type":"string"},"address_masked":{"type":"string"}},"required":["asset_id","address_masked"]},{"type":"null"}]},"settlement_policy_id":{"type":["string","null"]},"customer_email_masked":{"type":["string","null"]},"reference_template":{"type":"string"},"next_occurrence_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"occurrences_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"upcoming":{"type":"array","items":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","status","name","rule","amount","settlement","settlement_policy_id","customer_email_masked","reference_template","next_occurrence_at","occurrences_count","upcoming","created_at"]},"TransactionsExportQuery":{"type":"object","properties":{"created_gte":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"created_lt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"status":{"type":"string","maxLength":32}},"required":["created_gte","created_lt"]},"ReceiptsExportQuery":{"type":"object","properties":{"created_gte":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"created_lt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["created_gte","created_lt"]},"PolicyFallback":{"type":"object","properties":{"asset":{"type":"string","pattern":"^[A-Za-z0-9]{1,12}$","example":"USDC"},"network":{"type":"string","minLength":3,"maxLength":64},"destination":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"}},"required":["asset","network"],"additionalProperties":false},"PolicyOutput":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_]{1,32}$"},"amount":{"$ref":"#/components/schemas/AmountRule"},"asset":{"type":"string","pattern":"^[A-Za-z0-9]{1,12}$","example":"USDC"},"network":{"type":"string","minLength":3,"maxLength":64},"destination":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"},"fallbacks":{"default":[],"maxItems":5,"type":"array","items":{"$ref":"#/components/schemas/PolicyFallback"}},"priority":{"default":0,"type":"integer","minimum":0,"maximum":1000},"fee_payer":{"type":"string","enum":["sender","recipient","split"]},"depends_on":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-z0-9_]{1,32}$"}}},"required":["id","amount","asset","network","destination"],"additionalProperties":false},"PolicyConstraints":{"type":"object","properties":{"max_total_fee_bps":{"type":"integer","minimum":0,"maximum":10000},"complete_within_seconds":{"type":"integer","minimum":60,"maximum":604800},"min_route_success_rate":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"allowed_providers":{"maxItems":20,"type":"array","items":{"type":"string","maxLength":40}},"denied_providers":{"maxItems":20,"type":"array","items":{"type":"string","maxLength":40}},"allow_multi_hop":{"default":true,"type":"boolean"},"max_hops":{"default":2,"type":"integer","minimum":1,"maximum":3}},"additionalProperties":false},"SettlementPolicyDocument":{"type":"object","properties":{"version":{"type":"string","enum":["2026-09-24"]},"name":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"},"description":{"type":"string","maxLength":500},"denomination":{"anyOf":[{"type":"string","pattern":"^[A-Z]{3}$","example":"USD"},{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"}]},"conversion":{"default":"par","type":"string","enum":["par","reference_rate"]},"outputs":{"minItems":1,"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/PolicyOutput"}},"constraints":{"default":{"allow_multi_hop":true,"max_hops":2},"$ref":"#/components/schemas/PolicyConstraints"},"fee_policy":{"default":{"payer":"sender"},"type":"object","properties":{"payer":{"type":"string","enum":["sender","recipient","split"]}},"required":["payer"],"additionalProperties":false}},"required":["version","name","denomination","outputs"],"additionalProperties":false},"PolicyIssue":{"type":"object","properties":{"path":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"required":["path","code","message"]},"PolicyValidation":{"type":"object","properties":{"valid":{"type":"boolean"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/PolicyIssue"}},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/PolicyIssue"}},"summary":{"type":"array","items":{"type":"string"}}},"required":["valid","errors","warnings","summary"]},"CreatePolicyDestinationRequest":{"type":"object","properties":{"key":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"},"label":{"type":"string","minLength":1,"maxLength":80},"network":{"type":"string","minLength":3,"maxLength":64},"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64}},"required":["key","label","network","address"],"additionalProperties":false},"VerifyPolicyDestinationRequest":{"oneOf":[{"type":"object","properties":{"method":{"type":"string","const":"attestation"},"step_up_password":{"type":"string","minLength":1,"maxLength":256},"statement":{"type":"string","const":"I control this wallet and it can receive the selected asset."},"approval_request_id":{"type":"string","maxLength":64}},"required":["method","statement"],"additionalProperties":false},{"type":"object","properties":{"method":{"type":"string","const":"signature"},"signature":{"type":"string","minLength":16,"maxLength":256},"approval_request_id":{"type":"string","maxLength":64}},"required":["method","signature"],"additionalProperties":false}]},"PolicyDestination":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"policy_destination"},"livemode":{"type":"boolean"},"key":{"type":"string"},"label":{"type":"string"},"network_id":{"type":"string"},"network_name":{"type":["string","null"]},"address_masked":{"type":"string"},"memo_present":{"type":"boolean"},"verification_status":{"type":"string","enum":["unverified","attested","signature_verified"]},"verification_method":{"anyOf":[{"type":"string","enum":["attestation","signature"]},{"type":"null"}]},"ownership_challenge":{"type":["string","null"]},"signature_supported":{"type":"boolean"},"verified_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"status":{"type":"string","enum":["active","disabled"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","key","label","network_id","network_name","address_masked","memo_present","verification_status","verification_method","ownership_challenge","signature_supported","verified_at","status","created_at"]},"CreateSettlementPolicyRequest":{"type":"object","properties":{"document":{},"activate":{"default":false,"type":"boolean"}},"required":["document"]},"CreatePolicyVersionRequest":{"type":"object","properties":{"document":{},"activate":{"default":false,"type":"boolean"}},"required":["document"]},"SettlementPolicyVersion":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"settlement_policy_version"},"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"document":{},"document_hash":{"type":"string"},"validation":{"$ref":"#/components/schemas/PolicyValidation"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","version","document","document_hash","validation","created_at"]},"SettlementPolicy":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"settlement_policy"},"livemode":{"type":"boolean"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","active","inactive"]},"active_version":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"latest_version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"versions":{"type":"array","items":{"$ref":"#/components/schemas/SettlementPolicyVersion"}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","name","status","active_version","latest_version","versions","created_at","updated_at"]},"SimulatePolicyRequest":{"type":"object","properties":{"version":{"type":"integer","minimum":1,"maximum":9007199254740991},"amount":{"type":"object","properties":{"value":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"}},"required":["value"]},"funding_asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"mode":{"default":"live_quotes","type":"string","enum":["live_quotes","historical"]},"historical_limit":{"default":10,"type":"integer","minimum":1,"maximum":50}},"required":["funding_asset_id"]},"OutputAllocation":{"type":"object","properties":{"output_id":{"type":"string"},"amount_rule":{"$ref":"#/components/schemas/AmountRule"},"denomination_amount_minor":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},"target":{"$ref":"#/components/schemas/Money"},"rounding_dust_minor":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"}},"required":["output_id","amount_rule","denomination_amount_minor","target","rounding_dust_minor"]},"CreateExecutionPlanRequest":{"type":"object","properties":{"funding_asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"refund_address":{"type":"string","minLength":1,"maxLength":128},"refund_memo":{"type":"string","minLength":1,"maxLength":64},"dry_run":{"default":false,"type":"boolean"}},"required":["funding_asset_id"]},"AuthorizeExecutionPlanRequest":{"type":"object","properties":{"plan_hash":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"acknowledgements":{"default":{"multiple_deposits":false,"not_atomic":false,"memo_required":false,"provider_terms":false},"type":"object","properties":{"multiple_deposits":{"default":false,"type":"boolean"},"not_atomic":{"default":false,"type":"boolean"},"memo_required":{"default":false,"type":"boolean"},"provider_terms":{"default":false,"type":"boolean"}}}},"required":["plan_hash"]},"SubmitDirectTransferRequest":{"type":"object","properties":{"txid":{"type":"string","pattern":"^[0-9A-Za-z]{16,128}$"}},"required":["txid"]},"RouteCandidate":{"type":"object","properties":{"output_id":{"type":"string"},"route":{"type":"string"},"hops":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"}},"required":["provider","from","to"]}},"eligible":{"type":"boolean"},"rejection_reasons":{"type":"array","items":{"type":"string"}},"score_micro_usd":{"type":["string","null"]},"rank":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"selected":{"type":"boolean"}},"required":["output_id","route","hops","eligible","rejection_reasons","score_micro_usd","rank","selected"]},"PlanLeg":{"type":"object","properties":{"output_id":{"type":"string"},"step_id":{"type":"string"},"kind":{"type":"string","enum":["provider_swap","direct_transfer"]},"status":{"type":"string","enum":["PENDING","READY","RESERVED","SUBMITTED","IN_PROGRESS","AWAITING_FINALITY","AWAITING_CONDITION","SUCCEEDED","COMPENSATING","COMPENSATED","FAILED_RETRYABLE","FAILED_TERMINAL","MANUAL_REVIEW"]},"deposit":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"deposit_address":{"type":["string","null"]},"deposit_memo":{"type":["string","null"]},"deposit_expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"receives":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"provider":{"type":["string","null"]},"provider_display_name":{"type":["string","null"]},"provider_terms_url":{"type":["string","null"]},"qr_payload":{"type":["string","null"]},"warnings":{"type":"array","items":{"type":"string"}},"order_id":{"type":["string","null"]},"settle_txid":{"type":["string","null"]}},"required":["output_id","step_id","kind","status","deposit","deposit_address","deposit_memo","deposit_expires_at","receives","provider","provider_display_name","provider_terms_url","qr_payload","warnings","order_id","settle_txid"]},"ExecutionPlanResponse":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"execution_plan"},"livemode":{"type":"boolean"},"payment_intent_id":{"type":"string"},"intent_version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"status":{"type":"string","enum":["COMPILED","AUTHORIZED","EXECUTING","COMPLETED","PARTIALLY_COMPLETED","COMPENSATING","FAILED","CANCELED","EXPIRED","SUPERSEDED","MANUAL_REVIEW"]},"plan_hash":{"type":"string"},"compiler_version":{"type":"string"},"policy_version_id":{"type":["string","null"]},"supersedes_plan_id":{"type":["string","null"]},"funding":{"type":"object","properties":{"asset_id":{"type":["string","null"]},"total":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]}},"required":["asset_id","total"]},"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"},"type":{"type":"string","enum":["COLLECT_ONCHAIN","COLLECT_FIAT","VERIFY_AUTHORIZATION","SCREEN_PARTIES","SWAP","BRIDGE","WAIT_FINALITY","WAIT_CONDITION","SPLIT","SETTLE_ONCHAIN","OFFRAMP","SETTLE_FIAT","REFUND","ISSUE_RECEIPT"]},"depends_on":{"type":"array","items":{"type":"string"}},"provider":{"type":["string","null"]},"input":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},{"type":"null"}]},"output":{"anyOf":[{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},{"type":"null"}]},"output_id":{"type":["string","null"]},"retry_policy":{"type":"object","properties":{"max_attempts":{"type":"integer","minimum":1,"maximum":20},"backoff_seconds":{"maxItems":20,"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["max_attempts","backoff_seconds"]},"timeout_seconds":{"type":"integer","minimum":1,"maximum":9007199254740991},"compensation":{"type":"string","enum":["none","refund_payer","reverse_swap","release_hold","return_fiat","manual_review"]},"params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/__shared#/$defs/schema0"}},"status":{"type":"string","enum":["PENDING","READY","RESERVED","SUBMITTED","IN_PROGRESS","AWAITING_FINALITY","AWAITING_CONDITION","SUCCEEDED","COMPENSATING","COMPENSATED","FAILED_RETRYABLE","FAILED_TERMINAL","MANUAL_REVIEW"]},"attempts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","type","depends_on","provider","input","output","output_id","retry_policy","timeout_seconds","compensation","params","status","attempts"]}},"legs":{"type":"array","items":{"$ref":"#/components/schemas/PlanLeg"}},"allocations":{"type":"array","items":{"$ref":"#/components/schemas/OutputAllocation"}},"hard_constraints":{"type":"array","items":{"$ref":"#/components/schemas/Constraint"}},"estimated_cost":{"$ref":"#/components/schemas/CostBreakdown"},"estimated_completion_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"authorization":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"method":{"type":"string"},"authorized_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","method","authorized_at"]},{"type":"null"}]},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"dry_run":{"type":"boolean"}},"required":["id","object","livemode","payment_intent_id","intent_version","status","plan_hash","compiler_version","policy_version_id","supersedes_plan_id","funding","steps","legs","allocations","hard_constraints","estimated_cost","estimated_completion_seconds","authorization","expires_at","created_at","dry_run"]},"ExecutionPlanExplanation":{"type":"object","properties":{"object":{"type":"string","const":"execution_plan_explanation"},"plan_id":{"type":"string"},"plan_hash":{"type":"string"},"summary":{"type":"string"},"outputs":{"type":"array","items":{"type":"object","properties":{"output_id":{"type":"string"},"text":{"type":"string"},"selected_route":{"type":["string","null"]},"fallbacks_considered":{"type":"array","items":{"type":"string"}},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/RouteCandidate"}}},"required":["output_id","text","selected_route","fallbacks_considered","candidates"]}},"fees":{"type":"array","items":{"type":"string"}},"timing":{"type":"string"},"atomicity":{"type":"string"},"inputs":{"type":"object","properties":{"capability_snapshot_id":{"type":"string"},"rate_source":{"type":"string"},"rates_as_of":{"type":"string"},"scoring_weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"compiler_version":{"type":"string"}},"required":["capability_snapshot_id","rate_source","rates_as_of","scoring_weights","compiler_version"]}},"required":["object","plan_id","plan_hash","summary","outputs","fees","timing","atomicity","inputs"]},"ProtocolResource":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"description":{"type":"string","maxLength":500},"mime_type":{"type":"string","maxLength":100},"service_name":{"type":"string","minLength":1,"maxLength":32,"pattern":"^[\\x20-\\x7e]+$"},"category":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[a-z0-9][a-z0-9_.-]*$"}},"required":["url"]},"CreateProtocolChallengeRequest":{"type":"object","properties":{"payment_intent_id":{"type":"string","maxLength":64},"price":{"type":"object","properties":{"value":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"}},"required":["value","asset_id"]},"pay_to":{"type":"string","minLength":1,"maxLength":128},"resource":{"$ref":"#/components/schemas/ProtocolResource"},"max_timeout_seconds":{"default":60,"type":"integer","minimum":10,"maximum":3600},"description":{"type":"string","maxLength":200},"external_reference":{"type":"string","maxLength":128},"agent_authorization_id":{"type":"string","maxLength":64}},"required":["resource"]},"ProtocolHeaders":{"type":"object","propertyNames":{"type":"string","maxLength":64},"additionalProperties":{"type":"string","maxLength":16384}},"VerifyProtocolPaymentRequest":{"type":"object","properties":{"protocol_transaction_id":{"type":"string","maxLength":64},"resource_url":{"type":"string","maxLength":2048,"format":"uri"},"headers":{"$ref":"#/components/schemas/ProtocolHeaders"}},"required":["resource_url","headers"]},"SettleProtocolPaymentRequest":{"type":"object","properties":{"protocol_transaction_id":{"type":"string","maxLength":64}},"required":["protocol_transaction_id"]},"RawProtocolMessage":{"type":"object","properties":{"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"body":{}},"required":["status","headers"]},"ProtocolTransaction":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"protocol_transaction"},"livemode":{"type":"boolean"},"protocol":{"type":"string","enum":["x402","mpp"]},"protocol_version":{"type":"string"},"status":{"type":"string","enum":["CHALLENGED","VERIFYING","VERIFIED","BOUND","SETTLING","SETTLED","REJECTED","FAILED","EXPIRED","MANUAL_REVIEW"]},"payment_intent_id":{"type":"string"},"execution_plan_id":{"type":["string","null"]},"resource_url":{"type":"string"},"amount":{"$ref":"#/components/schemas/Money"},"network":{"type":"string","pattern":"^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$","description":"CAIP-2 network identifier","example":"eip155:8453"},"pay_to_masked":{"type":"string"},"payer_masked":{"type":["string","null"]},"agent_authorization_id":{"type":["string","null"]},"agent_id":{"type":["string","null"]},"principal_id":{"type":["string","null"]},"binding_hash":{"type":["string","null"]},"settlement":{"anyOf":[{"type":"object","properties":{"transaction":{"type":"string"},"network":{"type":"string"},"facilitator":{"type":["string","null"]}},"required":["transaction","network","facilitator"]},{"type":"null"}]},"receipt_id":{"type":["string","null"]},"failure_reason":{"type":["string","null"]},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"response":{"$ref":"#/components/schemas/RawProtocolMessage"}},"required":["id","object","livemode","protocol","protocol_version","status","payment_intent_id","execution_plan_id","resource_url","amount","network","pay_to_masked","payer_masked","agent_authorization_id","agent_id","principal_id","binding_hash","settlement","receipt_id","failure_reason","expires_at","created_at"]},"AgentIdentityInput":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"software_version":{"type":"string","maxLength":40},"wallet_address":{"type":"string","minLength":1,"maxLength":128},"network":{"default":"eip155:8453","type":"string","pattern":"^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$","description":"CAIP-2 network identifier","example":"eip155:8453"}},"required":["name","wallet_address"]},"CreateAgentPrincipalRequest":{"type":"object","properties":{"display_name":{"type":"string","minLength":1,"maxLength":120},"kind":{"type":"string","enum":["person","organization","pseudonymous"]},"external_reference":{"type":"string","maxLength":128},"pseudonymous_key":{"type":"string","maxLength":128},"agents":{"default":[],"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/AgentIdentityInput"}},"metadata":{"$ref":"#/components/schemas/Metadata"}},"required":["display_name","kind"]},"AgentPrincipal":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"agent_principal"},"livemode":{"type":"boolean"},"display_name":{"type":"string"},"kind":{"type":"string"},"external_reference":{"type":["string","null"]},"status":{"type":"string","enum":["active","disabled"]},"agents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"software_version":{"type":["string","null"]},"wallet_address_masked":{"type":"string"},"network":{"type":"string"},"status":{"type":"string","enum":["active","disabled"]}},"required":["id","name","software_version","wallet_address_masked","network","status"]}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","display_name","kind","external_reference","status","agents","created_at"]},"CreateAgentAuthorizationRequest":{"type":"object","properties":{"principal_id":{"type":"string","maxLength":64},"agent_id":{"type":"string","maxLength":64},"mode":{"type":"string","enum":["human_present","delegated"]},"limit_asset_id":{"default":"usdc-base","type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"max_per_transaction":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"max_per_day":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"max_per_month":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"allowed_protocols":{"default":["x402"],"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["x402","mpp"]}},"allowed_assets":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"}},"allowed_networks":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$","description":"CAIP-2 network identifier","example":"eip155:8453"}},"allowed_resource_prefixes":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","maxLength":2048,"format":"uri"}},"allowed_categories":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[a-z0-9][a-z0-9_.-]*$"}},"refund_required":{"default":false,"type":"boolean"},"replay_window_seconds":{"default":300,"type":"integer","minimum":10,"maximum":3600},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"metadata":{"$ref":"#/components/schemas/Metadata"}},"required":["principal_id","mode","max_per_transaction","expires_at"]},"AgentAuthorization":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"agent_authorization"},"livemode":{"type":"boolean"},"principal_id":{"type":"string"},"agent_id":{"type":["string","null"]},"status":{"type":"string","enum":["ACTIVE","SUSPENDED","EXHAUSTED","REVOKED","EXPIRED"]},"mode":{"type":"string","enum":["human_present","delegated"]},"limits":{"type":"object","properties":{"asset_id":{"type":"string"},"max_per_transaction":{"$ref":"#/components/schemas/Money"},"max_per_day":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"max_per_month":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]}},"required":["asset_id","max_per_transaction","max_per_day","max_per_month"]},"allowed_protocols":{"type":"array","items":{"type":"string"}},"allowed_assets":{"type":"array","items":{"type":"string"}},"allowed_networks":{"type":"array","items":{"type":"string"}},"allowed_resource_prefixes":{"type":"array","items":{"type":"string"}},"allowed_categories":{"type":"array","items":{"type":"string"}},"refund_required":{"type":"boolean"},"replay_window_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"inspection_token":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","principal_id","agent_id","status","mode","limits","allowed_protocols","allowed_assets","allowed_networks","allowed_resource_prefixes","allowed_categories","refund_required","replay_window_seconds","expires_at","revoked_at","inspection_token","created_at"]},"AgentAuthorizationUsage":{"type":"object","properties":{"object":{"type":"string","const":"agent_authorization_usage"},"authorization_id":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","SUSPENDED","EXHAUSTED","REVOKED","EXPIRED"]},"asset_id":{"type":"string"},"today":{"type":"object","properties":{"used":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},"reserved":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},"limit":{"anyOf":[{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},{"type":"null"}]}},"required":["used","reserved","limit"]},"month":{"type":"object","properties":{"used":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},"reserved":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},"limit":{"anyOf":[{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},{"type":"null"}]}},"required":["used","reserved","limit"]},"per_transaction_limit":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},"recent":{"type":"array","items":{"type":"object","properties":{"amount_atomic":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},"status":{"type":"string"},"protocol_transaction_id":{"type":["string","null"]},"billing_record_id":{"type":["string","null"]},"occurred_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["amount_atomic","status","protocol_transaction_id","billing_record_id","occurred_at"]}},"metered":{"type":"array","items":{"type":"object","properties":{"meter_id":{"type":"string"},"asset_id":{"type":"string"},"unbilled_quantity":{"type":"string"},"unbilled_amount_atomic":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},"billing_records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"amount_atomic":{"type":"string"},"status":{"type":"string"}},"required":["id","amount_atomic","status"]}}},"required":["meter_id","asset_id","unbilled_quantity","unbilled_amount_atomic","billing_records"]}}},"required":["object","authorization_id","status","asset_id","today","month","per_transaction_limit","recent","metered"]},"CreateMeterRequest":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"},"unit":{"type":"string","enum":["request","token","byte","second"]},"asset_id":{"default":"usdc-base","type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"unit_price_atomic":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},"unit_quantity":{"default":"1","type":"string","pattern":"^[1-9]\\d{0,17}$"},"protocol":{"default":"x402","type":"string","enum":["x402","mpp"]},"category":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[a-z0-9][a-z0-9_.-]*$"},"checkpoint_amount_atomic":{"type":"string","maxLength":80,"pattern":"^(0|[1-9]\\d*)$","description":"Non-negative integer string in the smallest unit (never a float).","example":"1000000000"},"checkpoint_max_seconds":{"default":86400,"type":"integer","minimum":60,"maximum":2592000},"resource_url":{"type":"string","maxLength":2048,"format":"uri"},"pay_to":{"type":"string","minLength":1,"maxLength":128}},"required":["name","unit","unit_price_atomic","checkpoint_amount_atomic"]},"Meter":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"meter"},"livemode":{"type":"boolean"},"name":{"type":"string"},"unit":{"type":"string","enum":["request","token","byte","second"]},"asset_id":{"type":"string"},"unit_price_atomic":{"type":"string"},"unit_quantity":{"type":"string"},"protocol":{"type":"string","enum":["x402","mpp"]},"checkpoint_amount_atomic":{"type":"string"},"checkpoint_max_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resource_url":{"type":["string","null"]},"category":{"type":["string","null"]},"pay_to_masked":{"type":"string"},"status":{"type":"string","enum":["active","disabled"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","name","unit","asset_id","unit_price_atomic","unit_quantity","protocol","checkpoint_amount_atomic","checkpoint_max_seconds","resource_url","category","pay_to_masked","status","created_at"]},"RecordUsageRequest":{"type":"object","properties":{"source_event_id":{"type":"string","minLength":1,"maxLength":128},"agent_authorization_id":{"type":"string","maxLength":64},"quantity":{"type":"string","pattern":"^[1-9]\\d{0,17}$"},"occurred_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["source_event_id","agent_authorization_id","quantity"]},"BillingRecord":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"billing_record"},"livemode":{"type":"boolean"},"meter_id":{"type":"string"},"agent_authorization_id":{"type":"string"},"status":{"type":"string","enum":["priced","settling","settled","failed"]},"quantity":{"type":"string"},"event_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"usage_from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"usage_to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"first_event_id":{"type":"string"},"last_event_id":{"type":"string"},"amount":{"$ref":"#/components/schemas/Money"},"unit_price_atomic":{"type":"string"},"unit_quantity":{"type":"string"},"rounding":{"type":"string","const":"up"},"settlement":{"anyOf":[{"type":"object","properties":{"protocol_transaction_id":{"type":"string"},"payment_intent_id":{"type":"string"},"receipt_id":{"type":["string","null"]}},"required":["protocol_transaction_id","payment_intent_id","receipt_id"]},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","meter_id","agent_authorization_id","status","quantity","event_count","usage_from","usage_to","first_event_id","last_event_id","amount","unit_price_atomic","unit_quantity","rounding","settlement","created_at"]},"UsageEventResult":{"type":"object","properties":{"object":{"type":"string","const":"usage_event"},"id":{"type":"string"},"duplicate":{"type":"boolean"},"unbilled_quantity":{"type":"string"},"unbilled_amount_atomic":{"type":"string"},"billing_record":{"anyOf":[{"$ref":"#/components/schemas/BillingRecord"},{"type":"null"}]},"settlement":{"anyOf":[{"$ref":"#/components/schemas/ProtocolTransaction"},{"type":"null"}]}},"required":["object","id","duplicate","unbilled_quantity","unbilled_amount_atomic","billing_record","settlement"]},"PaymentCapabilities":{"type":"object","properties":{"object":{"type":"string","const":"payment_capabilities"},"issuer":{"type":"string"},"api_version":{"type":"string"},"protocols":{"type":"array","items":{"type":"object","properties":{"protocol":{"type":"string"},"versions":{"type":"array","items":{"type":"string"}},"schemes":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"string"}},"assets":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string"},"network":{"type":"string"},"asset":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["asset_id","network","asset","symbol","decimals"]}},"settlement":{"type":"object","properties":{"mode":{"type":"string"},"facilitator":{"type":["string","null"]}},"required":["mode","facilitator"]},"live":{"type":"boolean"},"enabled":{"type":"boolean"},"notes":{"type":"array","items":{"type":"string"}}},"required":["protocol","versions","schemes","networks","assets","settlement","live","enabled","notes"]}},"receipts":{"type":"object","properties":{"key_set_url":{"type":"string"},"verification_url":{"type":"string"}},"required":["key_set_url","verification_url"]},"endpoints":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["object","issuer","api_version","protocols","receipts","endpoints"]},"CreateVerifierConfigurationRequest":{"type":"object","properties":{"type":{"type":"string","enum":["PLATFORM_WEBHOOK","SIGNED_ATTESTATION","COMPUTE_RESULT","ORACLE_EVENT","MULTI_APPROVAL"]},"name":{"type":"string","minLength":1,"maxLength":80},"public_keys":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"threshold":{"type":"integer","minimum":1,"maximum":10},"affiliation":{"default":"independent","type":"string","enum":["independent","merchant","platform"]},"self_dealing_disclosure":{"type":"string","maxLength":500},"config":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["type","name"]},"VerifierConfiguration":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"verifier_configuration"},"livemode":{"type":"boolean"},"type":{"type":"string","enum":["TIME","BUYER_APPROVAL","MERCHANT_FULFILLMENT","PLATFORM_WEBHOOK","SIGNED_ATTESTATION","COMPUTE_RESULT","ORACLE_EVENT","MILESTONE","NO_DISPUTE_WINDOW","MULTI_APPROVAL"]},"name":{"type":"string"},"schema_version":{"type":"string"},"public_keys":{"type":"array","items":{"type":"string"}},"threshold":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"affiliation":{"type":"string","enum":["independent","merchant","platform"]},"self_dealing_disclosure":{"type":["string","null"]},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"config_hash":{"type":"string"},"status":{"type":"string","enum":["active","revoked"]},"webhook_url":{"type":["string","null"]},"webhook_secret":{"type":["string","null"]},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","type","name","schema_version","public_keys","threshold","affiliation","self_dealing_disclosure","config","config_hash","status","webhook_url","webhook_secret","revoked_at","created_at"]},"SubmitEvidenceRequest":{"type":"object","properties":{"condition_id":{"type":"string","maxLength":64},"payload":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"files":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"content_type":{"type":"string","maxLength":80},"content_base64":{"type":"string","maxLength":7000000}},"required":["name","content_type","content_base64"]}}},"required":["condition_id"]},"VerificationResult":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"verification_result"},"outcome":{"type":"string","enum":["satisfied","rejected","pending","conflicted","review","invalid","reversed","decided"]},"reason":{"type":"string"},"checks":{"type":"array","items":{"type":"string"}},"evidence_id":{"type":["string","null"]},"supersedes_result_id":{"type":["string","null"]},"result_hash":{"type":"string"},"document":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"signature":{"type":"object","properties":{"kid":{"type":"string"},"protected":{"type":"string"},"signature":{"type":"string"}},"required":["kid","protected","signature"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","outcome","reason","checks","evidence_id","supersedes_result_id","result_hash","document","signature","created_at"]},"Condition":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"condition"},"livemode":{"type":"boolean"},"key":{"type":"string"},"class":{"type":"string","enum":["TIME","BUYER_APPROVAL","MERCHANT_FULFILLMENT","PLATFORM_WEBHOOK","SIGNED_ATTESTATION","COMPUTE_RESULT","ORACLE_EVENT","MILESTONE","NO_DISPUTE_WINDOW","MULTI_APPROVAL"]},"status":{"type":"string","enum":["PENDING","EVIDENCE_SUBMITTED","VERIFYING","SATISFIED","REJECTED","CONFLICTED","UNDER_REVIEW","TIMED_OUT","DISPUTED","REVERSED","FAILED","WAIVED","CANCELED"]},"status_reason":{"type":["string","null"]},"summary":{"type":"string"},"verifier":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":"string"},"affiliation":{"type":"string"}},"required":["id","name","affiliation"]},"config_hash":{"type":"string"},"deadline":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"on_timeout":{"type":"string","enum":["refund","release","review"]},"dispute_eligible":{"type":"boolean"},"human_review_required":{"type":"boolean"},"next_check_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"satisfied_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"escrow_id":{"type":"string"},"payment_intent_id":{"type":["string","null"]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"submitted_by":{"type":"string"},"payload_hash":{"type":"string"},"file_hashes":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","submitted_by","payload_hash","file_hashes","created_at"]}},"results":{"type":"array","items":{"$ref":"#/components/schemas/VerificationResult"}}},"required":["id","object","livemode","key","class","status","status_reason","summary","verifier","config_hash","deadline","on_timeout","dispute_eligible","human_review_required","next_check_at","satisfied_at","escrow_id","payment_intent_id","evidence","results"]},"DisputeResolver":{"type":"object","properties":{"type":{"type":"string","enum":["hold_adapter_partner","third_party","platform_sandbox"]},"name":{"type":"string","minLength":1,"maxLength":120},"contact":{"type":"string","maxLength":200}},"required":["type","name"]},"DisputePolicy":{"type":"object","properties":{"resolver":{"$ref":"#/components/schemas/DisputeResolver"},"evidence_window_seconds":{"default":604800,"type":"integer","minimum":3600,"maximum":2592000},"appeal_window_seconds":{"default":0,"type":"integer","minimum":0,"maximum":2592000},"fee_description":{"default":"No dispute fee","type":"string","maxLength":200},"allowed_evidence":{"default":["documents","images","messages"],"maxItems":10,"type":"array","items":{"type":"string","maxLength":60}},"conflicts_policy":{"default":"The resolver must not be affiliated with either party; a resolver with a conflict must recuse and a different resolver decides.","type":"string","minLength":10,"maxLength":500}},"required":["resolver"]},"MilestoneInput":{"type":"object","properties":{"key":{"type":"string","pattern":"^[a-z0-9_]{1,32}$"},"title":{"type":"string","minLength":1,"maxLength":120},"deliverable_schema":{"default":{"required":[]},"type":"object","properties":{"required":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","maxLength":60}}}},"amount":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"percentage":{"type":"string","pattern":"^(100(\\.0{1,4})?|[0-9]{1,2}(\\.[0-9]{1,4})?)$"},"due_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"review_window_seconds":{"default":259200,"type":"integer","minimum":3600,"maximum":2592000},"auto_approve":{"default":false,"type":"boolean"},"depends_on":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-z0-9_]{1,32}$"}},"submitter":{"default":{"type":"merchant"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"merchant"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"named"},"name":{"type":"string","minLength":1,"maxLength":120},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["type","name","email"]}]},"approver":{"default":{"type":"payer"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"payer"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"named"},"name":{"type":"string","minLength":1,"maxLength":120},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["type","name","email"]}]},"release_destination":{"type":"object","properties":{"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64}},"required":["address"]},"dispute_resolver":{"$ref":"#/components/schemas/DisputeResolver"},"verifier_conditions":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-z0-9_]{1,32}$"}}},"required":["key","title"]},"CreateEscrowRequest":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"amount":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"release_destination":{"type":"object","properties":{"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64}},"required":["address"]},"hold_adapter":{"default":"sandbox_escrow","type":"string","enum":["sandbox_escrow","trustless_work"]},"conditions":{"default":[],"maxItems":10,"type":"array","items":{"$ref":"#/components/schemas/IntentConditionInput"}},"milestones":{"default":[],"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/MilestoneInput"}},"dispute_policy":{"$ref":"#/components/schemas/DisputePolicy"},"expires_in_seconds":{"default":2592000,"type":"integer","minimum":3600,"maximum":31536000},"description":{"type":"string","maxLength":500},"external_reference":{"type":"string","maxLength":128},"metadata":{"$ref":"#/components/schemas/Metadata"}},"required":["asset_id","amount","release_destination"]},"Milestone":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"milestone"},"key":{"type":"string"},"title":{"type":"string"},"status":{"type":"string","enum":["DRAFT","PENDING","ACTIVE","SUBMITTED","IN_REVIEW","APPROVED","REJECTED","DISPUTED","RELEASED","REFUNDED","CANCELED"]},"amount":{"$ref":"#/components/schemas/Money"},"due_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"review_window_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"review_ends_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"auto_approve":{"type":"boolean"},"depends_on":{"type":"array","items":{"type":"string"}},"deliverable_schema":{"type":"object","properties":{"required":{"type":"array","items":{"type":"string"}}},"required":["required"]},"percentage":{"type":["string","null"]},"submitter":{"type":"object","properties":{"type":{"type":"string","enum":["merchant","named"]},"name":{"type":["string","null"]}},"required":["type","name"]},"approver":{"type":"object","properties":{"type":{"type":"string","enum":["payer","named"]},"name":{"type":["string","null"]}},"required":["type","name"]},"release_destination_masked":{"type":["string","null"]},"dispute_resolver":{"anyOf":[{"$ref":"#/components/schemas/DisputeResolver"},{"type":"null"}]},"verifier_conditions":{"type":"array","items":{"type":"string"}},"deliverable":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"submission_hash":{"type":["string","null"]},"submission_files":{"type":"array","items":{"type":"object","properties":{"sha256":{"type":"string"},"content_type":{"type":"string"},"size_bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["sha256","content_type","size_bytes"]}},"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"submitted_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"released_txid":{"type":["string","null"]}},"required":["id","object","key","title","status","amount","due_at","review_window_seconds","review_ends_at","auto_approve","depends_on","deliverable_schema","percentage","submitter","approver","release_destination_masked","dispute_resolver","verifier_conditions","deliverable","submission_hash","submission_files","version","submitted_at","released_txid"]},"Escrow":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"escrow"},"livemode":{"type":"boolean"},"status":{"type":"string","enum":["CREATED","FUNDING_PENDING","FUNDED","RELEASING","REFUNDING","DISPUTED","FROZEN","CLOSED","EXPIRED","FAILED","MANUAL_REVIEW"]},"hold_adapter":{"type":"object","properties":{"name":{"type":"string"},"class":{"type":"string"},"responsible_entity":{"type":"string"},"live":{"type":"boolean"}},"required":["name","class","responsible_entity","live"]},"amount":{"$ref":"#/components/schemas/Money"},"funded":{"$ref":"#/components/schemas/Money"},"released":{"$ref":"#/components/schemas/Money"},"refunded":{"$ref":"#/components/schemas/Money"},"held":{"$ref":"#/components/schemas/Money"},"release_destination_masked":{"type":"string"},"refund_destination_masked":{"type":["string","null"]},"funding":{"type":"object","properties":{"payment_intent_id":{"type":["string","null"]},"hosted_url":{"type":["string","null"]},"address":{"type":["string","null"]}},"required":["payment_intent_id","hosted_url","address"]},"conditions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"key":{"type":"string"},"class":{"type":"string"},"status":{"type":"string"},"summary":{"type":"string"},"verifier_name":{"type":["string","null"]},"deadline":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"on_timeout":{"type":"string","enum":["refund","release","review"]}},"required":["id","key","class","status","summary","verifier_name","deadline","on_timeout"]}},"milestones":{"type":"array","items":{"$ref":"#/components/schemas/Milestone"}},"movements":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["fund","release","refund"]},"amount":{"$ref":"#/components/schemas/Money"},"status":{"type":"string"},"txid":{"type":["string","null"]},"milestone_id":{"type":["string","null"]},"reason":{"type":"string"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"confirmed_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]}},"required":["id","kind","amount","status","txid","milestone_id","reason","created_at","confirmed_at"]}},"funded_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"closed_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"dispute_policy":{"anyOf":[{"$ref":"#/components/schemas/DisputePolicy"},{"type":"null"}]},"open_dispute_id":{"type":["string","null"]},"frozen_reason":{"type":["string","null"]},"pending_action":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["release","refund"]},"unsigned_transaction":{"type":["string","null"]}},"required":["kind","unsigned_transaction"]},{"type":"null"}]},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"description":{"type":["string","null"]},"external_reference":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","status","hold_adapter","amount","funded","released","refunded","held","release_destination_masked","refund_destination_masked","funding","conditions","milestones","movements","funded_at","closed_at","dispute_policy","open_dispute_id","frozen_reason","pending_action","expires_at","description","external_reference","created_at"]},"FundEscrowRequest":{"type":"object","properties":{"expires_in_seconds":{"default":86400,"type":"integer","minimum":600,"maximum":604800}}},"MoveEscrowFundsRequest":{"type":"object","properties":{"amount":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"reason":{"type":"string","minLength":3,"maxLength":300},"approval_request_id":{"type":"string","maxLength":64}},"required":["reason"]},"SubmitMilestoneRequest":{"type":"object","properties":{"deliverable":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"files":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"content_type":{"type":"string","maxLength":80},"content_base64":{"type":"string","maxLength":7000000}},"required":["name","content_type","content_base64"]}}},"required":["deliverable"]},"ApproveMilestoneRequest":{"type":"object","properties":{"decision":{"default":"approve","type":"string","enum":["approve","reject"]},"reason":{"type":"string","maxLength":300}}},"MilestoneReview":{"type":"object","properties":{"object":{"type":"string","const":"milestone_review"},"livemode":{"type":"boolean"},"role":{"type":"string","enum":["approver","submitter"]},"escrow_id":{"type":"string"},"escrow_status":{"type":"string","enum":["CREATED","FUNDING_PENDING","FUNDED","RELEASING","REFUNDING","DISPUTED","FROZEN","CLOSED","EXPIRED","FAILED","MANUAL_REVIEW"]},"merchant_name":{"type":"string"},"escrow_amount":{"$ref":"#/components/schemas/Money"},"release_destination_masked":{"type":"string"},"hold_responsible_entity":{"type":"string"},"milestone":{"$ref":"#/components/schemas/Milestone"}},"required":["object","livemode","role","escrow_id","escrow_status","merchant_name","escrow_amount","release_destination_masked","hold_responsible_entity","milestone"]},"AmendMilestonesRequest":{"type":"object","properties":{"milestones":{"minItems":1,"maxItems":20,"type":"array","items":{"$ref":"#/components/schemas/MilestoneInput"}},"payer_consent_token":{"type":"string","maxLength":200},"reason":{"type":"string","minLength":3,"maxLength":300}},"required":["milestones","payer_consent_token","reason"]},"OpenDisputeRequest":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":500},"milestone_id":{"type":"string","maxLength":64},"condition_id":{"type":"string","maxLength":64}},"required":["reason"]},"DisputeEvidenceRequest":{"type":"object","properties":{"statement":{"type":"string","minLength":1,"maxLength":5000},"files":{"default":[],"maxItems":5,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"content_type":{"type":"string","maxLength":80},"content_base64":{"type":"string","maxLength":7000000}},"required":["name","content_type","content_base64"]}}},"required":["statement"]},"DisputeDecisionRequest":{"type":"object","properties":{"outcome":{"type":"string","enum":["release","refund","split"]},"release_amount":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"rationale":{"type":"string","minLength":10,"maxLength":2000}},"required":["outcome","rationale"]},"Dispute":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"dispute"},"livemode":{"type":"boolean"},"status":{"type":"string","enum":["OPEN","EVIDENCE_WINDOW","UNDER_REVIEW","RESOLVED_RELEASE","RESOLVED_REFUND","RESOLVED_SPLIT","APPEAL_WINDOW","CLOSED"]},"escrow_id":{"type":"string"},"milestone_id":{"type":["string","null"]},"condition_id":{"type":["string","null"]},"opened_by":{"type":"string","enum":["payer","merchant","operator"]},"reason":{"type":"string"},"resolver":{"type":"object","properties":{"type":{"type":"string"},"name":{"type":"string"},"contact":{"type":["string","null"]}},"required":["type","name","contact"]},"evidence_deadline":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"appeal_deadline":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"party":{"type":"string"},"statement_hash":{"type":"string"},"file_hashes":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","party","statement_hash","file_hashes","created_at"]}},"decisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"outcome":{"type":"string","enum":["release","refund","split"]},"release":{"$ref":"#/components/schemas/Money"},"refund":{"$ref":"#/components/schemas/Money"},"rationale_hash":{"type":"string"},"decided_by":{"type":"string"},"status":{"type":"string","enum":["pending_second_approval","final","appealed","superseded"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","outcome","release","refund","rationale_hash","decided_by","status","created_at"]}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","status","escrow_id","milestone_id","condition_id","opened_by","reason","resolver","evidence_deadline","appeal_deadline","evidence","decisions","created_at"]},"BuyerAccess":{"type":"object","properties":{"escrow_id":{"type":"string"},"token":{"type":"string"},"approve_url":{"type":"string"}},"required":["escrow_id","token","approve_url"]},"ConditionalTerms":{"type":"object","properties":{"object":{"type":"string","const":"conditional_terms"},"escrow_id":{"type":"string"},"status":{"type":"string","enum":["CREATED","FUNDING_PENDING","FUNDED","RELEASING","REFUNDING","DISPUTED","FROZEN","CLOSED","EXPIRED","FAILED","MANUAL_REVIEW"]},"terms_hash":{"type":"string"},"terms_accepted":{"type":"boolean"},"amount":{"$ref":"#/components/schemas/Money"},"release_destination_masked":{"type":"string"},"hold":{"type":"object","properties":{"adapter":{"type":"string"},"class":{"type":"string"},"responsible_entity":{"type":"string"},"live":{"type":"boolean"}},"required":["adapter","class","responsible_entity","live"]},"conditions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"key":{"type":"string"},"class":{"type":"string","enum":["TIME","BUYER_APPROVAL","MERCHANT_FULFILLMENT","PLATFORM_WEBHOOK","SIGNED_ATTESTATION","COMPUTE_RESULT","ORACLE_EVENT","MILESTONE","NO_DISPUTE_WINDOW","MULTI_APPROVAL"]},"summary":{"type":"string"},"verifier":{"type":"object","properties":{"name":{"type":"string"},"affiliation":{"type":"string"},"self_dealing_disclosure":{"type":["string","null"]}},"required":["name","affiliation","self_dealing_disclosure"]},"deadline":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"on_timeout":{"type":"string","enum":["refund","release","review"]},"on_timeout_explanation":{"type":"string"},"dispute_eligible":{"type":"boolean"},"human_review_required":{"type":"boolean"},"status":{"type":"string","enum":["PENDING","EVIDENCE_SUBMITTED","VERIFYING","SATISFIED","REJECTED","CONFLICTED","UNDER_REVIEW","TIMED_OUT","DISPUTED","REVERSED","FAILED","WAIVED","CANCELED"]}},"required":["id","key","class","summary","verifier","deadline","on_timeout","on_timeout_explanation","dispute_eligible","human_review_required","status"]}},"milestones":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"title":{"type":"string"},"amount":{"$ref":"#/components/schemas/Money"},"percentage":{"type":["string","null"]},"due_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"status":{"type":"string","enum":["DRAFT","PENDING","ACTIVE","SUBMITTED","IN_REVIEW","APPROVED","REJECTED","DISPUTED","RELEASED","REFUNDED","CANCELED"]},"submitter":{"type":"object","properties":{"type":{"type":"string","enum":["merchant","named"]},"name":{"type":["string","null"]}},"required":["type","name"]},"approver":{"type":"object","properties":{"type":{"type":"string","enum":["payer","named"]},"name":{"type":["string","null"]}},"required":["type","name"]},"release_destination_masked":{"type":["string","null"]},"dispute_resolver":{"anyOf":[{"$ref":"#/components/schemas/DisputeResolver"},{"type":"null"}]},"verifier_conditions":{"type":"array","items":{"type":"string"}}},"required":["key","title","amount","percentage","due_at","status","submitter","approver","release_destination_masked","dispute_resolver","verifier_conditions"]}},"dispute_policy":{"anyOf":[{"$ref":"#/components/schemas/DisputePolicy"},{"type":"null"}]},"dispute_enforcement":{"type":["string","null"]},"refund_network_id":{"type":"string"},"refund_destination_masked":{"type":["string","null"]},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["object","escrow_id","status","terms_hash","terms_accepted","amount","release_destination_masked","hold","conditions","milestones","dispute_policy","dispute_enforcement","refund_network_id","refund_destination_masked","expires_at"]},"AcceptConditionsRequest":{"type":"object","properties":{"terms_hash":{"type":"string","maxLength":80},"refund_address":{"type":"string","minLength":1,"maxLength":128},"refund_memo":{"type":"string","minLength":1,"maxLength":64}},"required":["terms_hash","refund_address"]},"BuyerConditionDecision":{"type":"object","properties":{"decision":{"type":"string","enum":["approve","reject"]},"reason":{"type":"string","maxLength":300}},"required":["decision"]},"OperatorConditionDecision":{"type":"object","properties":{"decision":{"type":"string","enum":["satisfied","failed"]},"reason":{"type":"string","minLength":5,"maxLength":500}},"required":["decision","reason"]},"EscrowOperatorAction":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":300}},"required":["reason"]},"FiatPostalAddress":{"type":"object","properties":{"street_line_1":{"type":"string","minLength":1,"maxLength":120},"street_line_2":{"type":"string","maxLength":120},"city":{"type":"string","minLength":1,"maxLength":80},"state":{"type":"string","maxLength":40},"zip":{"type":"string","minLength":1,"maxLength":20},"country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["street_line_1","city","zip"]},"CreateBeneficiaryRequest":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":80},"rail":{"type":"string","enum":["ach","same_day_ach","wire","rtp","sepa","sepa_instant","fps","pix","onchain"]},"holder":{"type":"object","properties":{"type":{"type":"string","enum":["individual","business"]},"name":{"type":"string","minLength":1,"maxLength":140}},"required":["type","name"]},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"us_account":{"type":"object","properties":{"routing_number":{"type":"string","minLength":9,"maxLength":11},"account_number":{"type":"string","minLength":4,"maxLength":20},"account_type":{"default":"checking","type":"string","enum":["checking","savings"]},"bank_name":{"type":"string","maxLength":80},"bank_address":{"$ref":"#/components/schemas/FiatPostalAddress"},"beneficiary_address":{"$ref":"#/components/schemas/FiatPostalAddress"}},"required":["routing_number","account_number"]},"iban_account":{"type":"object","properties":{"iban":{"type":"string","minLength":15,"maxLength":42},"bic":{"type":"string","minLength":8,"maxLength":14}},"required":["iban"]},"uk_account":{"type":"object","properties":{"sort_code":{"type":"string","minLength":6,"maxLength":8},"account_number":{"type":"string","minLength":6,"maxLength":10}},"required":["sort_code","account_number"]},"pix_account":{"type":"object","properties":{"pix_key_type":{"type":"string","enum":["cpf","cnpj","email","phone","evp"]},"pix_key":{"type":"string","minLength":3,"maxLength":77}},"required":["pix_key_type","pix_key"]},"wallet":{"type":"object","properties":{"asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"address":{"type":"string","minLength":1,"maxLength":128},"memo":{"type":"string","minLength":1,"maxLength":64}},"required":["asset_id","address"]}},"required":["label","rail","holder"]},"VerifyBeneficiaryRequest":{"type":"object","properties":{"method":{"default":"provider_validation","type":"string","enum":["provider_validation","micro_deposit"]},"amounts":{"minItems":2,"maxItems":2,"type":"array","items":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"}},"approval_request_id":{"type":"string","maxLength":64}}},"DisableBeneficiaryRequest":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":300}},"required":["reason"]},"Beneficiary":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"beneficiary"},"livemode":{"type":"boolean"},"label":{"type":"string"},"kind":{"type":"string","enum":["bank","onchain"]},"rail":{"type":"string","enum":["ach","same_day_ach","wire","rtp","sepa","sepa_instant","fps","pix","onchain"]},"country":{"type":["string","null"]},"currency":{"type":["string","null"]},"asset_id":{"type":["string","null"]},"network_id":{"type":["string","null"]},"holder":{"type":"object","properties":{"type":{"type":"string","enum":["individual","business"]},"name_masked":{"type":"string"}},"required":["type","name_masked"]},"account_masked":{"type":"string"},"status":{"type":"string","enum":["PENDING_VERIFICATION","VERIFIED","REJECTED","DISABLED"]},"screening_status":{"type":"string","enum":["pending","clear","hit","review"]},"verification":{"anyOf":[{"type":"object","properties":{"method":{"type":"string"},"outcome":{"type":"string"},"at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"reasons":{"type":"array","items":{"type":"string"}}},"required":["method","outcome","at","reasons"]},{"type":"null"}]},"provider":{"type":["string","null"]},"verified_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"cooling_off_until":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"usable":{"type":"boolean"},"disabled_reason":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","label","kind","rail","country","currency","asset_id","network_id","holder","account_masked","status","screening_status","verification","provider","verified_at","cooling_off_until","usable","disabled_reason","created_at","updated_at"]},"FiatLegAmount":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"$ref":"#/components/schemas/FiatMoney"}]},"CreateFiatQuoteRequest":{"type":"object","properties":{"direction":{"type":"string","enum":["offramp","onramp","fiat_to_fiat"]},"beneficiary_id":{"type":"string","pattern":"^ben_[0-9A-Za-z]{16,40}$"},"source_asset_id":{"type":"string","pattern":"^[a-z0-9]{1,12}-[a-z0-9-]{2,32}$","example":"usdc-base"},"source_currency":{"type":"string","pattern":"^[A-Z]{3}$","example":"USD"},"funding_rail":{"type":"string","enum":["ach","same_day_ach","wire","rtp","sepa","sepa_instant","fps","pix"]},"source_amount":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"target_amount":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"provider":{"type":"string","maxLength":40}},"required":["direction","beneficiary_id"]},"FiatSettlementDisclosure":{"type":"object","properties":{"rail":{"type":"string","enum":["ach","same_day_ach","wire","rtp","sepa","sepa_instant","fps","pix"]},"meaning":{"type":"string"},"reversible":{"type":"boolean"},"return_window":{"type":["string","null"]},"return_risk_until":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"disclosure":{"type":"string"},"expected_completion":{"type":"string"}},"required":["rail","meaning","reversible","return_window","return_risk_until","disclosure","expected_completion"]},"FiatFundingInstructions":{"type":"object","properties":{"type":{"type":"string","enum":["onchain_deposit","bank_transfer","provider_pull"]},"asset_id":{"type":["string","null"]},"network_id":{"anyOf":[{"type":"string","pattern":"^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,32}$","description":"CAIP-2 network identifier","example":"eip155:8453"},{"type":"null"}]},"address":{"type":["string","null"]},"rail":{"type":["string","null"]},"bank_name":{"type":["string","null"]},"account_masked":{"type":["string","null"]},"reference":{"type":["string","null"]}},"required":["type","asset_id","network_id","address","rail","bank_name","account_masked","reference"]},"FiatQuote":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"fiat_quote"},"livemode":{"type":"boolean"},"provider":{"type":"string"},"direction":{"type":"string","enum":["offramp","onramp","fiat_to_fiat"]},"rail":{"type":"string","enum":["ach","same_day_ach","wire","rtp","sepa","sepa_instant","fps","pix"]},"beneficiary_id":{"type":["string","null"]},"source":{"$ref":"#/components/schemas/FiatLegAmount"},"target":{"$ref":"#/components/schemas/FiatLegAmount"},"rate":{"type":"string"},"reference_rate":{"anyOf":[{"type":"object","properties":{"rate":{"type":"string"},"source":{"type":"string"},"observed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["rate","source","observed_at"]},{"type":"null"}]},"fees":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"amount":{"$ref":"#/components/schemas/FiatLegAmount"},"embedded_in_rate":{"type":"boolean"},"billed_separately":{"type":"boolean"},"description":{"type":"string"}},"required":["kind","amount","embedded_in_rate","billed_separately","description"]}},"cutoff_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"expected_settlement_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"rolled":{"type":"object","properties":{"rolled":{"type":"boolean"},"reason":{"type":"string"},"skipped_dates":{"type":"array","items":{"type":"string"}}},"required":["rolled","reason","skipped_dates"]},"settlement":{"$ref":"#/components/schemas/FiatSettlementDisclosure"},"funding_instructions":{"anyOf":[{"$ref":"#/components/schemas/FiatFundingInstructions"},{"type":"null"}]},"status":{"type":"string","enum":["open","used","expired"]},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","provider","direction","rail","beneficiary_id","source","target","rate","reference_rate","fees","cutoff_at","expected_settlement_at","rolled","settlement","funding_instructions","status","expires_at","created_at"]},"FiatTransferFunding":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"payment_intent_output"},"payment_intent_id":{"type":"string","pattern":"^pi_[0-9A-Za-z]{16,40}$"},"output_id":{"type":"string","pattern":"^[a-z0-9_]{1,32}$"}},"required":["type","payment_intent_id","output_id"]},{"type":"object","properties":{"type":{"type":"string","const":"onchain_deposit"},"txid":{"type":"string","minLength":8,"maxLength":128}},"required":["type","txid"]}]},"CreateFiatTransferRequest":{"type":"object","properties":{"quote_id":{"type":"string","pattern":"^fq_[0-9A-Za-z]{16,40}$"},"reference":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[\\x20-\\x7E]+$"},"funding":{"$ref":"#/components/schemas/FiatTransferFunding"},"approval_request_id":{"type":"string","maxLength":64}},"required":["quote_id"]},"CancelFiatTransferRequest":{"type":"object","properties":{"reason":{"type":"string","minLength":3,"maxLength":300}}},"FiatTransfer":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"fiat_transfer"},"livemode":{"type":"boolean"},"status":{"type":"string","enum":["BENEFICIARY_REQUIRED","BENEFICIARY_REVIEW","QUOTED","FUNDING_PENDING","FUNDED","SUBMITTED","PROCESSING","SETTLED","RETURN_PENDING","RETURNED","REJECTED","CANCELED","MANUAL_REVIEW"]},"direction":{"type":"string","enum":["offramp","onramp","fiat_to_fiat"]},"rail":{"type":"string","enum":["ach","same_day_ach","wire","rtp","sepa","sepa_instant","fps","pix"]},"provider":{"type":"string"},"provider_reference":{"type":["string","null"]},"quote_id":{"type":["string","null"]},"beneficiary":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"account_masked":{"type":"string"},"holder_name_masked":{"type":"string"}},"required":["id","label","account_masked","holder_name_masked"]},"source":{"$ref":"#/components/schemas/FiatLegAmount"},"target":{"$ref":"#/components/schemas/FiatLegAmount"},"fees":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"amount":{"$ref":"#/components/schemas/FiatLegAmount"},"embedded_in_rate":{"type":"boolean"},"billed_separately":{"type":"boolean"},"description":{"type":"string"}},"required":["kind","amount","embedded_in_rate","billed_separately","description"]}},"reference":{"type":"string"},"payment_intent_id":{"type":["string","null"]},"output_id":{"type":["string","null"]},"funding":{"type":"object","properties":{"type":{"type":"string","enum":["payment_intent_output","onchain_deposit","provider_collection"]},"txid":{"type":["string","null"]},"instructions":{"anyOf":[{"$ref":"#/components/schemas/FiatFundingInstructions"},{"type":"null"}]}},"required":["type","txid","instructions"]},"failure_reason":{"type":["string","null"]},"cancelable":{"type":"boolean"},"settlement":{"$ref":"#/components/schemas/FiatSettlementDisclosure"},"submitted_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"expected_settlement_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"settled_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"return_risk_until":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"returns_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resource_version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"status_history":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","enum":["BENEFICIARY_REQUIRED","BENEFICIARY_REVIEW","QUOTED","FUNDING_PENDING","FUNDED","SUBMITTED","PROCESSING","SETTLED","RETURN_PENDING","RETURNED","REJECTED","CANCELED","MANUAL_REVIEW"]},"reason":{"type":"string"},"at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["status","reason","at"]}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","status","direction","rail","provider","provider_reference","quote_id","beneficiary","source","target","fees","reference","payment_intent_id","output_id","funding","failure_reason","cancelable","settlement","submitted_at","expected_settlement_at","settled_at","return_risk_until","returns_count","resource_version","status_history","created_at","updated_at"]},"FiatReturn":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"fiat_return"},"transfer_id":{"type":"string"},"reason_code":{"type":"string"},"reason_text":{"type":["string","null"]},"amount":{"$ref":"#/components/schemas/FiatLegAmount"},"provider_reference":{"type":["string","null"]},"returned_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","transfer_id","reason_code","reason_text","amount","provider_reference","returned_at","created_at"]},"FiatSandboxActionRequest":{"type":"object","properties":{"action":{"type":"string","enum":["fund","reject","return","delay_settlement","duplicate_callbacks","ambiguous","timeout_on_create","review","deliver_callbacks"]},"code":{"type":"string","pattern":"^[A-Z0-9_]{2,16}$"},"hours":{"type":"integer","minimum":1,"maximum":240}},"required":["action"]},"Ap2Presentation":{"type":"object","properties":{"mandate":{"type":"string","minLength":16,"maxLength":262144,"pattern":"^[A-Za-z0-9_.~-]+$"},"audience":{"type":"string","minLength":1,"maxLength":512},"nonce":{"type":"string","minLength":8,"maxLength":256}},"required":["mandate","audience","nonce"]},"Ap2VerifyRequest":{"type":"object","properties":{"checkout_mandate":{"$ref":"#/components/schemas/Ap2Presentation"},"payment_mandate":{"$ref":"#/components/schemas/Ap2Presentation"}},"required":["checkout_mandate","payment_mandate"]},"Ap2CreateIntentRequest":{"type":"object","properties":{"checkout_mandate":{"$ref":"#/components/schemas/Ap2Presentation"},"payment_mandate":{"$ref":"#/components/schemas/Ap2Presentation"},"agent_authorization_id":{"type":"string","pattern":"^aga_[0-9A-Za-z]{16,40}$"},"description":{"type":"string","maxLength":500}},"required":["checkout_mandate","payment_mandate"]},"Ap2Verification":{"type":"object","properties":{"object":{"type":"string","const":"ap2_verification"},"valid":{"type":"boolean"},"mode":{"anyOf":[{"type":"string","enum":["human_present","delegated"]},{"type":"null"}]},"checkout_hash":{"type":["string","null"]},"checkout_id":{"type":["string","null"]},"amount":{"anyOf":[{"type":"object","properties":{"amount_minor":{"type":"string"},"currency":{"type":"string"}},"required":["amount_minor","currency"]},{"type":"null"}]},"payee":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},{"type":"null"}]},"payment_instrument_type":{"type":["string","null"]},"settleable":{"type":"boolean"},"mandate_hashes":{"anyOf":[{"type":"object","properties":{"checkout":{"type":"string"},"payment":{"type":"string"}},"required":["checkout","payment"]},{"type":"null"}]},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"error":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","enum":["invalid_credential","unresolved_constraint","invalid_mandate","mandates_not_supported"]},"description":{"type":"string"}},"required":["code","description"]},{"type":"null"}]},"receipt":{"type":["string","null"]}},"required":["object","valid","mode","checkout_hash","checkout_id","amount","payee","payment_instrument_type","settleable","mandate_hashes","expires_at","error","receipt"]},"Ap2Mandate":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"ap2_mandate"},"livemode":{"type":"boolean"},"vct":{"type":"string"},"kind":{"type":"string","enum":["checkout","checkout_open","payment","payment_open"]},"status":{"type":"string","enum":["verified","consumed","revoked","expired","rejected"]},"human_present":{"type":"boolean"},"checkout_hash":{"type":["string","null"]},"payee":{"type":["string","null"]},"currency":{"type":["string","null"]},"amount_minor":{"type":["string","null"]},"budget_minor":{"type":["string","null"]},"used_minor":{"type":"string"},"parent_id":{"type":["string","null"]},"payment_intent_id":{"type":["string","null"]},"receipt_id":{"type":["string","null"]},"receipts":{"anyOf":[{"type":"object","properties":{"checkout_receipt":{"type":["string","null"]},"payment_receipt":{"type":["string","null"]}},"required":["checkout_receipt","payment_receipt"]},{"type":"null"}]},"failure_reason":{"type":["string","null"]},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","vct","kind","status","human_present","checkout_hash","payee","currency","amount_minor","budget_minor","used_minor","parent_id","payment_intent_id","receipt_id","receipts","failure_reason","expires_at","revoked_at","created_at"]},"Ap2Intent":{"type":"object","properties":{"object":{"type":"string","const":"ap2_intent"},"mode":{"type":"string","enum":["human_present","delegated"]},"payment_intent":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"hosted_url":{"type":"string"},"amount":{"type":"object","properties":{"currency":{"type":"string"},"amount_minor":{"type":"string"}},"required":["currency","amount_minor"]},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","status","hosted_url","amount","expires_at"]},"mandates":{"type":"array","items":{"$ref":"#/components/schemas/Ap2Mandate"}}},"required":["object","mode","payment_intent","mandates"]},"RevokeAp2MandateRequest":{"type":"object","properties":{"reason":{"type":"string","minLength":1,"maxLength":200}}},"CapabilityOffer":{"type":"object","properties":{"protocol_versions":{"type":"object","propertyNames":{"type":"string","enum":["x402","mpp","ap2","acp","ucp"]},"additionalProperties":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"funding_assets":{"maxItems":200,"type":"array","items":{"type":"string","maxLength":64}},"output_assets":{"maxItems":200,"type":"array","items":{"type":"string","maxLength":64}},"networks":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":64}},"currencies":{"maxItems":50,"type":"array","items":{"type":"string","pattern":"^[A-Z]{3}$"}},"exact_output":{"type":"boolean"},"conditional":{"type":"boolean"},"receipt_formats":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":64}}}},"CreateCapabilityNegotiationRequest":{"type":"object","properties":{"counterparty":{"type":"object","properties":{"type":{"type":"string","enum":["agent","platform","merchant","business"]},"reference":{"type":"string","minLength":1,"maxLength":512}},"required":["type"]},"protocol":{"type":"string","enum":["x402","mpp","ap2","acp","ucp"]},"offered":{"$ref":"#/components/schemas/CapabilityOffer"},"ttl_seconds":{"default":3600,"type":"integer","minimum":60,"maximum":86400}},"required":["counterparty","offered"]},"CapabilityNegotiation":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"capability_negotiation"},"livemode":{"type":"boolean"},"counterparty":{"type":"object","properties":{"type":{"type":"string"},"reference":{"type":["string","null"]}},"required":["type","reference"]},"protocol":{"type":["string","null"]},"status":{"type":"string","enum":["agreed","partial","no_intersection","expired","revoked"]},"offered":{"$ref":"#/components/schemas/CapabilityOffer"},"agreed":{"type":"object","properties":{"protocol_versions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"string"}}},"funding_assets":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"output_assets":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"networks":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"currencies":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"exact_output":{"type":["boolean","null"]},"conditional":{"type":["boolean","null"]},"receipt_formats":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]}},"required":["protocol_versions","funding_assets","output_assets","networks","currencies","exact_output","conditional","receipt_formats"]},"unmatched":{"type":"array","items":{"type":"string"}},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","counterparty","protocol","status","offered","agreed","unmatched","expires_at","revoked_at","created_at"]},"SettlementCapabilities":{"type":"object","properties":{"object":{"type":"string","const":"settlement_capabilities"},"issuer":{"type":"string"},"api_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"environments":{"type":"object","propertyNames":{"type":"string","enum":["test","live"]},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"required":["test","live"]}},"required":["object","issuer","api_version","generated_at","expires_at","environments"]},"MerchantSettlementCapabilities":{"type":"object","properties":{"object":{"type":"string","const":"merchant_settlement_capabilities"},"merchant_id":{"type":"string"},"livemode":{"type":"boolean"},"generated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"capabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["object","merchant_id","livemode","generated_at","expires_at","capabilities"]},"CommerceCatalogRequest":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$","example":"USD"},"items":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,64}$"},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":1000},"unit_price":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"tax_bps":{"default":0,"type":"integer","minimum":0,"maximum":10000},"requires_shipping":{"default":false,"type":"boolean"},"available":{"default":true,"type":"boolean"}},"required":["id","name","unit_price"]}},"shipping_options":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,64}$"},"title":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":300},"carrier":{"type":"string","maxLength":80},"price":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"earliest_days":{"type":"integer","minimum":0,"maximum":365},"latest_days":{"type":"integer","minimum":0,"maximum":365}},"required":["id","title","price","earliest_days","latest_days"]}},"policies":{"default":{},"type":"object","properties":{"terms":{"type":"string","maxLength":500,"format":"uri"},"privacy":{"type":"string","maxLength":500,"format":"uri"},"returns":{"type":"string","maxLength":500,"format":"uri"},"shipping":{"type":"string","maxLength":500,"format":"uri"}}}},"required":["currency","items"]},"CreateCustomRoleRequest":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":60},"description":{"type":"string","maxLength":300},"permissions":{"minItems":1,"maxItems":80,"type":"array","items":{"type":"string","pattern":"^[a-z0-9_:.-]{1,64}$"}}},"required":["name","permissions"]},"CustomRole":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"custom_role"},"name":{"type":"string"},"description":{"type":["string","null"]},"permissions":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","name","description","permissions","created_at"]},"AssignRoleRequest":{"type":"object","properties":{"role":{"type":"string","minLength":2,"maxLength":64}},"required":["role"]},"CreateTeamRequest":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":60},"member_user_ids":{"default":[],"maxItems":200,"type":"array","items":{"type":"string","maxLength":64}}},"required":["name"]},"Team":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"team"},"name":{"type":"string"},"members":{"type":"array","items":{"type":"object","properties":{"user_id":{"type":"string"},"name":{"type":"string"}},"required":["user_id","name"]}},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","name","members","created_at"]},"ApprovalCriteria":{"type":"object","properties":{"min_amount_usd":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"},"assets":{"maxItems":50,"type":"array","items":{"type":"string","maxLength":64}},"rails":{"maxItems":20,"type":"array","items":{"type":"string","maxLength":32}},"protocols":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":16}},"jurisdictions":{"maxItems":250,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"new_destinations_only":{"default":false,"type":"boolean"},"destinations_outside_allowlist":{"default":false,"type":"boolean"}}},"CreateApprovalPolicyRequest":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":80},"action":{"type":"string","enum":["payout","payout_batch","fiat_transfer","refund","escrow_release","escrow_refund","beneficiary","policy_activation","api_key"]},"applies_to":{"default":"workspace","type":"string","enum":["workspace","organization"]},"criteria":{"default":{"new_destinations_only":false,"destinations_outside_allowlist":false},"$ref":"#/components/schemas/ApprovalCriteria"},"required_approvals":{"type":"integer","minimum":1,"maximum":5},"approver_roles":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":2,"maxLength":64}}},"required":["name","action","required_approvals","approver_roles"]},"ApprovalPolicy":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"approval_policy"},"livemode":{"type":"boolean"},"name":{"type":"string"},"action":{"type":"string","enum":["payout","payout_batch","fiat_transfer","refund","escrow_release","escrow_refund","beneficiary","policy_activation","api_key"]},"applies_to":{"type":"string","enum":["workspace","organization"]},"criteria":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"required_approvals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"approver_roles":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","disabled"]},"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","name","action","applies_to","criteria","required_approvals","approver_roles","status","version","created_at"]},"ApprovalRequest":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"approval_request"},"livemode":{"type":"boolean"},"policy_id":{"type":"string"},"action":{"type":"string","enum":["payout","payout_batch","fiat_transfer","refund","escrow_release","escrow_refund","beneficiary","policy_activation","api_key"]},"resource_type":{"type":"string"},"resource_id":{"type":"string"},"operation_hash":{"type":"string"},"summary":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"requested_by":{"type":"string"},"required_approvals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"decisions":{"type":"array","items":{"type":"object","properties":{"approver":{"type":"string"},"decision":{"type":"string","enum":["approve","reject"]},"reason":{"type":["string","null"]},"at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["approver","decision","reason","at"]}},"status":{"type":"string","enum":["PENDING","APPROVED","REJECTED","EXPIRED","CANCELED"]},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"executed_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","livemode","policy_id","action","resource_type","resource_id","operation_hash","summary","requested_by","required_approvals","decisions","status","expires_at","executed_at","created_at"]},"DecideApprovalRequest":{"type":"object","properties":{"decision":{"type":"string","enum":["approve","reject"]},"reason":{"type":"string","maxLength":300}},"required":["decision"]},"VelocityLimitRequest":{"type":"object","properties":{"scope":{"default":"merchant","type":"string","enum":["merchant","agent_authorization","destination"]},"scope_ref":{"type":"string","maxLength":64},"action":{"type":"string","enum":["refund","payout","fiat_transfer","escrow_release","agent_payment","payment_intent"]},"window_seconds":{"type":"integer","minimum":60,"maximum":2678400},"max_count":{"type":"integer","minimum":1,"maximum":1000000},"max_amount_usd":{"type":"string","maxLength":100,"pattern":"^(0|[1-9]\\d*)(\\.\\d{1,36})?$","description":"Decimal string (human units). Never a JSON number.","example":"1000.00"}},"required":["action","window_seconds"]},"VelocityLimit":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"velocity_limit"},"livemode":{"type":"boolean"},"scope":{"type":"string"},"scope_ref":{"type":["string","null"]},"action":{"type":"string"},"window_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"max_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"max_amount_usd_minor":{"type":["string","null"]},"status":{"type":"string","enum":["active","disabled"]}},"required":["id","object","livemode","scope","scope_ref","action","window_seconds","max_count","max_amount_usd_minor","status"]},"ProviderPreferencesRequest":{"type":"object","properties":{"allow_providers":{"anyOf":[{"maxItems":30,"type":"array","items":{"type":"string","pattern":"^[a-z0-9_:.-]{1,64}$"}},{"type":"null"}]},"deny_providers":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","pattern":"^[a-z0-9_:.-]{1,64}$"}}}},"ProviderPreferences":{"type":"object","properties":{"object":{"type":"string","const":"provider_preferences"},"livemode":{"type":"boolean"},"allow_providers":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"deny_providers":{"type":"array","items":{"type":"string"}},"eligible_providers":{"type":"array","items":{"type":"string"}}},"required":["object","livemode","allow_providers","deny_providers","eligible_providers"]},"DestinationControlsRequest":{"type":"object","properties":{"allowlist_only":{"type":"boolean"},"destination_cooling_off_seconds":{"type":"integer","minimum":0,"maximum":2592000},"beneficiary_cooling_off_seconds":{"type":"integer","minimum":3600,"maximum":2592000}},"required":["allowlist_only","destination_cooling_off_seconds","beneficiary_cooling_off_seconds"]},"DestinationControls":{"type":"object","properties":{"object":{"type":"string","const":"destination_controls"},"livemode":{"type":"boolean"},"allowlist_only":{"type":"boolean"},"destination_cooling_off_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"beneficiary_cooling_off_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pending":{"anyOf":[{"type":"object","properties":{"allowlist_only":{"type":"boolean"},"destination_cooling_off_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"beneficiary_cooling_off_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"effective_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["allowlist_only","destination_cooling_off_seconds","beneficiary_cooling_off_seconds","effective_at"]},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]}},"required":["object","livemode","allowlist_only","destination_cooling_off_seconds","beneficiary_cooling_off_seconds","pending","updated_at"]},"ProviderCredentialRequest":{"type":"object","properties":{"provider":{"type":"string","pattern":"^[a-z0-9_:.-]{1,64}$"},"credentials":{"type":"object","propertyNames":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,39}$"},"additionalProperties":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[\\x21-\\x7e]+$"}},"contract_reference":{"type":"string","minLength":3,"maxLength":200}},"required":["provider","credentials","contract_reference"]},"ProviderCredential":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"provider_credential"},"provider":{"type":"string"},"livemode":{"type":"boolean"},"status":{"type":"string","enum":["active","revoked"]},"hint":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"contract_reference":{"type":"string"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]}},"required":["id","object","provider","livemode","status","hint","fields","contract_reference","created_at","revoked_at"]},"ProviderCredentialList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"enabled":{"type":"boolean"},"supported":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}}},"required":["provider","fields"]}},"data":{"type":"array","items":{"$ref":"#/components/schemas/ProviderCredential"}}},"required":["object","enabled","supported","data"]},"ProviderCertificationRequest":{"type":"object","properties":{"status":{"type":"string","enum":["pending","certified","suspended","revoked"]},"checklist":{"type":"object","properties":{"legal_commercial_approval":{"type":"boolean"},"authentication_and_secrets":{"type":"boolean"},"sandbox_conformance":{"type":"boolean"},"idempotency_and_status_recovery":{"type":"boolean"},"quote_accuracy":{"type":"boolean"},"settlement_reconciliation":{"type":"boolean"},"refund_return_behavior":{"type":"boolean"},"incident_communication":{"type":"boolean"},"jurisdiction_and_compliance":{"type":"boolean"},"load_latency_failure_testing":{"type":"boolean"}},"required":["legal_commercial_approval","authentication_and_secrets","sandbox_conformance","idempotency_and_status_recovery","quote_accuracy","settlement_reconciliation","refund_return_behavior","incident_communication","jurisdiction_and_compliance","load_latency_failure_testing"]},"jurisdictions":{"default":[],"maxItems":250,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"notes":{"type":"string","maxLength":1000}},"required":["status","checklist"]},"ProviderCertification":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"provider_certification"},"provider":{"type":"string"},"livemode":{"type":"boolean"},"status":{"type":"string","enum":["pending","certified","suspended","revoked"]},"checklist":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"boolean"}},"jurisdictions":{"type":"array","items":{"type":"string"}},"certified_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"expires_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"notes":{"type":["string","null"]}},"required":["id","object","provider","livemode","status","checklist","jurisdictions","certified_at","expires_at","notes"]},"ProviderSla":{"type":"object","properties":{"provider":{"type":"string"},"certification":{"type":"string","enum":["pending","certified","suspended","revoked","uncertified"]},"window_start":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"window_end":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},"metrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string","enum":["availability","quote_p95_ms","completion_p95_seconds","success_rate"]},"target":{"type":"string"},"measured":{"type":["string","null"]},"sample_size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sufficient_sample":{"type":"boolean"}},"required":["metric","target","measured","sample_size","sufficient_sample"]}}},"required":["provider","certification","window_start","window_end","metrics"]},"DataResidencyRequest":{"type":"object","properties":{"region":{"type":"string","enum":["us","eu","uk","sg"]},"retention_days":{"type":"object","properties":{"audit":{"type":"integer","minimum":1825,"maximum":7300},"receipts":{"type":"integer","minimum":1825,"maximum":7300},"evidence":{"type":"integer","minimum":180,"maximum":7300},"pii":{"type":"integer","minimum":30,"maximum":3650},"analytics":{"type":"integer","minimum":7,"maximum":1825}},"required":["audit","receipts","evidence","pii","analytics"]},"legal_hold":{"default":false,"type":"boolean"}},"required":["region","retention_days"]},"DataResidencyPolicy":{"type":"object","properties":{"region":{"type":"string","enum":["us","eu","uk","sg"]},"retention_days":{"type":"object","properties":{"audit":{"type":"integer","minimum":1825,"maximum":7300},"receipts":{"type":"integer","minimum":1825,"maximum":7300},"evidence":{"type":"integer","minimum":180,"maximum":7300},"pii":{"type":"integer","minimum":30,"maximum":3650},"analytics":{"type":"integer","minimum":7,"maximum":1825}},"required":["audit","receipts","evidence","pii","analytics"]},"legal_hold":{"default":false,"type":"boolean"},"object":{"type":"string","const":"data_residency_policy"},"serving_region":{"type":"string","enum":["us","eu","uk","sg"]},"updated_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]}},"required":["region","retention_days","object","serving_region","updated_at"]},"IncidentSubscriptionRequest":{"type":"object","properties":{"channel":{"type":"string","enum":["email","webhook"]},"target":{"type":"string","minLength":3,"maxLength":500},"severities":{"default":["major","critical"],"minItems":1,"type":"array","items":{"type":"string","enum":["minor","major","critical"]}},"components":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","pattern":"^[a-z0-9_:.-]{1,64}$"}}},"required":["channel","target"]},"IncidentSubscription":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"incident_subscription"},"channel":{"type":"string","enum":["email","webhook"]},"target_masked":{"type":"string"},"severities":{"type":"array","items":{"type":"string"}},"components":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["active","disabled"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","channel","target_masked","severities","components","status","created_at"]},"AuditExportSinkRequest":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"}},"required":["url"]},"AuditExportSink":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"audit_export_sink"},"kind":{"type":"string","const":"https_json"},"url_masked":{"type":"string"},"signing_secret":{"type":["string","null"]},"status":{"type":"string","enum":["active","paused","failing"]},"last_exported_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"last_error":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","kind","url_masked","signing_secret","status","last_exported_at","last_error","created_at"]},"ScimToken":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"scim_token"},"label":{"type":"string"},"token":{"type":["string","null"]},"last_used_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"revoked_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","label","token","last_used_at","revoked_at","created_at"]},"SsoConnectionRequest":{"type":"object","properties":{"protocol":{"type":"string","enum":["saml","oidc"]},"domains":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-z0-9.-]+\\.[a-z]{2,}$"}},"idp_entity_id":{"type":"string","minLength":3,"maxLength":500},"sso_url":{"type":"string","maxLength":500,"format":"uri"},"certificate_pem":{"type":"string","maxLength":10000},"default_role":{"default":"viewer","type":"string","minLength":2,"maxLength":64}},"required":["protocol","domains","idp_entity_id","sso_url"]},"SsoConnection":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","const":"sso_connection"},"protocol":{"type":"string","enum":["saml","oidc"]},"domains":{"type":"array","items":{"type":"string"}},"idp_entity_id":{"type":"string"},"sso_url":{"type":"string"},"default_role":{"type":"string"},"enforce":{"type":"boolean"},"status":{"type":"string","enum":["draft","active","disabled"]},"activation_blocker":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"RFC 3339 UTC timestamp","example":"2026-09-24T20:10:03Z"}},"required":["id","object","protocol","domains","idp_entity_id","sso_url","default_role","enforce","status","activation_blocker","created_at"]},"ResolvePlanRequest":{"type":"object","properties":{"action":{"type":"string","enum":["retry_step","recompile","mark_failed"]},"step_id":{"type":"string","pattern":"^[a-z0-9_]{1,64}$"},"reason":{"type":"string","minLength":3,"maxLength":500}},"required":["action","reason"]},"OperatorLoginRequest":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"password":{"type":"string","minLength":1,"maxLength":256},"code":{"type":"string","maxLength":32}},"required":["email","password"]},"OperatorTwoFactorCode":{"type":"object","properties":{"code":{"type":"string","minLength":6,"maxLength":32}},"required":["code"]},"ConsoleLoginRequest":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"password":{"type":"string","minLength":1,"maxLength":256}},"required":["email","password"]},"ConsoleSwitchRequest":{"type":"object","properties":{"merchant_id":{"type":"string","maxLength":64},"environment":{"type":"string","enum":["test","live"]}}},"AcceptInvitationRequest":{"type":"object","properties":{"token":{"type":"string","pattern":"^inv_[0-9A-Za-z]{30,64}$"},"name":{"type":"string","minLength":1,"maxLength":120},"password":{"type":"string","minLength":12,"maxLength":256}},"required":["token","name","password"]},"PasswordResetRequest":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["email"]},"SignupRequest":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"name":{"type":"string","minLength":1,"maxLength":120},"business_name":{"type":"string","minLength":2,"maxLength":80},"country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["email","name","business_name","country"]},"SignupCompleteRequest":{"type":"object","properties":{"token":{"type":"string","pattern":"^sgn_[0-9A-Za-z]{40}$"},"password":{"type":"string","minLength":12,"maxLength":256}},"required":["token","password"]},"PasswordResetCompleteRequest":{"type":"object","properties":{"token":{"type":"string","pattern":"^pwr_[0-9A-Za-z]{40}$"},"password":{"type":"string","minLength":12,"maxLength":256}},"required":["token","password"]},"ApiKeyList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ApiKey"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"CreateInvitationRequest":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"role":{"type":"string","enum":["admin","developer","finance","approver","support","viewer"]}},"required":["email","role"]},"ProtocolCapabilities":{"type":"object","properties":{"object":{"type":"string","const":"protocol_capabilities"},"protocol":{"type":"string","enum":["x402","mpp"]},"versions":{"type":"array","items":{"type":"string"}},"schemes":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"string"}},"assets":{"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"network":{"type":"string"},"asset":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["assetId","network","asset","symbol","decimals"]}},"settlement":{"type":"object","properties":{"mode":{"type":"string"},"facilitator":{"type":["string","null"]}},"required":["mode","facilitator"]},"live":{"type":"boolean"},"enabled":{"type":"boolean"},"notes":{"type":"array","items":{"type":"string"}},"snapshot_hash":{"type":"string"}},"required":["object","protocol","versions","schemes","networks","assets","settlement","live","enabled","notes","snapshot_hash"]},"RevokeAgentAuthorizationRequest":{"type":"object","properties":{"reason":{"default":"merchant_request","type":"string","minLength":1,"maxLength":200}}},"CreateCheckpointRequest":{"type":"object","properties":{"agent_authorization_id":{"type":"string","maxLength":64}},"required":["agent_authorization_id"]},"CheckpointResult":{"type":"object","properties":{"object":{"type":"string","const":"checkpoint"},"billing_record":{"anyOf":[{"$ref":"#/components/schemas/BillingRecord"},{"type":"null"}]},"settlement":{"anyOf":[{"$ref":"#/components/schemas/ProtocolTransaction"},{"type":"null"}]}},"required":["object","billing_record","settlement"]},"ProtocolCapabilitiesList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ProtocolCapabilities"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"ProtocolTransactionList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ProtocolTransaction"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"AgentPrincipalList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/AgentPrincipal"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"AgentAuthorizationList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/AgentAuthorization"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"MeterList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Meter"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"BillingRecordList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/BillingRecord"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"VerifierConfigurationList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/VerifierConfiguration"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"ConditionList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"EscrowList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Escrow"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"DisputeList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Dispute"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"PolicyDestinationList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/PolicyDestination"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"ValidatePolicyRequest":{"type":"object","properties":{"document":{},"for_activation":{"default":false,"type":"boolean"}},"required":["document"]},"SettlementPolicyList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/SettlementPolicy"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"ActivatePolicyRequest":{"type":"object","properties":{"version":{"type":"integer","minimum":1,"maximum":9007199254740991},"approval_request_id":{"type":"string","maxLength":64}}},"PaymentLinkList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/PaymentLink"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"RefundList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Refund"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"WebhookEndpointList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEndpoint"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"WebhookEventList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookEventSummary"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"PayoutBatchList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/PayoutBatch"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"ApprovePayoutBatchRequest":{"type":"object","properties":{"approval_request_id":{"type":"string","pattern":"^apr_[0-9A-Za-z]{16,40}$"}}},"RecurringScheduleList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/RecurringSchedule"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"PaymentIntentList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/PaymentIntent"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"ProtocolTransactionStatus":{"type":"object","properties":{"object":{"type":"string","const":"protocol_transaction_status"},"id":{"type":"string"},"protocol":{"type":"string"},"protocol_version":{"type":"string"},"status":{"type":"string"},"livemode":{"type":"boolean"},"amount":{"type":"object","properties":{"asset_id":{"type":"string"},"network_id":{"type":"string"},"amount_atomic":{"type":"string"},"decimals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["asset_id","network_id","amount_atomic","decimals"]},"settlement_transaction":{"type":["string","null"]},"receipt_id":{"type":["string","null"]},"receipt_url":{"type":["string","null"]}},"required":["object","id","protocol","protocol_version","status","livemode","amount","settlement_transaction","receipt_id","receipt_url"]},"BeneficiaryList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Beneficiary"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"FiatTransferList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/FiatTransfer"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"FiatReturnList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/FiatReturn"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"ApprovalPolicyList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalPolicy"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"ApprovalRequestList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalRequest"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"VelocityLimitList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/VelocityLimit"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"IncidentSubscriptionList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/IncidentSubscription"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"AuditExportSinkList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/AuditExportSink"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"CustomRoleList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/CustomRole"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"TeamList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Team"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"ScimTokenList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ScimToken"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"SsoConnectionList":{"type":"object","properties":{"object":{"type":"string","const":"list"},"data":{"type":"array","items":{"$ref":"#/components/schemas/SsoConnection"}},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"request_id":{"type":"string"}},"required":["object","data","has_more","next_cursor","request_id"]},"VerifyReceiptBody":{"type":"object","properties":{"receipt":{"type":"object","properties":{"id":{"type":"string","maxLength":64},"payload":{"$ref":"#/components/schemas/ReceiptPayload"},"payload_hash":{"type":"string","maxLength":80},"signatures":{"minItems":1,"maxItems":4,"type":"array","items":{"$ref":"#/components/schemas/ReceiptSignature"}}},"required":["id","payload","payload_hash","signatures"],"additionalProperties":{}}},"required":["receipt"]},"__shared":{"$defs":{"schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/__shared#/$defs/schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/__shared#/$defs/schema0"}}]}}}},"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"Secret API key (sk_test_… / sk_live_…)"},"consoleSession":{"type":"apiKey","in":"header","name":"Authorization","description":"Session <token> (merchant console BFF only)"},"operatorSession":{"type":"apiKey","in":"header","name":"Authorization","description":"Session <token> (admin console BFF only)"}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":255},"description":"Unique key per logical mutation; retries with the same key replay the stored response."},"RequestSignature":{"name":"Route-Request-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"t=<unix>,v1=<hex HMAC-SHA256(signing secret, `${t}.${METHOD}.${path}.${sha256(body)}`)>"}}}}