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"
}

Field (* required field)

Type

Description

last4*

string

Last4Digits of card associated with phone number for card to be replaced

mobilePhoneNumber*

string

Mobile Number associated with card

chargeFee*

string

Valid values: “true’ or ‘false’. If a fee exists for card replacement, setting this value to ‘true’ will cause the fee to be charged

replaceDueToFraud*

string

Valid values: “true’ or ‘false’. If value is ‘true’, cardholder portal login information is NOT moved to new card

replacementCardType*

string

Valid values: ‘Physical’ or ‘Virtual’

Response

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

Field

Type

Description

errorCode

string

Error Code

errorMessage

string

Error Message

registrationAccountId

string

The customer ID of the newly created account holder

registrationLast4Digits

string

The last four digits of 16 digit PAN of the new card.

registrationPassCode

string

The Registration Pass Code of the new card