wallet.required | 400 | This agent can use several wallets. Pass walletId. |
card.multiUseReadNotAllowed | 403 | Agents can’t read multi-use cards. Create a single-use card for this purchase instead, with the merchant, the maximum amount, and the currency, and read that card. This keeps card use by agents compliant. If you have questions, contact support@natural.com. |
card.readRequired | 403 | This agent’s access to the wallet doesn’t include cards.read. |
issuedCards.notEnabled | 403 | Issued cards are not enabled for the wallet’s owner. |
party.ownerOrAdminRequired | 403 | Only an Owner or Admin on the account, acting for it, can freeze, unfreeze, or close another holder’s card. |
payment.createRequired | 403 | Closing a virtual card on your wallet needs payments.create on that wallet. |
wallet.accessDenied | 403 | This agent can’t spend from that wallet. |
agentCard.notFound | 404 | Card not found. |
agentCard.notActive | 409 | This card isn’t active: it was used, expired, closed, or failed to issue. Create a new card. |
card.activeLimitReached | 409 | The wallet’s owner already has as many active virtual cards as it can hold. A card stops counting once it is used or expires. |
card.setupFailed | 409 | Couldn’t set up a card for this wallet. Retrying won’t help. |
cardholder.unavailable | 409 | The wallet’s owner isn’t set up to hold virtual cards yet. |
virtualCard.stateConflict | 409 | The card is already in that state, or is closed, so the change doesn’t apply. Get the card to see its status. |
agentCard.closeUnavailable | 503 | Couldn’t close the card right now. It may still be active. Retry the close. |
agentCard.closeUnconfirmed | 503 | The card is closed and declines purchases, but the card network hasn’t confirmed it yet. Retry the close. |
agentCard.detailsUnavailable | 503 | Couldn’t read the card’s details. data.retryable says whether to try again. |
cardIssuing.unavailable | 503 | Couldn’t issue the card right now. Retry with the same Idempotency-Key. |
virtualCard.changeUnavailable | 503 | Couldn’t change the card right now. Retry the request. |