Replace Card

Replace Card Request service uses POST method to replace the existing registered card.
When value is 'TRUE', cardholder portal login information is NOT moved to a new card. chargeFee needs to be 'TRUE’ or ‘FALSE’. If a fee exists for card replacement, setting this value to ‘TRUE’ will cause the fee to be charged.
The API will create a new card linked to the MSISDN of the replaced card. Card can be replaced when in status below other than PreActive PA:

• Active AC
• Expired EX
• Inactive IA
• Lost/ Stolen SC
• Compromised PU
  After card is replaced, it is set to RP(Replaced) status. Residual balance on replaced card is automatically transferred to the Replacement card. Card Replacement Fee will be deducted from the residual balance, or it will be suspended until there are available funds to be taken at that point. The new card is active on creation.

Endpoint

/MFSAfricaCard/v1/replacecard

Request

{
  "chargeFee": false,
  "last4": "8197",
  "mobilePhoneNumber": "25612345678",
  "replaceDueToFraud": true,
  "replacementCardType": "Virtual"
}

Response

{
  "errorCode": "0000",
  "errorMessage": "SUCCESS",
  "registrationAccountId": "12702709",
  "registrationLast4Digits": "1234",
  "registrationPassCode": "null"
}