Version: 1.0.6

Replace Card - Reissue Card

REISSUE - A replacement card is issued on retaining the same Primary Account Number (PAN) as the original card.

REPLACE - A replacement card is issued with a new Primary Account Number (PAN).

Method: POST

{{URL}}/cardv2

Example

Request Parameters

Parameters	Description
reference Optional	String Unique reference ID of the request Sample Value: "visadps100017"
product Mandatory	String Name of the product associated with the card Sample Value: "DEFAULT"
program Mandatory	String Name of the program to which the card product is mapped Sample Value: "DEFAULT"
channel Mandatory	Enum Processing channel through which the card transaction happens Valid Values: PULSE VISA_DPS Sample Value: "VISA_DPS"
transactionType Mandatory	String Type of operation / transaction Constant Value: "REPLACE_CARD"
customerId Mandatory	String Unique ID of customer who holds the card Sample Value: "100000000006001"
cardId Mandatory	String Unique ID of the card Sample Value: "6f586be7bf1c44b8b4ea11b2e2510e25"
accountNumber Mandatory	String Account number linked to the card Sample Value: "400320588344662"
statusAction Mandatory	Enum Card has to be either replaced or reissued Valid Values: REPLACE_CARD REISSUE Sample Value: "REPLACE_CARD"

Parameters

Description

reference

Optional

String

Unique reference ID of the request

Sample Value: "visadps100017"

product

Mandatory

String

Name of the product associated with the card

Sample Value: "DEFAULT"

program

Mandatory

String

Name of the program to which the card product is mapped

Sample Value: "DEFAULT"

channel

Mandatory

Enum

Processing channel through which the card transaction happens

Valid Values:

PULSE

VISA_DPS

Sample Value: "VISA_DPS"

transactionType

Mandatory

String

Type of operation / transaction

Constant Value: "REPLACE_CARD"

customerId

Mandatory

String

Unique ID of customer who holds the card

Sample Value: "100000000006001"

cardId

Mandatory

String

Unique ID of the card

Sample Value: "6f586be7bf1c44b8b4ea11b2e2510e25"

accountNumber

Mandatory

String

Account number linked to the card

Sample Value: "400320588344662"

statusAction

Mandatory

Enum

Card has to be either replaced or reissued

Valid Values:

REPLACE_CARD

REISSUE

Sample Value: "REPLACE_CARD"

cURL
C#
Go
NodeJs

curl --location --globoff --request GET '{{URL}}/cardv2' \
--header 'Content-Type: application/json' \
--data '{"method":"ledger.CARD.request","id":"1","params":{"payload":{"reference":"visadps100017","product":"DEFAULT","program":"DEFAULT","channel":"VISA_DPS","transactionType":"REPLACE_CARD","customerId":"100000000006001","cardId":"6f586be7bf1c44b8b4ea11b2e2510e25","accountNumber":"400320588344662","statusAction":"REPLACE_CARD"},"api":{"credential":"{{cred}}","signature":"{{signature}}","apiKey":"{{Api-key}}"}}}'

