Cards

This API allows the user to change the PIN code for a card.

Custom Verb (changePIN)

/services/data/v1/RBObjects/operations/Cards/changePIN

Authorized App User

Parameters

cardId (Mandatory)

Specifies the card identification number.

Action (Mandatory)

Specifies the action possible for the card – “PinChange”

newPin (Mandatory)

Specifies a new PIN.

notes

Specifies additional notes of the user.

Reason

Specifies the reason for action

{
  "cardId":"346","Reason":"lb1","Action":"PinChange","notes":"",
  "newPin":"678678"
}

{
  "opstatus":0,
  "httpStatusCode":0,
  "updatedRecords":1
}

This API allows the user to lock the card. This API can be used in situations where there is a breach in the privacy of card details for the user.

Custom Verb (lockCard)

services/data/v1/RBObjects/operations/Cards/lockCard

Authorized App User

X-Kony-Authorization

Parameters     

cardId (Mandatory)

Specifies the card Id number.

Action (Mandatory)

Specifies the action on the card - Lock.

{
  "cardId":"346",
  "Action":"Lock"
}

{ 
 "opstatus":0,
 "httpStatusCode":0,
 "updatedRecords":1
}

This API allows the user to report the lost card.

Custom Verb - reportLost

/services/data/v1/RBObjects/operations/Cards/reportLost

Authorized App User

X-Kony-Authorization

Parameters

cardId (Mandatory)

Specifies the card Id number

Action (Mandatory)

Specifies the action on the card – Report Lost

    Reason (Mandatory)

Specifies the reason for reporting – Like Lost, Stolen

Notes

Any notes user wants to enter.

"cardId":"347","Reason":"Stolen","notes":"","Action":"Report Lost"}

{
  "opstatus":0,
  "httpStatusCode":0,
  "updatedRecords":1
}

This API allows the user to replace the card.

Custom Verb (replaceCard)

services/data/v1/RBObjects/operations/Cards/replaceCard

Authorized App User

X-Kony-Authorization

Parameters     

cardId (Mandatory)

Specifies the card Id number.

Action (Mandatory)

Specifies the action on the card – Replace Request.

    reason (Mandatory)

Specifies the reason for replacing the card – Like upgrade, physical, damage, and other.

{
 "cardId":"346",
 "Action":"Replace Request",
 "reason":"My card is damaged "
}

{
  "opstatus":0,
  "httpStatusCode":0,
  "updatedRecords":1
}

This API allows the user to unlock the card.

Custom Verb (unlockCard)

/services/data/v1/RBObjects/operations/Cards/unlockCard

Authorized App User

X-Kony-Authorization

Parameters

cardId (Mandatory)

Specifies the unique ID card of the card.

Action (Mandatory)

Specifies the action on the card – Activate

{ 
 "cardId":"346",
 "Action":"Activate"
}

{
  "opstatus":0,
  "httpStatusCode":0,
  "updatedRecords":1
}

This API allows the user to activate new card or replace the existing card.

Custom Verb

services/data/v1/RBObjects/operations/Cards/activateCards

Authorized App User

This API allows the user to apply for a new debit card in the cards flow.

Custom Verb (applyForDebitCard)

{{URL}}/services/data/v1/RBObjects/operations/Cards/applyForDebitCard

Authorized App User

X-Kony-Authorization

None

Parameters

/pinNumber

Specifies the PIN.

/accountId

Specifies the unique ID of the user.

/cardProductName

Specifies the product name of the card.

/withdrawlLimit

Specifies the range of limits for the withdrawing through the card.

/withdrawalMinLimit

Specifies the lower limit for withdrawing through the card.

/withdrawalMaxLimit

Specifies the upper limit for withdrawing through the card.

/purchaseLimit

Specifies the range for limits for the purchases.

/purchaseMinLimit

Specifies the lower limit for the purchases.

/purchaseMaxLimit

Specifies the upper limit for the purchases.

/bankName

Specifies the name of the bank.

/cardHolderName

Specifies the name of the card holder.

/currentBalance

Specifies the current balance in the account.

/availableBalance

Specifies the available balance in the account.

/currencyCode

Specifies the currency code (Example: USD).

/cardDisplayName

Specifies the display name of the card

/billingAddress

Specifies the billing address for the card.

/AccountType

Specifies the type of account.

{
   "pinNumber":"3471",
   "accountId":"200128223242830",
   "cardProductName":"jkhjk",
   "withdrawlLimit":"$10000",
   "withdrawalMinLimit":"$100",
   "withdrawalMaxLimit":"$10000",
   "withdrawalStepLimit":"$10000",
   "purchaseLimit":"$10000",
   "purchaseMinLimit":"$10000",
   "purchaseMaxLimit":"$10000",
   "bankName":"kyc",
   "cardHolderName":"alex",
   "currentBalance":"$44455",
   "availableBalance":"$444",
   "currencyCode":"usd",
   "cardDisplayName":"alex",
   "billingAddress":"usd fgjk jh",
   "AccountType":"Savings"
}

• Error Code: 10240
  Error Message: Invalid parameters please give valid details.
• Error Code: 12000
  Error Message: Internal service error

This API allows the user to update the withdrawal limit on the card.

Custom Verb

services/data/v1/RBObjects/operations/Cards/updateWithdrawalLimit

Authorized App User

This API allows the user to update the purchasing limit on the card.

Custom Verb

services/data/v1/RBObjects/operations/Cards/updatePurchaseLimit

Authorized App User