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": {},
"closed": {
"$ref": "#/components/schemas/Ap2SdJwtArtifactV1"
}
}
},
"checkoutJwt": {
"type": "object",
"additionalProperties": false,
"required": [
"artifactId",
"compactJwt"
],
"properties": {
"artifactId": {},
"compactJwt": {}
}
},
"checkoutReceipt": {
"type": "object",
"additionalProperties": false,
"required": [
"artifactId",
"compactJws"
],
"properties": {
"artifactId": {},
"compactJws": {}
}
},
"paymentMandates": {
"type": "object",
"additionalProperties": false,
"required": [
"open",
"closed"
],
"properties": {
"open": {},
"closed": {
"$ref": "#/components/schemas/Ap2SdJwtArtifactV1"
}
}
},
"paymentReceipt": {
"type": "object",
"additionalProperties": false,
"required": [
"artifactId",
"compactJws"
],
"properties": {
"artifactId": {},
"compactJws": {}
}
}
}
},
"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"
}
}
}
}
}
},
"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": {},
"required": [
"side"
]
},
"minContains": 1,
"maxContains": 1
},
{
"contains": {
"type": "object",
"properties": {},
"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": {}
},
"agentAuthority": {
"type": "object",
"additionalProperties": false,
"required": [
"agentId",
"representedPrincipalId",
"allowedActs",
"maximumAmount",
"expiresAt",
"delegationArtifactRef",
"delegationArtifactHash"
],
"properties": {}
}
}
}
},
"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": {}
},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1"
}
}
},
"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": {},
"settlementAction": {},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1"
}
}
}
},
"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": {}
},
"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": {}
}
}
}
}
}
},
"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": {}
},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1"
}
}
},
"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": {},
"settlementAction": {},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1"
}
}
}
},
"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": {}
},
"authorizationExpiresAt": {
"type": "string",
"format": "date-time"
}
}
}
}
}
}
}