Skip to main content
POST
/
api
/
v1
/
user
/
card
/
lock
Lock card
curl --request POST \
  --url https://api.qash.ai/api/v1/user/card/lock \
  --header 'X-Api-Key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "locked"
}
Requires X-Api-Key, X-Api-Secret, and Authorization: Bearer <user-jwt>.
x-idempotency-key is required. Use a unique UUID for each lock request.
No transactions are authorized while the card is locked.

Authorizations

X-Api-Key
string
header
required

Partner API key. Generated from Qash Dashboard → Settings → API Keys.

Headers

x-idempotency-key
string<uuid>
required

Unique idempotency key for the operation. Use a UUID to prevent duplicate processing.

Response

Card locked successfully.

id
string<uuid>
required
status
enum<string>
required
Available options:
notActivated,
active,
locked,
canceled