Required request body.
application/json
{
"$ref": "#/components/schemas/Ap2ResolutionRequestV1",
"type": "object",
"additionalProperties": false,
"required": [
"schemaVersion",
"externalCaseId",
"policyVersion",
"evidencePackage",
"resolutionAuthorization",
"proposedCase"
],
"properties": {
"schemaVersion": {
"type": "string",
"const": "ap2-resolution-request-v1"
},
"externalCaseId": {
"type": "string"
},
"policyVersion": {
"type": "string"
},
"evidencePackage": {
"$ref": "#/components/schemas/Ap2EvidencePackageV1",
"type": "object",
"additionalProperties": false,
"required": [
"schemaVersion",
"ap2SpecVersion",
"evidenceId",
"transactionId",
"acquiredAt",
"source",
"artifacts",
"trust"
],
"properties": {
"schemaVersion": {
"type": "string",
"const": "ap2-evidence-package-v1"
},
"ap2SpecVersion": {
"type": "string",
"const": "0.2"
},
"evidenceId": {
"type": "string"
},
"transactionId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{43}$"
},
"acquiredAt": {
"type": "string",
"format": "date-time"
},
"source": {
"type": "object",
"additionalProperties": false,
"required": [
"partnerId",
"exporterId",
"sourceRoles"
],
"properties": {
"partnerId": {
"type": "string"
},
"exporterId": {
"type": "string"
},
"sourceRoles": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"trusted_surface",
"credential_provider",
"shopping_agent",
"merchant",
"merchant_payment_processor"
]
}
}
}
},
"artifacts": {
"type": "object",
"additionalProperties": false,
"required": [
"checkoutMandates",
"checkoutJwt",
"checkoutReceipt",
"paymentMandates",
"paymentReceipt"
],
"properties": {
"checkoutMandates": {
"type": "object",
"additionalProperties": false,
"required": [
"open",
"closed"
],
"properties": {
"open": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/components/schemas/Ap2SdJwtArtifactV1",
"type": "object",
"additionalProperties": false,
"required": [
"artifactId",
"compactSdJwt",
"disclosures",
"keyBindingJwt"
],
"properties": {
"artifactId": {
"type": "string"
},
"compactSdJwt": {
"type": "string"
},
"disclosures": {
"type": "array",
"items": {
"type": "string"
}
},
"keyBindingJwt": {
"type": [
"string",
"null"
]
}
}
}
},
"closed": {
"$ref": "#/components/schemas/Ap2SdJwtArtifactV1",
"type": "object",
"additionalProperties": false,
"required": [
"artifactId",
"compactSdJwt",
"disclosures",
"keyBindingJwt"
],
"properties": {
"artifactId": {
"type": "string"
},
"compactSdJwt": {
"type": "string"
},
"disclosures": {
"type": "array",
"items": {
"type": "string"
}
},
"keyBindingJwt": {
"type": [
"string",
"null"
]
}
}
}
}
},
"checkoutJwt": {
"type": "object",
"additionalProperties": false,
"required": [
"artifactId",
"compactJwt"
],
"properties": {
"artifactId": {
"type": "string"
},
"compactJwt": {
"type": "string"
}
}
},
"checkoutReceipt": {
"type": "object",
"additionalProperties": false,
"required": [
"artifactId",
"compactJws"
],
"properties": {
"artifactId": {
"type": "string"
},
"compactJws": {
"type": "string"
}
}
},
"paymentMandates": {
"type": "object",
"additionalProperties": false,
"required": [
"open",
"closed"
],
"properties": {
"open": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/components/schemas/Ap2SdJwtArtifactV1",
"type": "object",
"additionalProperties": false,
"required": [
"artifactId",
"compactSdJwt",
"disclosures",
"keyBindingJwt"
],
"properties": {
"artifactId": {
"type": "string"
},
"compactSdJwt": {
"type": "string"
},
"disclosures": {
"type": "array",
"items": {
"type": "string"
}
},
"keyBindingJwt": {
"type": [
"string",
"null"
]
}
}
}
},
"closed": {
"$ref": "#/components/schemas/Ap2SdJwtArtifactV1",
"type": "object",
"additionalProperties": false,
"required": [
"artifactId",
"compactSdJwt",
"disclosures",
"keyBindingJwt"
],
"properties": {
"artifactId": {
"type": "string"
},
"compactSdJwt": {
"type": "string"
},
"disclosures": {
"type": "array",
"items": {
"type": "string"
}
},
"keyBindingJwt": {
"type": [
"string",
"null"
]
}
}
}
}
},
"paymentReceipt": {
"type": "object",
"additionalProperties": false,
"required": [
"artifactId",
"compactJws"
],
"properties": {
"artifactId": {
"type": "string"
},
"compactJws": {
"type": "string"
}
}
}
}
},
"trust": {
"type": "object",
"additionalProperties": false,
"required": [
"policyId",
"policyVersion",
"exporterAttestationJws",
"keys"
],
"properties": {
"policyId": {
"type": "string"
},
"policyVersion": {
"type": "string"
},
"exporterAttestationJws": {
"type": "string"
},
"keys": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/components/schemas/Ap2TrustKeyV1",
"type": "object",
"additionalProperties": false,
"required": [
"issuer",
"ap2Role",
"kid",
"alg",
"purpose",
"publicJwk",
"thumbprintSha256",
"notBefore",
"expiresAt"
],
"properties": {
"issuer": {
"type": "string"
},
"ap2Role": {
"type": "string",
"enum": [
"trusted_surface",
"credential_provider",
"shopping_agent",
"merchant",
"merchant_payment_processor",
"principal"
]
},
"kid": {
"type": "string"
},
"alg": {
"type": "string",
"enum": [
"EdDSA",
"ES256"
]
},
"purpose": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"checkout_mandate",
"payment_mandate",
"key_binding",
"checkout_jwt",
"checkout_receipt",
"payment_receipt",
"resolution_authorization"
]
}
},
"publicJwk": {
"type": "object",
"description": "Public asymmetric JWK only; private d and symmetric k members are rejected."
},
"thumbprintSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"notBefore": {
"type": "string",
"format": "date-time"
},
"expiresAt": {
"type": "string",
"format": "date-time"
}
},
"allOf": [
{
"if": {
"properties": {
"purpose": {
"contains": {
"type": "string",
"const": "resolution_authorization"
}
}
},
"required": [
"purpose"
]
},
"then": {
"properties": {
"ap2Role": {
"type": "string",
"const": "principal"
},
"purpose": {
"type": "array",
"minItems": 1,
"maxItems": 1,
"items": {
"type": "string",
"const": "resolution_authorization"
}
}
}
}
}
]
}
}
}
}
}
},
"resolutionAuthorization": {
"$ref": "#/components/schemas/ResolutionAuthorizationV1",
"type": "object",
"additionalProperties": false,
"required": [
"schemaVersion",
"authorizationId",
"transactionId",
"effectiveAt",
"expiresAt",
"principals",
"coveredTransaction",
"coveredClaims",
"appointment",
"rules",
"terms",
"availableRemedies",
"executionProvider",
"proof"
],
"properties": {
"schemaVersion": {
"type": "string",
"const": "resolution-authorization-v1"
},
"authorizationId": {
"type": "string"
},
"transactionId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{43}$"
},
"effectiveAt": {
"type": "string",
"format": "date-time"
},
"expiresAt": {
"type": "string",
"format": "date-time"
},
"principals": {
"type": "array",
"minItems": 2,
"maxItems": 2,
"allOf": [
{
"contains": {
"type": "object",
"properties": {
"side": {
"type": "string",
"const": "claimant"
}
},
"required": [
"side"
]
},
"minContains": 1,
"maxContains": 1
},
{
"contains": {
"type": "object",
"properties": {
"side": {
"type": "string",
"const": "respondent"
}
},
"required": [
"side"
]
},
"minContains": 1,
"maxContains": 1
}
],
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"side",
"principalId",
"displayName",
"capacity",
"notice",
"agentAuthority"
],
"properties": {
"side": {
"type": "string",
"enum": [
"claimant",
"respondent"
]
},
"principalId": {
"type": "string"
},
"displayName": {
"type": "string"
},
"capacity": {
"type": "string",
"enum": [
"individual",
"legal_entity",
"autonomous_agent"
]
},
"notice": {
"type": "object",
"additionalProperties": false,
"required": [
"method",
"address"
],
"properties": {
"method": {
"type": "string",
"enum": [
"email",
"partner_callback",
"case_page"
]
},
"address": {
"type": "string"
}
}
},
"agentAuthority": {
"type": "object",
"additionalProperties": false,
"required": [
"agentId",
"representedPrincipalId",
"allowedActs",
"maximumAmount",
"expiresAt",
"delegationArtifactRef",
"delegationArtifactHash"
],
"properties": {
"agentId": {
"type": "string"
},
"representedPrincipalId": {
"type": "string"
},
"allowedActs": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"file_dispute",
"submit_evidence",
"settle_dispute",
"confirm_record",
"manage_representatives",
"report_processing_defect",
"file_procedural_request"
]
}
},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1",
"type": "object",
"additionalProperties": false,
"required": [
"currency",
"minorUnits"
],
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"minorUnits": {
"type": "string",
"pattern": "^[1-9][0-9]{0,14}$",
"description": "Positive USD minor units, capped at exactly 15 decimal digits by Bridge v1."
}
}
},
"expiresAt": {
"type": "string",
"format": "date-time"
},
"delegationArtifactRef": {
"type": "string"
},
"delegationArtifactHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
}
}
}
},
"coveredTransaction": {
"type": "object",
"additionalProperties": false,
"required": [
"transactionId",
"merchantOrCounterpartyId",
"evidenceManifestHash"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{43}$"
},
"merchantOrCounterpartyId": {
"type": "string"
},
"evidenceManifestHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"coveredClaims": {
"$ref": "#/components/schemas/ResolutionCoveredClaimsV1",
"type": "object",
"additionalProperties": false,
"required": [
"scope",
"claimTypes",
"maximumAmount"
],
"properties": {
"scope": {
"type": "string"
},
"claimTypes": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"type": "string"
}
},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1",
"type": "object",
"additionalProperties": false,
"required": [
"currency",
"minorUnits"
],
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"minorUnits": {
"type": "string",
"pattern": "^[1-9][0-9]{0,14}$",
"description": "Positive USD minor units, capped at exactly 15 decimal digits by Bridge v1."
}
}
}
}
},
"appointment": {
"$ref": "#/components/schemas/ResolutionAppointmentV1",
"type": "object",
"additionalProperties": false,
"required": [
"administrator",
"tribunal",
"caseMode",
"procedureProfile"
],
"properties": {
"administrator": {
"type": "string",
"const": "People's Court"
},
"tribunal": {
"type": "string",
"const": "People's Court Tribunal"
},
"caseMode": {
"type": "string",
"const": "evaluation"
},
"procedureProfile": {
"type": "string",
"const": "evaluation"
}
}
},
"rules": {
"$ref": "#/components/schemas/ResolutionRulesV1",
"type": "object",
"additionalProperties": false,
"required": [
"rulesetId",
"version",
"hash",
"url"
],
"properties": {
"rulesetId": {
"type": "string"
},
"version": {
"type": "string"
},
"hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
}
}
},
"terms": {
"$ref": "#/components/schemas/ResolutionTermsV1",
"type": "object",
"additionalProperties": false,
"required": [
"version",
"hash"
],
"properties": {
"version": {
"type": "string"
},
"hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"legalContext": {
"$ref": "#/components/schemas/ResolutionLegalContextBindingV1",
"type": "object",
"additionalProperties": false,
"required": [
"lcpSpecVersion",
"legalContextSha256",
"termsAtrHash",
"clauseId",
"clauseSha256",
"rulesSha256",
"catalogSha256",
"providerId",
"serviceId"
],
"properties": {
"lcpSpecVersion": {
"type": "string",
"const": "0.1.38"
},
"legalContextSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"termsAtrHash": {
"type": "string",
"pattern": "^0x[a-f0-9]{64}$"
},
"clauseId": {
"type": "string",
"pattern": "^sha256:0x[a-f0-9]{64}$"
},
"clauseSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"rulesSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"catalogSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"providerId": {
"type": "string",
"minLength": 1,
"maxLength": 16384
},
"serviceId": {
"type": "string",
"minLength": 1,
"maxLength": 16384
}
}
},
"availableRemedies": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/components/schemas/ResolutionRemedyV1",
"type": "object",
"additionalProperties": false,
"required": [
"code",
"settlementAction",
"maximumAmount"
],
"properties": {
"code": {
"type": "string"
},
"settlementAction": {
"type": "string",
"enum": [
"release_to_claimant",
"release_to_respondent",
"allocate_by_award",
"none"
]
},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1",
"type": "object",
"additionalProperties": false,
"required": [
"currency",
"minorUnits"
],
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"minorUnits": {
"type": "string",
"pattern": "^[1-9][0-9]{0,14}$",
"description": "Positive USD minor units, capped at exactly 15 decimal digits by Bridge v1."
}
}
}
}
}
},
"executionProvider": {
"$ref": "#/components/schemas/ResolutionExecutionProviderV1",
"type": "object",
"additionalProperties": false,
"required": [
"providerId",
"adapter",
"mode",
"externalReference",
"allowedActions",
"authorizationExpiresAt"
],
"properties": {
"providerId": {
"type": "string"
},
"adapter": {
"type": "string"
},
"mode": {
"type": "string",
"enum": [
"manual_partner",
"partner_callback",
"platform_adapter"
]
},
"externalReference": {
"type": "string"
},
"allowedActions": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"release_to_claimant",
"release_to_respondent",
"allocate_by_award",
"none"
]
}
},
"authorizationExpiresAt": {
"type": "string",
"format": "date-time"
}
}
},
"proof": {
"type": "object",
"additionalProperties": false,
"required": [
"format",
"payload",
"signatures"
],
"properties": {
"format": {
"type": "string",
"const": "jws-json-general"
},
"payload": {
"type": "string"
},
"signatures": {
"type": "array",
"minItems": 2,
"maxItems": 2,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"protected",
"signature"
],
"properties": {
"protected": {
"type": "string"
},
"signature": {
"type": "string"
}
}
}
}
}
}
}
},
"proposedCase": {
"$ref": "#/components/schemas/ResolutionProposedCaseV1",
"description": "Unsigned transport intent compared exactly to both principals' signed authorization; it is never treated as consent.",
"type": "object",
"additionalProperties": false,
"required": [
"schemaVersion",
"transactionId",
"claimantPrincipalId",
"respondentPrincipalId",
"merchantOrCounterpartyId",
"evidenceManifestHash",
"coveredClaims",
"appointment",
"rules",
"terms",
"availableRemedies",
"requestedRemedy",
"executionProvider"
],
"properties": {
"schemaVersion": {
"type": "string",
"const": "resolution-proposed-case-v1"
},
"transactionId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{43}$"
},
"claimantPrincipalId": {
"type": "string"
},
"respondentPrincipalId": {
"type": "string"
},
"merchantOrCounterpartyId": {
"type": "string"
},
"evidenceManifestHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"coveredClaims": {
"$ref": "#/components/schemas/ResolutionCoveredClaimsV1",
"type": "object",
"additionalProperties": false,
"required": [
"scope",
"claimTypes",
"maximumAmount"
],
"properties": {
"scope": {
"type": "string"
},
"claimTypes": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"type": "string"
}
},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1",
"type": "object",
"additionalProperties": false,
"required": [
"currency",
"minorUnits"
],
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"minorUnits": {
"type": "string",
"pattern": "^[1-9][0-9]{0,14}$",
"description": "Positive USD minor units, capped at exactly 15 decimal digits by Bridge v1."
}
}
}
}
},
"appointment": {
"$ref": "#/components/schemas/ResolutionAppointmentV1",
"type": "object",
"additionalProperties": false,
"required": [
"administrator",
"tribunal",
"caseMode",
"procedureProfile"
],
"properties": {
"administrator": {
"type": "string",
"const": "People's Court"
},
"tribunal": {
"type": "string",
"const": "People's Court Tribunal"
},
"caseMode": {
"type": "string",
"const": "evaluation"
},
"procedureProfile": {
"type": "string",
"const": "evaluation"
}
}
},
"rules": {
"$ref": "#/components/schemas/ResolutionRulesV1",
"type": "object",
"additionalProperties": false,
"required": [
"rulesetId",
"version",
"hash",
"url"
],
"properties": {
"rulesetId": {
"type": "string"
},
"version": {
"type": "string"
},
"hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
}
}
},
"terms": {
"$ref": "#/components/schemas/ResolutionTermsV1",
"type": "object",
"additionalProperties": false,
"required": [
"version",
"hash"
],
"properties": {
"version": {
"type": "string"
},
"hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"legalContext": {
"$ref": "#/components/schemas/ResolutionLegalContextBindingV1",
"type": "object",
"additionalProperties": false,
"required": [
"lcpSpecVersion",
"legalContextSha256",
"termsAtrHash",
"clauseId",
"clauseSha256",
"rulesSha256",
"catalogSha256",
"providerId",
"serviceId"
],
"properties": {
"lcpSpecVersion": {
"type": "string",
"const": "0.1.38"
},
"legalContextSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"termsAtrHash": {
"type": "string",
"pattern": "^0x[a-f0-9]{64}$"
},
"clauseId": {
"type": "string",
"pattern": "^sha256:0x[a-f0-9]{64}$"
},
"clauseSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"rulesSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"catalogSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"providerId": {
"type": "string",
"minLength": 1,
"maxLength": 16384
},
"serviceId": {
"type": "string",
"minLength": 1,
"maxLength": 16384
}
}
},
"availableRemedies": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/components/schemas/ResolutionRemedyV1",
"type": "object",
"additionalProperties": false,
"required": [
"code",
"settlementAction",
"maximumAmount"
],
"properties": {
"code": {
"type": "string"
},
"settlementAction": {
"type": "string",
"enum": [
"release_to_claimant",
"release_to_respondent",
"allocate_by_award",
"none"
]
},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1",
"type": "object",
"additionalProperties": false,
"required": [
"currency",
"minorUnits"
],
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"minorUnits": {
"type": "string",
"pattern": "^[1-9][0-9]{0,14}$",
"description": "Positive USD minor units, capped at exactly 15 decimal digits by Bridge v1."
}
}
}
}
}
},
"requestedRemedy": {
"type": "object",
"additionalProperties": false,
"required": [
"action",
"currency",
"minorUnits"
],
"properties": {
"action": {
"type": "string",
"enum": [
"release_to_claimant",
"release_to_respondent",
"allocate_by_award",
"none"
]
},
"currency": {
"type": "string",
"const": "USD"
},
"minorUnits": {
"type": "string",
"pattern": "^[1-9][0-9]{0,14}$"
}
}
},
"executionProvider": {
"$ref": "#/components/schemas/ResolutionExecutionProviderV1",
"type": "object",
"additionalProperties": false,
"required": [
"providerId",
"adapter",
"mode",
"externalReference",
"allowedActions",
"authorizationExpiresAt"
],
"properties": {
"providerId": {
"type": "string"
},
"adapter": {
"type": "string"
},
"mode": {
"type": "string",
"enum": [
"manual_partner",
"partner_callback",
"platform_adapter"
]
},
"externalReference": {
"type": "string"
},
"allowedActions": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"release_to_claimant",
"release_to_respondent",
"allocate_by_award",
"none"
]
}
},
"authorizationExpiresAt": {
"type": "string",
"format": "date-time"
}
}
}
}
}
}
}