AddWallet

This XML API used to debit and credit in/out of the customer's wallet

End Point https://www.vcareapi.com/vcareOssApi/AddWallet/
Field (Short Description) Value/Tag Name Format Field Example Type Notes Validation rules
VENDOR ID string Vcarecorporation Required A unique Vendor ID is associated with the MVNO/OSS partner. This is used for authorization purpose and can be obtained by contacting your account manager.
USER NAME string Vcarecorporation Required A unique User name is associated with the MVNO/OSS partner. This is used for authorization purpose and can be obtained by contacting your account manager.
PASSWORD string Vcarecorporation Required This is a random string which is generated by Vcare and is tied to the MVNO/OSS user name. This is specifically used for authentication purpose and can be obtained by contacting your account manager.
PIN string 123456789 Required This is generated by Vcare to provide an additional layer of security in the Interim API. This is used for authentication purpose and can be obtained by contacting your account manager.
REFERENCENUMBER string 123456789 Required Auto generated unique reference number is required to be passed with each transaction.
AMOUNT string 20 Required This is the amount on which you want to calculate the tax and want the tax break up  
TAX REQUIRED string Y Optional This defines whether the AMOUNT is inclusive of taxes or not. Y will indicate that system needs to charge tax. Telgoo5 will calculate the tax amount on top of the AMOUNT value passed. N will indicate that either MVNO would not like to charge tax or AMOUNT includes tax. MVNO can use another API called GetTaxDetails to get the Tax amount. This will charge taxes only of the payment type is CREDITCARD or CASH. Y or N
MDN string 1234569870 Required
CUSTOMER ID Numeric 1234569870 Optional CUSTOMERID Require Only Source type POS
PAYMENT TYPE string CASH Required This determines how is the payment take to add money in wallet PIN,CASH,SKIP PAYMENT or CREDITCARD
PIN NUMBER string 12365478965412300 Conditional This is the PIN number, if you sell out PIN. This is required if paymenttype is PIN MIN =8, MAX=25 chars
CARD NUMBER string 4111111111111110 Conditional This is the card number Max=16 digits. if payment type not cash then required
CARD TYPE string VISA Conditional This is the type of the card. This is required if the payment type is CREDITCARD. if payment type not cash then required VISA,MASTERCARD,DISCOVER,AMERICAN EXPRESS
EXPIRATION MONTH string 11 Conditional This is the expiration month of the card.This is required if the payment type is CREDITCARD if payment type not cash then required
EXPIRATION YEAR string 2018 Conditional This is the expiration year of the card.This is required if the payment type is CREDITCARD if payment type not cash then required
CARDCODE string 23423 Conditional if payment type not cash then required
NAME ON CARD string John Doe Conditional This is the name on the card.This is required if the payment type is CREDITCARD if payment type not cash then required
DEBIT CREDIT string CR or DR Required This determines if the amount needs to be Credited or Debited "CR for Credit/adding money in wallet DR for Debit/taking money out of wallet"
ADDRESS string street 2 Optional If empty get value using MDN
ADDRESS2 string street 2 Optional If empty get value using MDN
CITY string street 2 Optional If empty get value using MDN
STATE string street 2 Optional If empty get value using MDN
ZIPCODE string street 2 Optional If empty get value using MDN
SOURCE string API Optional Source of the order/application Expected Value:API, TABLET, IVR, WEBSITE, POS, CUSTOMERPORTAL
AGENT ID string John Doe Required This is the Telgoo5 user id.For the Agent/Employee who is sending the API request.
AGENT PASSWORD string JohnDoe Conditional This is the password for the Agent Id mentioned above. This is configuration level field. If you have set the permissions for the Agent Id for the requirement of the password in API transactions then you will need to pass the Agent Password in all the XML API transaction, else if you have set the permissions to password not required then you don't need to pass the Agent Password in the XML API.
Sample Request XML
<?xml version="1.0" encoding="utf-8"?>
<VCAREOSSAPI xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<CREDENTIALS>
 <vendorId></vendorId>
 <username></username>
 <password></password>
 <pin></pin>
