Request Card Replacement

POST

/api/v0/partner/enKashCard/replaceCard

📌

This API enables the replacement of an existing card, allowing users to request a new one in cases of loss, damage, or other issues. It ensures continued access and maintains security in card usage

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

enKashCardId

string

required

Unique identifier for the EnKash card.

otpRequestId

string

optional

Unique identifier for the OTP request.

cardAccountId

string

optional

Unique identifier for the account under company.

otpMedium

enum<string>

required

Medium for OTP verification. Options are "MOBILE" for SMS and "MFA" for Authenticator code

Allowed values:

MOBILEMFA

otp

string

optional

One-Time Password for verification if otpMedium is MOBILE.

mfaCode

string

optional

Multi-Factor Authentication code if otpMedium is MFA

otpRequired

boolean

required

to be passed as false

Example

{
    "enKashCardId": "string",
    "otpRequestId": "string",
    "cardAccountId": "string",
    "otpMedium": "MOBILE",
    "otp": "string",
    "mfaCode": "string",
    "otpRequired": true
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v0/partner/enKashCard/replaceCard' \
--header 'authorization: Bearer 2f68dbbf-519d-4f01-9636-e2421b68f379' \
--header 'partnerId:  CRXXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "enKashCardId": "string",
    "otpRequestId": "string",
    "cardAccountId": "string",
    "otpMedium": "MOBILE",
    "otp": "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:07

Get Card Usage Limits

Block Card