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:

reasonWhat was wrong
payee_proof_v1the request sent payeeProof (an address-and-time proof); refused at every version as a security exception: send payeeConsent
payee_consent_malformedpayeeConsent is not {audience, grantee, scope, expiresAt, nonce, issuedAt, signature}
payee_consent_staleissued more than 300 seconds from the deployment's clock
payee_consent_audiencemade for another deployment or tenant
payee_consent_granteenames another grantee than this deployment's (GET /payee/v1/audience)
payee_consent_scopethe scope is not payee-credential
payee_consent_expirythe credential expiry is not in the future, or is more than 365 days away
payee_consent_replayedthis consent was already used
payee_consent_signaturenot 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.