<REFERENCENUMBER></REFERENCENUMBER>
</CREDENTIALS>
<VCAREOSS>
<ADDWALLET>
<AMOUNT></AMOUNT>
<TAXREQUIRED></TAXREQUIRED>
<MDN></MDN>
<CUSTOMERID></CUSTOMERID>
<!-- CUSTOMERID Require Only Source type POS-->
<DEBITCREDIT></DEBITCREDIT>
<!-- DEBITCREDIT should be CR OR DR -->
<PAYMENTTYPE></PAYMENTTYPE>
<!-- PAYMENTTYPE should be PIN CASH,SKIP PAYMENT or CREDITCARD -->
<PINNUMBER></PINNUMBER>
<CARDNUMBER></CARDNUMBER>
<CARDTYPE></CARDTYPE>
<EXPIRATION_MONTH></EXPIRATION_MONTH>
<EXPIRATION_YEAR></EXPIRATION_YEAR>
<CARDCODE></CARDCODE>
<NAMECARD></NAMECARD>
<ADDRESS></ADDRESS>
<ADDRESS2></ADDRESS2>
<CITY></CITY>
<STATE></STATE>
<ZIPCODE></ZIPCODE>
<AGENTID></AGENTID>
<AGENTPASSWORD></AGENTPASSWORD>
<SOURCE></SOURCE>
</ADDWALLET>
</VCAREOSS>
</VCAREOSSAPI>
List of status code, description and resolution.
Status Code Description How to Resolve?
00 SUCCESS SUCCESS
01 Error Received from Carrier. Please try again with valid data.
13 Password is invalid. Provide a valid Password.
15 Zip code is invalid. Please enter valid zip code.
16 Vendor not found. Wrong credentials. Please enter valid vendor credentials.
21 Invalid State. Provide a valid State
25 Customer ID is invalid. Provide a valid Customer ID.
71 Invalid OR empty address. Please provide a valid address.
72 Invalid City. Please provide valid City.
102 Card type is required. Card Type can not be blank. You should enter a valid Card Type.
104 Credit Card Number is not valid. Please provide a valid Credit Card.
105 Expiry Month is required. Expiry month cannot be blank. You should enter a valid expire month.
107 Expiry Year is required. Expire year cannot be blank. You should enter a valid expire year.
108 Expiry Year is not valid. Please provide a valid Expire Year.
110 Card Name is required. Card name cannot be blank. You should enter a valid Card name.
111 Name on Card is invalid. Please provide a valid Name on Card.
113 Zip Code is required. Zip code cannot be blank. You should enter a valid Zip code.
116 City is required. City cannot be blank. You should enter a valid City.
118 State is required. State cannot be blank. You should enter a valid State.
126 Invalid MDN. Please provide valid MDN.
146 MDN should not be empty. Please provide MDN.
168 Invalid Amount. Please provide a valid Amount.
179 Amount should not be blank OR zero. Please provide amount. Amount cannot be left blank OR zero.
219 Payment type is required. Please provide Payment type.
220 Card code is required. Please provide Card code.
226 Customer ID is required. Please provide Customer ID.
356 Agent ID cannot be blank. Please provide Agent ID as it cannot be blank.
431 Wallet balance is low. Wallet balance is low.
436 PIN Number should not be blank. PIN number can not be blank. You should enter a valid PIN number.
437 Invalid PIN Number. Invalid PIN Number. You should enter a valid PIN number.
438 Card Number is required. Card number can not be blank. Card number is required.
439 Card type should be VISA, MASTERCARD, DISCOVER, AMERICAN EXPRESS. Enter correct Card Type. Card type should be VISA, MASTERCARD, DISCOVER, AMERICAN EXPRESS.
440 Card code is invalid. Enter valid card code. Card code is not valid.
441 Your card has expired. Enter valid card Expiry Date. Card has been expired.
443 Debit credit should not be blank. PIN number can not be blank. You should enter a valid PIN number.
444 Debit credit should be CR, DR. Debit credit value must be CR, DR.
445 Payment type Should be PIN, CASH, CREDITCARD, SKIP PAYMENT. Choose Payment type among PIN, CASH, CREDITCARD, SKIP PAYMENT. Payment type Should be PIN, CASH, CREDITCARD, SKIP PAYMENT.
446 Month should be in two digits from 01 to 12. Month should contain 2 digits and should be between 01 to 12. Month can not less than 01 and more than 12.
457 Invalid Source. Please provide a valid Source. Given value is invalid for Source.
516 MDN is invalid OR account status not Active, Suspend, Dispatched. Provide correct MDN. MDN is invalid OR account status not Active, Suspend, Dispatched.
701 PIN Number should be greater than 8 and less than 25 digits. Enter a correct PIN Number. PIN Number should be greater than 8 and less than 25 digits.
Sample Response XML
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <credentials>
        <vendorId></vendorId>
        <referenceNumber></referenceNumber>
    </credentials>
    <AddWallet>
		<transactiond></transactiond>
		<statusCode>00</statusCode>
		<description>SUCCESS</description>
		<errorDescription>SUCCESS</errorDescription>
		<transactionid>132131</transactionid>
		<amountIncludingtax></amountIncludingtax>
    </AddWallet>
</VcareOssApi>
SUCCESS.
Sample Fail Response: 1
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>01</statusCode>
	<description>FAIL</description>
	<errorDescription>Error Received from Carrier.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Error Received from Carrier.
