payee_consent: The payee consent was refused
POST /owner/v1/scoped-credentials with kind: "payee" mints a payee credential only from the payee's own consent: payeeConsent, a dynamo-payee-consent-v1 signature by the serviceNode key over the deployment's audience, the payee's address, the grantee, the scope payee-credential, the credential's expiry, a fresh nonce and the time (owner-api 1.9.0). The consent was refused; no credential was minted.
reason names the check:
reason | What was wrong |
|---|---|
payee_proof_v1 | the request sent payeeProof (an address-and-time proof); refused at every version as a security exception: send payeeConsent |
payee_consent_malformed | payeeConsent is not {audience, grantee, scope, expiresAt, nonce, issuedAt, signature} |
payee_consent_stale | issued more than 300 seconds from the deployment's clock |
payee_consent_audience | made for another deployment or tenant |
payee_consent_grantee | names another grantee than this deployment's (GET /payee/v1/audience) |
payee_consent_scope | the scope is not payee-credential |
payee_consent_expiry | the credential expiry is not in the future, or is more than 365 days away |
payee_consent_replayed | this consent was already used |
payee_consent_signature | not signed by the serviceNode's key |
What to do
Ask the payee for a new consent (PayeeClient.consent(expiresAt) in @dynamoprotocol/payee-kit 1.0.0 or the Python dynamoprotocol 1.0.0). A consent mints one credential, once. See getting paid as a payee.
On the wire
HTTP 400.
{
"error": "payee_consent",
"reason": "payee_consent_replayed",
"errorDetail": {
"type": "invalid_request_error",
"code": "payee_consent",
"message": "the payee consent's nonce was already used (fail closed)",
"param": "payeeConsent",
"doc_url": "docs/site/errors/payee_consent.md",
"fix": "the payee signs dynamo-payee-consent-v1 (audience, grantee, scope, expiry, nonce, issue time) with its serviceNode key within 300 s; GET /payee/v1/audience answers the audience and grantee"
}
}
See all error codes.