Block Card API

Block card API enables the blocking of a card. Following are the types of card blocks.

Block Type	Description
`Temporary`	Card will be temporarily blocked (No transactions will be permitted).
`Permanent`	Card is permanently blocked which will categorize as lost/stolen/damaged.
`Custom`	Card will be custom-blocked (partial transactions will be allowed).
`Debit`	All debits from the card will be blocked (except system debits).
`Credit`	All credits to the card will be blocked (except system credits)

Environment


Sandbox	https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v3/block
Production	Contact your WIBMO KAM or support.

Sample request

curl --request PATCH \
     --url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/onboarding/v3/block \
     --header 'X-Consumer-Custom-ID: F42BC4E7B801C834B630DE498473533F' \
     --header 'bankId: 6060' \
     --header 'clientId: 1060' \
     --header 'content-type: application/json' \
     --header 'entityId: 100' \
     --header 'secureCode: pu8gSMLNE7pNv36IlUmstU' \
     --header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
     --data '
{
  "token": "/kC+jhu5B91FB0lvI51J+7dNt4mFhdgKhSijAlvZ22UzYRrRxAoCckmL9tsmo7vG3ZVqjSS0LJycwWbdF8dD4TpTLJuedn9QTA4Jm4E02QQ+mDOBQAkvJQyE+PLxB8VYhSEOdx4nNU7Fj2j75xwLyCLgbVe+icbHRL669BIMV8R7pzE6zbKTinSYkPJuMpsbKYnh9Llbld/Usis6URQPHx9WITE7y3llxTHKZnICHrTloDmuHfAhaG3enAYXP7WyMePLGQZw97QPKb/6eRzVukwNuUwBnLGUV9xkDUOwsyGLRyy+scTizhRrPaI8QTL4sVeAgJcEnjoo+p6pqASteDUaPlYxCpDYmGOGaVNheUFsTOxqN0VTOrYoG1kkE1oibg+bY9eb6jujWJNX3KXwa45z0LH8dzQA8etW+8ZHTayYFYumW72Fx3+96tzMNusK"
}
'

Response parameters (Decrypted)

This API will provide a token in the response that must be decrypted using the Decrypt API. The decrypted response is similar to the following:

Attribute	Type	Parameter Requirement	Description
messageCode	Numeric(4)	Mandatory	API Unique IDentifier.
clientTxnId	String(100)	Mandatory	Value echoed from the request.
urn	Numeric(11)	Mandatory	Value echoed from the request.
customerId	String(20)	Mandatory	Value echoed from the request.
accosaTransactionId	Numeric(10)	Mandatory	Unique ID for a particular transaction generated in Prepaid
description	String(100)	Optional	Reserved field to send information to client.
accosaRefNo	Numeric(20)	Mandatory	Auto-generated sequence number.

Sample response (Decrypted)

{ 
    "urn": 1000000, 
    "customerId": "62508sree0061", 
    "description": "[RESERVE_1]", 
    "responseCode": "00", 
    "messageCode": 1241, 
    "clientTxnId": "BLOCK_JM_aax11LrjoCV-f34", 
    "clientId": "2030", 
    "responseDateTime": "20230615234800", 
    "responseMessage": "SUCCESS", 
    "bankId": 7030, 
    "accosaRefNo": "52" 
}

Error codes

Error Code	Description
00	SUCCESS
1001	CARD NOT FOUND
1009	CARD CANCELLED CLOSED EXPIRED
1010	CARD TEMPORARY BLOCK
1011	CARD PERMANENT BLOCK
1012	CARD PENDING CANCELLATION
1030	INVALID MESSAGE
1034	INVALID_MOBILE_NUMBER
1045	UNABLE TO PROCESS REQUEST
1054	DUPLICATE REQUEST
1084	URN AND CUSTOMER ID MISMATCH
1112	INVALID BLOCK TYPE
1117	CARD DEBIT BLOCK
1118	CARD CREDIT BLOCK
1121	CARD CREDIT DEBIT BLOCK
1131	CARD CUSTOM BLOCK
1231	DATA_NOT_FOUND
1237	DUPLICATE_PHONE_NUMBER_WITH_MULTIPLE_ACCOUNT
1356	CARD_NOT_ACTIVE
1366	PROGRAM IS INACTIVE
1367	PROGRAM NOT FOUND
5002	BLOCK_TYPE_IS_MANDATORY

Request parameters