How to Resolve?: Please try again with valid data.
Sample Fail Response: 2
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>13</statusCode>
	<description>FAIL</description>
	<errorDescription>Password is invalid.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Password is invalid.
How to Resolve?: Provide a valid Password.
Sample Fail Response: 3
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>15</statusCode>
	<description>FAIL</description>
	<errorDescription>Zip code is invalid.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Zip code is invalid.
How to Resolve?: Please enter valid zip code.
Sample Fail Response: 4
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>16</statusCode>
	<description>FAIL</description>
	<errorDescription>Vendor not found. Wrong credentials.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Vendor not found. Wrong credentials.
How to Resolve?: Please enter valid vendor credentials.
Sample Fail Response: 5
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>21</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid State.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Invalid State.
How to Resolve?: Provide a valid State
Sample Fail Response: 6
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>25</statusCode>
	<description>FAIL</description>
	<errorDescription>Customer ID is invalid.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Customer ID is invalid.
How to Resolve?: Provide a valid Customer ID.
Sample Fail Response: 7
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>71</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid OR empty address.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Invalid OR empty address.
How to Resolve?: Please provide a valid address.
Sample Fail Response: 8
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>72</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid City.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Invalid City.
How to Resolve?: Please provide valid City.
Sample Fail Response: 9
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>102</statusCode>
	<description>FAIL</description>
	<errorDescription>Card type is required.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Card type is required.
How to Resolve?: Card Type can not be blank. You should enter a valid Card Type.
Sample Fail Response: 10
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>104</statusCode>
	<description>FAIL</description>
	<errorDescription>Credit Card Number is not valid.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Credit Card Number is not valid.
How to Resolve?: Please provide a valid Credit Card.
Sample Fail Response: 11
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>105</statusCode>
	<description>FAIL</description>
	<errorDescription>Expiry Month is required.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Expiry Month is required.
How to Resolve?: Expiry month cannot be blank. You should enter a valid expire month.
Sample Fail Response: 12
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>107</statusCode>
	<description>FAIL</description>
	<errorDescription>Expiry Year is required.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Expiry Year is required.
How to Resolve?: Expire year cannot be blank. You should enter a valid expire year.
Sample Fail Response: 13
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>108</statusCode>
	<description>FAIL</description>
	<errorDescription>Expiry Year is not valid.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Expiry Year is not valid.
How to Resolve?: Please provide a valid Expire Year.
Sample Fail Response: 14
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>110</statusCode>
	<description>FAIL</description>
	<errorDescription>Card Name is required.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Card Name is required.
How to Resolve?: Card name cannot be blank. You should enter a valid Card name.
Sample Fail Response: 15
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>111</statusCode>
	<description>FAIL</description>
	<errorDescription>Name on Card is invalid.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Name on Card is invalid.
How to Resolve?: Please provide a valid Name on Card.
Sample Fail Response: 16
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>113</statusCode>
	<description>FAIL</description>
	<errorDescription>Zip Code is required.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Zip Code is required.
How to Resolve?: Zip code cannot be blank. You should enter a valid Zip code.
Sample Fail Response: 17
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>116</statusCode>
	<description>FAIL</description>
	<errorDescription>City is required.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: City is required.
How to Resolve?: City cannot be blank. You should enter a valid City.
Sample Fail Response: 18
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>118</statusCode>
	<description>FAIL</description>
	<errorDescription>State is required.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: State is required.
How to Resolve?: State cannot be blank. You should enter a valid State.
Sample Fail Response: 19
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>126</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid MDN.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Invalid MDN.
How to Resolve?: Please provide valid MDN.
Sample Fail Response: 20
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>146</statusCode>
	<description>FAIL</description>
	<errorDescription>MDN should not be empty.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: MDN should not be empty.
How to Resolve?: Please provide MDN.
Sample Fail Response: 21
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>168</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid Amount.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Invalid Amount.
How to Resolve?: Please provide a valid Amount.
Sample Fail Response: 22
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>179</statusCode>
	<description>FAIL</description>
	<errorDescription>Amount should not be blank OR zero.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Amount should not be blank OR zero.
How to Resolve?: Please provide amount. Amount cannot be left blank OR zero.
Sample Fail Response: 23
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>219</statusCode>
	<description>FAIL</description>
	<errorDescription>Payment type is required.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Payment type is required.
How to Resolve?: Please provide Payment type.
Sample Fail Response: 24
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>220</statusCode>
	<description>FAIL</description>
	<errorDescription>Card code is required.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Card code is required.
How to Resolve?: Please provide Card code.
Sample Fail Response: 25
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>226</statusCode>
	<description>FAIL</description>
	<errorDescription>Customer ID is required.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Customer ID is required.
