Retrieve Card Purse Identification from Wallet – Function GetCardPurses
Retrieves purse account identification for an existing multi-currency Card. The multi-currency Card must have previously been assigned to a Wallet using the CardAPI function CreateCardholderWallet, and purses other than the default created and assigned using the CreateCardPurse function.
The Cardholder identification is passed to this function as either the PAN or the Cardholder ID alternate identifier (ALTID FLAG = H).
The Cardholder ID assigned to each of the purse accounts will be returned in the response along with the three- character alphanumeric currency code for each account. Every multi-currency card has a default purse associated with the Card as an account established under the Card’s Program/Binclient. Additional purses (established via the CreateCardPurse function) are 9-bin accounts setup under the Binclient defined for their specific currency type.
The identifiers returned for each purse may be used for subsequent CardAPI transactions such as inquiries, loads or purse transfers.
| Inputs | Description | Required | Data Type |
|---|---|---|---|
| FunctionID | GetCardPurses | Y | |
| P1 | PAN OR ALT ID ’H’ | Y | (12…24) Alphanumeric |
| Output | Description | ||
| XML | The data will be passed back in a well-formed XML document. The error code processing will be contained in the P1 node that contains two attributes: errnumber and errdescription. Therefore, if the errnumber attribute is equal to “000” the document will contain a “cardinfo” node; otherwise, it will not. |
Y |
<api func=”GetCardPurses”>
<cardinfo id=”cardholderid”>
<?xml version=”1.0”?>
<api func=”GetCardPurses”>
<cardinfo id=”301420041023″>