Create Wallet for Existing Cardholder – Function CreateCardholderWallet
Creates a financial Wallet for an existing Cardholder. The Card/Account supplied to this function will become the default purse for this multi-currency Card within the Wallet. The existing Card’s Program/Binclient currency will become the currency type of this default purse. Additional purse accounts denominated in other currencies may be created and associated with this Card in the Wallet via the Wallet API function CreateCardPurse.
The Cardholder identification is passed to this function as either the PAN or the Cardholder ID alternate identifier (ALTID FLAG = H). This Card must have previously been assigned to the Cardholder via either the CardAPI function Instant Card Issue or Assign Card to Cardholder.
Optionally the caller may specify the Wallet ID to be assigned. If omitted the existing Cardholder ID will be used as the Wallet ID. The wallet creation requires that the cardholder have a Date of Birth on record. The API username must be 12 or fewer characters.
| Inputs | Description | Required | Data Type |
|---|---|---|---|
| FunctionID | CreateCardholderWallet | Y | |
| P1 | PAN OR ALT ID ’H’ | Y | (12…24) Alphanumeric |
| P2 | Wallet ID to assign | N | (12…24) Alphanumeric |
| Output | Description | ||
| P1 | Error Code | Y | |
| P2 | Error Text | Y | |
| P3 | Wallet ID Assigned | Y |
CID=5&CUSR=myuserid&CPWD=mypassword&FUNC=CreateCardholderWallet&MSGID=0000
5539228226466&P1=H301420041023
P1=000&P2=Wallet Create Successful&P3=301420041023