Enkash Developer Portal
Home
Home
Login
  1. Home
  • Back to home
  • Prepaid Card APIs
  • Encryption & Decryption Guide
  • Auth Token
    POST
  • Create Card Account
    POST
  • Create Gift Card
    POST
  • Create Prepaid Card
    POST
  • Set Card PIN
    POST
  • Load Card Balance
    POST
  • Get Card Account Details
    POST
  • Generate Card OTP
    POST
  • View Card Details
    POST
  • Card Usage Controls
    POST
  • Get Card Usage Limits
    POST
  • Request Card Replacement
    POST
  • Block Card
    POST
  • Order Physical Card
    POST
  • Get Card Details
    POST
  • Get Transaction Details
    POST
  • Get All Transaction details
    POST
  1. Home

Block Card

POST
/api/v0/partner/enKashCard/block
📌
This API is used to block a card, immediately preventing any further transactions. Use this endpoint to secure the card in cases of loss, theft, or suspicious activity

Request

Header Params
authorization
string 
required
Provide your bearer token in the Authorization header when making requests to protected resources.
Example:
Bearer 2f68dbbf-519d-4f01-9636-e2421b68f379
partnerId
string 
required
PartnerID shared during sign-up
Example:
CRXXXXXXX
Body Params application/json
companyId
string 
required
Unique EnKash Company ID. This is the ID assigned to a company onboarded on the EnKash platform.
cardAccountId
string 
required
Unique EnKash Account ID. This is the ID assigned to the account created under the company.
enKashCardId
string 
required
Unique identifier for the EnKash card.
blockCode
enum<string> 
required
Card status after card is blocked. Possible values are L - Locked, UL - Unlocked, BL - Blocked, AP - Activation InProgress.
Allowed values:
LULBLAP
reason
string 
optional
Reason for blocking the card.
otpMedium
enum<string> 
required
Medium for OTP. Allowed values are MOBILE and MFA.
Allowed values:
MOBILEMFA
otpRequestId
string 
optional
Indicates if OTP is required for this operation.
otp
string 
optional
OTP received by the user.
createdBy
string 
optional
Identifier of the user who created the request.
mfaCode
string 
optional
Authenticator code when otpMedium is MFA.
otpRequired
boolean 
required
to be passed as false
Example
{
    "companyId": "string",
    "cardAccountId": "string",
    "enKashCardId": "string",
    "blockCode": "L",
    "reason": "string",
    "otpMedium": "MOBILE",
    "otpRequestId": "string",
    "otp": "string",
    "createdBy": "string",
    "mfaCode": "string",
    "otpRequired": true
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://test.your-api-server.com/api/v0/partner/enKashCard/block' \
--header 'authorization: Bearer 2f68dbbf-519d-4f01-9636-e2421b68f379' \
--header 'partnerId:  CRXXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "companyId": "string",
    "cardAccountId": "string",
    "enKashCardId": "string",
    "blockCode": "L",
    "reason": "string",
    "otpMedium": "MOBILE",
    "otpRequestId": "string",
    "otp": "string",
    "createdBy": "string",
    "mfaCode": "string",
    "otpRequired": true
}'

Responses

🟢200OK
application/json
Body
code
integer 
required
message
string 
required
payload
string 
required
Example
{
  "code": 0,
  "message": "Success",
  "payload": "Success"
}
Modified at 2025-05-26 17:23:15
Previous
Request Card Replacement
Next
Order Physical Card
Built with