Skip to main content
POST
Enable card settlement on a wallet
Sandbox only. This endpoint is available in sandbox only while we finish development. It is not available in production yet, and its request and response shapes may change before release.

Authorizations

x-api-key
string
header
required

Headers

x-idempotency-key
string<uuid>
required

Unique key to ensure request idempotency. If the same key is used within a certain time window, the original response will be returned instead of executing the request again.

Path Parameters

wallet_id
string
required

Wallet ID KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

Body

application/json
signatures
string[]
required

List of signatures over the intent

Cryptographic signature over the intent, base64-encoded. For an ES256 signer this is the ASN.1 DER ECDSA signature over the SHA-256 of the canonical intent. For a WEBAUTHN signer this is the base64 of the WebAuthn assertion JSON (id, rawId, type, and response.authenticatorData / clientDataJSON / signature). See the WebAuthn & Passkey Signing guide.

intent
object
required

The intent being endorsed

Response

The wallet's card enablement after the call

The card-settlement enablement state of a wallet.

state
enum<string>
required

Enablement lifecycle state. not_enabled — no enablement exists; attaching — the ceremony is endorsed but not fully in force (see the enablement endpoint for how to recover: a transient failure resumes by replaying the same intent with the same signatures, a rejected endorsement requires a corrected intent under a fresh idempotency_key); active — cards can be issued against the wallet; detach_requested / detached — offboarding states.

Available options:
not_enabled,
attaching,
active,
detach_requested,
detached
settlement_destination
string
required

The settlement destination address. For a not_enabled wallet, the Dakota-configured destination the enablement will pin; otherwise the destination recorded for the wallet. Informational: it is not part of the intent and is not signed by the client.