How to Resolve?: Please provide Customer ID.
Sample Fail Response: 26
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>356</statusCode>
	<description>FAIL</description>
	<errorDescription>Agent ID cannot be blank.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Agent ID cannot be blank.
How to Resolve?: Please provide Agent ID as it cannot be blank.
Sample Fail Response: 27
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>431</statusCode>
	<description>FAIL</description>
	<errorDescription>Wallet balance is low.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Wallet balance is low.
How to Resolve?: Wallet balance is low.
Sample Fail Response: 28
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>436</statusCode>
	<description>FAIL</description>
	<errorDescription>PIN Number should not be blank.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: PIN Number should not be blank.
How to Resolve?: PIN number can not be blank. You should enter a valid PIN number.
Sample Fail Response: 29
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>437</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid PIN Number.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Invalid PIN Number.
How to Resolve?: Invalid PIN Number. You should enter a valid PIN number.
Sample Fail Response: 30
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>438</statusCode>
	<description>FAIL</description>
	<errorDescription>Card Number is required.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Card Number is required.
How to Resolve?: Card number can not be blank. Card number is required.
Sample Fail Response: 31
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>439</statusCode>
	<description>FAIL</description>
	<errorDescription>Card type should be VISA, MASTERCARD, DISCOVER, AMERICAN EXPRESS.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Card type should be VISA, MASTERCARD, DISCOVER, AMERICAN EXPRESS.
How to Resolve?: Enter correct Card Type. Card type should be VISA, MASTERCARD, DISCOVER, AMERICAN EXPRESS.
Sample Fail Response: 32
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>440</statusCode>
	<description>FAIL</description>
	<errorDescription>Card code is invalid.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Card code is invalid.
How to Resolve?: Enter valid card code. Card code is not valid.
Sample Fail Response: 33
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>441</statusCode>
	<description>FAIL</description>
	<errorDescription>Your card has expired.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Your card has expired.
How to Resolve?: Enter valid card Expiry Date. Card has been expired.
Sample Fail Response: 34
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>443</statusCode>
	<description>FAIL</description>
	<errorDescription>Debit credit should not be blank.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Debit credit should not be blank.
How to Resolve?: PIN number can not be blank. You should enter a valid PIN number.
Sample Fail Response: 35
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>444</statusCode>
	<description>FAIL</description>
	<errorDescription>Debit credit should be CR, DR.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Debit credit should be CR, DR.
How to Resolve?: Debit credit value must be CR, DR.
Sample Fail Response: 36
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>445</statusCode>
	<description>FAIL</description>
	<errorDescription>Payment type Should be PIN, CASH, CREDITCARD, SKIP PAYMENT.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Payment type Should be PIN, CASH, CREDITCARD, SKIP PAYMENT.
How to Resolve?: Choose Payment type among PIN, CASH, CREDITCARD, SKIP PAYMENT. Payment type Should be PIN, CASH, CREDITCARD, SKIP PAYMENT.
Sample Fail Response: 37
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>446</statusCode>
	<description>FAIL</description>
	<errorDescription>Month should be in two digits from 01 to 12.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Month should be in two digits from 01 to 12.
How to Resolve?: Month should contain 2 digits and should be between 01 to 12. Month can not less than 01 and more than 12.
Sample Fail Response: 38
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>457</statusCode>
	<description>FAIL</description>
	<errorDescription>Invalid Source.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: Invalid Source.
How to Resolve?: Please provide a valid Source. Given value is invalid for Source.
Sample Fail Response: 39
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>516</statusCode>
	<description>FAIL</description>
	<errorDescription>MDN is  invalid OR account status not Active, Suspend, Dispatched.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: MDN is invalid OR account status not Active, Suspend, Dispatched.
How to Resolve?: Provide correct MDN. MDN is invalid OR account status not Active, Suspend, Dispatched.
Sample Fail Response: 40
<?xml version="1.0" encoding="utf-8"?>
<VcareOssApi xmlns="http://www.oss.vcarecorporation.com/oss" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<credentials>
	<vendorId>Vcarecorporation</vendorId>
	<referenceNumber>11111</referenceNumber>
</credentials>
<AddWallet>
	<statusCode>701</statusCode>
	<description>FAIL</description>
	<errorDescription>PIN Number should be greater  than 8 and less than 25 digits.</errorDescription>
</AddWallet>
</VcareOssApi>
Error Description: PIN Number should be greater than 8 and less than 25 digits.
How to Resolve?: Enter a correct PIN Number. PIN Number should be greater than 8 and less than 25 digits.

All the status codes are listed under the status code sections. Please click here to go to the status code.