Multi-currency Card Purse to Purse Transfer – Function PurseFundsTransfer
Converts and transfers funds between purses within 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 Purse identifications are passed to this function as either the card account’s PAN or the Cardholder ID alternate identifier (ALTID FLAG = H).
The amount specified will be in the currency of the FROM Purse. That amount will be deducted from the FROM Purse. The amount after currency conversion will be moved into the TO Purse.
| Inputs | Description | Required | Data Type |
|---|---|---|---|
| FunctionID | PurseFundsTransfer | Y | |
| P1 | PAN OR ALT ID ’H’ for FROM purse | Y | (12…24) Alphanumeric |
| P2 | Amouont | Y | Numeric |
| P3 | PAN OR ALT ID ’H’ for TO purse | 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 “transferinfo” node; otherwise, it will not. | Y |
Example: PurseFundsTransfer Request
https://api.m2fin.com:9000/AuthENGINAPI/AuthENGINAPI?CID=5&CUSR=myuserid&CPWD=mypassword&FUNC=PurseFundsTransfer&MSGID=00005539228226466&P1=H301420041023&P2=200&P3=H301420041023EUR
Example: PurseFundsTransfer Response
<?xml version=”1.0”?>
<api func=”PurseFundsTransfer”>
<api func=”PurseFundsTransfer”>
<p1 errnumber=”000″ errdescription=”” />
<transferinfo>
<transferinfo>
<from>
<id>identifier</id>
<currency>XXX</currency>
<amount>99999</amount>
<fee>XXX</fee>
<currency>XXX</currency>
<amount>99999</amount>
<fee>XXX</fee>
</from>
<to>
<to>
<id>identifier</id>
<currency>XXX</currency>
<currency>XXX</currency>