var options = new RestClientOptions("{{URL}}/cardv2")
{
  MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("", Method.Get);
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@"    ""method"": ""ledger.CARD.request"",
" + "\n" +
@"    ""id"": ""1"",
" + "\n" +
@"    ""params"": {
" + "\n" +
@"        ""payload"": {
" + "\n" +
@"            ""reference"": ""visadps100017"",
" + "\n" +
@"            ""product"": ""DEFAULT"",
" + "\n" +
@"            ""program"": ""DEFAULT"",
" + "\n" +
@"            ""channel"": ""VISA_DPS"",
" + "\n" +
@"            ""transactionType"": ""REPLACE_CARD"",
" + "\n" +
@"            ""customerId"": ""100000000006001"",
" + "\n" +
@"            ""cardId"": ""6f586be7bf1c44b8b4ea11b2e2510e25"",
" + "\n" +
@"            ""accountNumber"": ""400320588344662"",
" + "\n" +
@"            ""statusAction"": ""REPLACE_CARD"",
" + "\n" +
@"        },
" + "\n" +
@"        ""api"": {
" + "\n" +
@"            ""credential"": ""{{cred}}"",
" + "\n" +
@"            ""signature"": ""{{signature}}"",
" + "\n" +
@"            ""apiKey"": ""{{Api-key}}""
" + "\n" +
@"        }
" + "\n" +
@"    }
" + "\n" +
@"}";
request.AddStringBody(body, DataFormat.Json);
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "{{URL}}/cardv2"
  method := "GET"

  payload := strings.NewReader(`{`+"
"+`
    "method": "ledger.CARD.request",`+"
"+`
    "id": "1",`+"
"+`
    "params": {`+"
"+`
        "payload": {`+"
"+`
            "reference": "visadps100017",`+"
"+`
            "product": "DEFAULT",`+"
"+`
            "program": "DEFAULT",`+"
"+`
            "channel": "VISA_DPS",`+"
"+`
            "transactionType": "REPLACE_CARD",`+"
"+`
            "customerId": "100000000006001",`+"
"+`
            "cardId": "6f586be7bf1c44b8b4ea11b2e2510e25",`+"
"+`
            "accountNumber": "400320588344662",`+"
"+`
            "statusAction": "REPLACE_CARD",`+"
"+`
        },`+"
"+`
        "api": {`+"
"+`
            "credential": "{{cred}}",`+"
"+`
            "signature": "{{signature}}",`+"
"+`
            "apiKey": "{{Api-key}}"`+"
"+`
        }`+"
"+`
    }`+"
"+`
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

var https = require('follow-redirects').https;
var fs = require('fs');

var options = {
  'method': 'GET',
  'hostname': '{{URL}}',
  'path': '/cardv2',
  'headers': {
    'Content-Type': 'application/json'
  },
  'maxRedirects': 20
};

var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

var postData = JSON.stringify({
  "method": "ledger.CARD.request",
  "id": "1",
  "params": {
    "payload": {
      "reference": "visadps100017",
      "product": "DEFAULT",
      "program": "DEFAULT",
      "channel": "VISA_DPS",
      "transactionType": "REPLACE_CARD",
      "customerId": "100000000006001",
      "cardId": "6f586be7bf1c44b8b4ea11b2e2510e25",
      "accountNumber": "400320588344662",
      "statusAction": "REPLACE_CARD"
    },
    "api": {
      "credential": "{{cred}}",
      "signature": "{{signature}}",
      "apiKey": "{{Api-key}}"
    }
  }
});

req.write(postData);

req.end();

Body

{
    "method": "ledger.CARD.request",
    "id": "1",
    "params": {
        "payload": {
            "reference": "visadps100017",
            "product": "DEFAULT",
            "program": "DEFAULT",
            "channel": "VISA_DPS",
            "transactionType": "REPLACE_CARD",
            "customerId": "100000000006001",
            "cardId": "6f586be7bf1c44b8b4ea11b2e2510e25",
            "accountNumber": "400320588344662",
            "statusAction": "REPLACE_CARD"
        },
        "api": {
            "credential": "{{cred}}",
            "signature": "{{signature}}",
            "apiKey": "{{Api-key}}"
        }
    }
}

Response: 200

Response Parameters

Parameter	Description
id	String Response ID echoed from the request ID.
result	Object
card	Object
cardId	String Unique ID of the original card. Sample Value : "6f586be7bf1c44ashdufjea11b2e2510e25"
cardHolderId	String Identifier of the card holder. Sample Value : "CH00000000050005"
cardHolderName	String Name of the card holder. Sample Value : "Matthew Sandra"
cardProduct	String ID of the associated card product. Sample Value : "2c6b841a-abc0-4a6a-b32b-13c21035b5be"
customerId	String Unique ID of the customer. Sample Value : "100220000005005"
accountId	String Account ID linked to the card. Sample Value : "332004"
product	String Name of the product associated with the card. Sample Value : "DEFAULT"
program	String Name of the program to which the card product is mapped. Sample Value : "DEFAULT"
cardType	String Type of card issued. Sample Value : "PHYSICAL".
postedDate	String Date and time when the request for replace / reissue card status was posted. Sample Value : "2024-11-20T06:54:26.822Z"
updatedDate	String Date and time when the status was updated. Sample Value : "2024-11-20T07:25:56.513Z"
cardMaskNumber	String Masked card number (last 4 digits visible). Sample Value: "********1234"
cardNumber	String Encrypted card number. Sample Value : "649f748bd123acb524db4f2100bb79a91c"
cardStatus	String Current Status of the card. Sample Value : CARD_IS_NOT_ACTIVATED.
cardExpiryDate	String Expiry date of the card in YYYYMM format. Sample Value : "202611"
allowAtm	Boolean Whether ATM transactions are allowed. Sample Value : "true"
allowEcommerce	Boolean Whether eCommerce transactions are allowed. Sample Value : "true"
allowMoto	Boolean Whether MOTO transactions are allowed. Sample Value : "true"
allowPos	Boolean Whether POS transactions are allowed. Sample Value : "true"
allowTips	Boolean Whether tips are allowed. Sample Value : "true"
allowPurchase	Boolean Whether purchases are allowed. Sample Value : "true"
allowRefund	Boolean Whether refunds are allowed. Sample Value : "true"
allowCashback	Boolean Whether cashback is allowed. Sample Value : "true"
allowWithdraw	Boolean Whether fund withdrawal is allowed. Sample Value : "true"
allowAuthAndCompletion	Boolean Whether split auth/completion is supported. Sample Value : "true"
smart	Boolean Whether the card is smart-enabled. Sample Value : "true"
checkAvsZip	Boolean ZIP code check enabled for AVS. Sample Value : "true"
checkAvsAddr	Boolean Address check enabled for AVS. Sample Value : "true"
cvv	String CVV of the card. Sample Value : ""
accountNumber	String Account number associated with the Card. Sample Value : "400320666344662"
cardName	String Name on the card. Sample Value : "John"
patterns	Array Pattern of the Card.
transactionMade	Boolean Whether any transaction was made. Sample Value : "false"
orderStatus	String Status of the card order. Sample Value : "ORDER_PLACED"
orderId	String Unique ID of the card order. Sample Value : "4B000XX8E0CD00"
network	String Card Network. Sample Value : VISA_DPS.
isReIssue	Boolean Reissue request placed for the card. Sample Value : "false"
isReplace	Boolean Replace request placed for the card. Sample Value : "true"
externalCardId	String Unique card ID that links the card and the external processor. Sample Value: "v-201-35c8bce1-1107-4282-8541-ae8401e65d0e"
cardCreatedYear	String Year when the card was created. Sample Value: "2025"
orderSubStatus	String Substatus that provides further details about the card order process from the external processor. Sample Value: "ORDER_PENDING"
accountName	String Name of the associated account. Sample Value: "David Savings Account"
customerName	String Name of the customer. Sample Value: "David"
api	Object
type	String Acknowledgement for type of operation requested for. Sample Value: "REPLACE_CARD_ACK".
reference	String Reference ID of the API response. Sample Value: "REFvisadps100017"
dateCreated	Number UNIX timestamp of when the response was created. Sample Value: "1732087711"
originalReference	String Original reference ID taken from the request. Sample Value: "visadps100017"
newCard	Object
cardId	String Unique ID of the newly issued card. Sample Value : "03fd61f9e123556f8k9k40a198ffcc28gh"
cardHolderId	String Identifier of the card holder. Sample Value : "CH00000000050005"
cardHolderName	String Name of the card holder. Sample Value : "Matthew Sandra"
cardProduct	String ID of the associated card product. Sample Value : "2c6b841a-abc0-4a6a-b32b-13c21035b5be"
customerId	String Unique ID of the customer. Sample Value : "100220000005005"
accountId	String Account ID linked to the card. Sample Value : "332004"
product	String Name of the product associated with the card. Sample Value : "DEFAULT"
program	String Name of the program to which the card product is mapped. Sample Value : "DEFAULT"
cardType	String Type of card issued. Sample Value : "PHYSICAL".
postedDate	String Date and time when the request for replace / reissue card status was posted. Sample Value : "2024-11-20T06:54:26.822Z"
updatedDate	String Date and time when the status was updated. Sample Value : "2024-11-20T07:25:56.513Z"
cardMaskNumber	String Masked card number (last 4 digits visible). Sample Value: "********5678"
cardNumber	String Encrypted card number. Sample Value : "123f748bd123acb524db5f2100bb79a91c"
cardStatus	String Current Status of the card. Sample Value : CARD_IS_NOT_ACTIVATED.
cardExpiryDate	String Expiry date of New card in YYYYMM format. Sample Value : 205001
allowAtm	Boolean Whether ATM transactions are allowed. Sample Value : "true"
allowEcommerce	Boolean Whether eCommerce transactions are allowed. Sample Value : "true"
allowMoto	Boolean Whether MOTO transactions are allowed. Sample Value : "true"
allowPos	Boolean Whether POS transactions are allowed. Sample Value : "true"
allowTips	Boolean Whether tips are allowed. Sample Value : "true"
allowPurchase	Boolean Whether purchases are allowed. Sample Value : "true"
allowRefund	Boolean Whether refunds are allowed. Sample Value : "true"
allowCashback	Boolean Whether cashback is allowed. Sample Value : "true"
allowWithdraw	Boolean Whether fund withdrawal is allowed. Sample Value : "true"
allowAuthAndCompletion	Boolean Whether split auth/completion is supported. Sample Value : "true"
smart	Boolean Whether the card is smart-enabled. Sample Value : "true"
checkAvsZip	Boolean ZIP code check enabled for AVS. Sample Value : "true"
checkAvsAddr	Boolean Address check enabled for AVS. Sample Value : "true"
cvv	String CVV of the card. Sample Value : ""
accountNumber	String Account number associated with the Card. Sample Value : "400320666344662"
cardName	String Name on the card. Sample Value : "John"
patterns	Array Pattern of the Card.
transactionMade	Boolean Whether any transaction was made. Sample Value : "false"
orderStatus	String Status of the new card order. Sample Value : "ORDER_PLACED"
orderId	String Unique ID of the new card order. Sample Value : "4B000XX8E0CD00"
network	String Card Network. Sample Value : VISA_DPS.
isReIssue	Boolean Reissue request placed for the new card. Sample Value : "false"
isReplace	Boolean Replace request placed for the new card. Sample Value : "false"
externalCardId	String Card ID that links the new card and the external processor. Sample Value: "v-201-35c8bce1-1107-4282-8541-ae8401e65d0e"
originalCardId	String ID of the original card being replaced.
cardCreatedYear	String Year when the card was created. Sample Value: "2025"
orderSubStatus	String Substatus that provides further details about the card order process from the external processor. Sample Value: "ORDER_PENDING"
accountName	String Name of the associated account. Sample Value: "David Savings Account"
customerName	String Name of the customer. Sample Value: "David"

{
    "id": "1",
    "result": {
        "card": {
            "cardId": "dc904af4be784b7ba854980b7833a5e0",
            "cardHolderId": "CH00000000059002",
            "cardHolderName": "Jace morgenstorm",
            "cardProduct": "2c6b841a-dfc1-4a6a-a12a-13c21035b5be",
            "customerId": "100000000042003",
            "accountId": "5466007",
            "product": "DEFAULT",
            "program": "DEFAULT",
            "cardType": "PHYSICAL",
            "postedDate": "2025-06-24T07:24:16.725Z",
            "updatedDate": "2025-06-24T07:24:16.725Z",
            "cardMaskNumber": "************1251",
            "cardNumber": "5a2201e70e3b759fa2f332ad36757fac",
            "cardStatus": "CARD_IS_NOT_ACTIVATED",
            "cardExpiryDate": "202706",
            "allowAtm": true,
            "allowEcommerce": true,
            "allowMoto": true,
            "allowPos": true,
            "allowTips": true,
            "allowPurchase": true,
            "allowRefund": true,
            "allowCashback": true,
            "allowWithdraw": false,
            "allowAuthAndCompletion": false,
            "smart": true,
            "checkAvsZip": true,
            "checkAvsAddr": true,
            "cvv": "",
            "accountNumber": "653421225769581",
            "cardName": "Jace morgenstorm",
            "patterns": [
                "CARDNUMBER:1251",
                "DATE:24062025",
                "CARDHOLDERNAME:JACE MORGENSTORM",
                "CARDNAME:JACE MORGENSTORM",
                "ACCOUNTNUMBER:653421225769581",
                "CUSTOMERID:100000000042003",
                "ACCOUNTNAME:DREAMFI ACCOUNT",
                "CUSTOMERNAME:NITHISH MATHEW",
                "CARDSTATUS:CARD_IS_NOT_ACTIVATED"
            ],
            "transactionMade": false,
            "orderStatus": "ORDER_PLACED",
            "orderId": "4UQI755BONHO000",
            "network": "VISA_DPS",
            "isReIssue": true,
            "isReplace": false,
            "externalCardId": "v-401-448133ef-4868-48bf-b67a-6cbff4af4f59",
            "cardCreatedYear": "2025",
            "orderSubStatus": "ORDER_PENDING",
            "accountName": "DreamFi Account",
            "customerName": "Nithish Mathew"
        },
        "api": {
            "type": "REISSUE_CARD_ACK",
            "reference": "REFDPSREF1100009",
            "dateCreated": 1750750111,
            "originalReference": "DPSREF1100009"
        },
        "newCard": {
            "cardId": "02fd61f9e2134f8f9f40a198ffcc28af",
            "cardHolderId": "CH00000000059002",
            "cardHolderName": "Jace morgenstorm",
            "cardProduct": "2c6b841a-dfc1-4a6a-a12a-13c21035b5be",
            "customerId": "100000000042003",
            "accountId": "5466007",
            "product": "DEFAULT",
            "program": "DEFAULT",
            "cardType": "PHYSICAL",
            "postedDate": "2025-06-24T07:28:31.172652703Z",
            "updatedDate": "2025-06-24T07:28:31.172652791Z",
            "cardMaskNumber": "************1251",
            "cardNumber": "5a2201e70e3b759fa2f332ad36757fac",
            "cardStatus": "CARD_IS_NOT_ACTIVATED",
            "cardExpiryDate": "202708",
            "allowAtm": true,
            "allowEcommerce": true,
            "allowMoto": true,
            "allowPos": true,
            "allowTips": true,
            "allowPurchase": true,
            "allowRefund": true,
            "allowCashback": true,
            "allowWithdraw": false,
            "allowAuthAndCompletion": false,
            "smart": true,
            "checkAvsZip": true,
            "checkAvsAddr": true,
            "cvv": "",
            "accountNumber": "653421225769581",
            "cardName": "Jace morgenstorm",
            "patterns": [
                "CARDNUMBER:1251",
                "DATE:24062025",
                "CARDHOLDERNAME:JACE MORGENSTORM",
                "CARDNAME:JACE MORGENSTORM",
                "ACCOUNTNUMBER:653421225769581",
                "CUSTOMERID:100000000042003",
                "ACCOUNTNAME:DREAMFI ACCOUNT",
                "CUSTOMERNAME:NITHISH MATHEW",
                "CARDSTATUS:CARD_IS_NOT_ACTIVATED",
                "EXISTCARDNUMBER:1251",
                "DATE:24062025"
            ],
            "transactionMade": false,
            "orderStatus": "ORDER_PLACED",
            "orderId": "4UQI76RUFQXN000",
            "network": "VISA_DPS",
            "isReIssue": false,
            "isReplace": false,
            "externalCardId": "v-401-448133ef-4868-48bf-b67a-6cbff4af4f59",
            "originalCardId": "dc904af4be784b7ba854980b7833a5e0",
            "cardCreatedYear": "2025",
            "orderSubStatus": "ORDER_PENDING",
            "accountName": "DreamFi Account",
            "customerName": "Nithish Mathew"
        }
    }
}

Replace Card - Reissue Card

Method: POST​

Example​

Body​

Response: 200​

Method: POST

Example

Body

Response: 200