SetAutoPay
This API is used to set auto pay. Setting up a subscriber on AutoPay will charge the subscriber card automatically on the expiration date.
Sample Request
<?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> <USERNAME>Vcarecorporation</USERNAME> <PASSWORD>Vcarecorporation</PASSWORD> <PIN>Vcarecorporation</PIN> <REFERENCENUMBER>11111</REFERENCENUMBER> </CREDENTIALS> <VCAREOSS> <SETAUTOPAY> <PAYMENTTYPE></PAYMENTTYPE> <CUSTOMERID></CUSTOMERID> <PLANID></PLANID> <AUTOPAYTYPE></AUTOPAYTYPE> <COMPANYID></COMPANYID> <CHARGELIMIT></CHARGELIMIT> <-! for CREDIT_CARD payment method -> <CARDTYPE></CARDTYPE> <CARDVALUE></CARDVALUE> <CARDCODE></CARDCODE> <EXPIRATION_MONTH></EXPIRATION_MONTH> <EXPIRATION_YEAR></EXPIRATION_YEAR> <NAMEONCARD></NAMEONCARD> <BILLINGSTATE></BILLINGSTATE> <BILLINGADDRESS></BILLINGADDRESS> <BILLINGADDRESS2></BILLINGADDRESS2> <BILLINGCITY></BILLINGCITY> <BILLINGZIPCODE></BILLINGZIPCODE> <AGENTID></AGENTID> <AGENTPASSWORD></AGENTPASSWORD> <SOURCE></SOURCE> </SETAUTOPAY> </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. |
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. |
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. |
109 | Credit Card Number is required. | Credit card number cannot be blank. You should enter a valid Credit card number. |
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. |
120 | Billing Address is required. | Billing address cannot be blank. You should enter a valid billing address. |
128 | Plan Code is required. | Plan code cannot be blank. You should enter a valid plan code. |
129 | Plan Code is incorrect. | Please provide correct plan code. |
130 | Invalid Company ID. | Please provide valid company id. |
168 | Invalid Amount. | Please provide a valid Amount. |
169 | Company ID is required. | Please provide company ID. |
215 | Invalid Card Details. | Please provide a valid Card Details. |
220 | Card code is required. | Please provide Card code. |
288 | Updated OR Created by user ID not found. | Updated OR Created by user ID not found. |
344 | Auto Pay already set for selected customer. | Auto Pay already set for selected customer. |
356 | Agent ID cannot be blank. | Please provide Agent ID as it cannot be blank. |
457 | Invalid Source. | Please provide a valid Source. Given value is invalid for Source. |
577 | Set Auto Pay type is invalid. | Please provide a valid Set Auto Pay type. Given value is invalid for Set Auto Pay type. |
578 | Set Auto Pay type is required. | Provide a Set Auto Pay type. Set Auto Pay type is mandatory. |
Sample Response
<?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> <SetAutoPay> <statusCode>00</statusCode> <description>SUCCESS</description> <errorDescription>SUCCESS</errorDescription> <transactionid></transactionid> <SetAutoPay> </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> <SetAutoPay> <statusCode>01</statusCode> <description>FAIL</description> <errorDescription>Error Received from Carrier.</errorDescription> </SetAutoPay> </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> <SetAutoPay> <statusCode>13</statusCode> <description>FAIL</description> <errorDescription>Password is invalid.</errorDescription> </SetAutoPay> </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> <SetAutoPay> <statusCode>15</statusCode> <description>FAIL</description> <errorDescription>Zip code is invalid.</errorDescription> </SetAutoPay> </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> <SetAutoPay> <statusCode>16</statusCode> <description>FAIL</description> <errorDescription>Vendor not found. Wrong credentials.</errorDescription> </SetAutoPay> </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> <SetAutoPay> <statusCode>21</statusCode> <description>FAIL</description> <errorDescription>Invalid State.</errorDescription> </SetAutoPay> </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> <SetAutoPay> <statusCode>25</statusCode> <description>FAIL</description> <errorDescription>Customer ID is invalid.</errorDescription> </SetAutoPay> </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> <SetAutoPay> <statusCode>72</statusCode> <description>FAIL</description> <errorDescription>Invalid City.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Invalid City.
How to Resolve?: Please provide valid City.
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> <SetAutoPay> <statusCode>102</statusCode> <description>FAIL</description> <errorDescription>Card type is required.</errorDescription> </SetAutoPay> </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: 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> <SetAutoPay> <statusCode>105</statusCode> <description>FAIL</description> <errorDescription>Expiry Month is required.</errorDescription> </SetAutoPay> </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: 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> <SetAutoPay> <statusCode>107</statusCode> <description>FAIL</description> <errorDescription>Expiry Year is required.</errorDescription> </SetAutoPay> </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: 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> <SetAutoPay> <statusCode>109</statusCode> <description>FAIL</description> <errorDescription>Credit Card Number is required.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Credit Card Number is required.
How to Resolve?: Credit card number cannot be blank. You should enter a valid Credit card number.
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> <SetAutoPay> <statusCode>110</statusCode> <description>FAIL</description> <errorDescription>Card Name is required.</errorDescription> </SetAutoPay> </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: 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> <SetAutoPay> <statusCode>111</statusCode> <description>FAIL</description> <errorDescription>Name on Card is invalid.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Name on Card is invalid.
How to Resolve?: Please provide a valid Name on Card.
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> <SetAutoPay> <statusCode>113</statusCode> <description>FAIL</description> <errorDescription>Zip Code is required.</errorDescription> </SetAutoPay> </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: 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> <SetAutoPay> <statusCode>116</statusCode> <description>FAIL</description> <errorDescription>City is required.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: City is required.
How to Resolve?: City cannot be blank. You should enter a valid City.
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> <SetAutoPay> <statusCode>118</statusCode> <description>FAIL</description> <errorDescription>State is required.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: State is required.
How to Resolve?: State cannot be blank. You should enter a valid State.
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> <SetAutoPay> <statusCode>120</statusCode> <description>FAIL</description> <errorDescription>Billing Address is required.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Billing Address is required.
How to Resolve?: Billing address cannot be blank. You should enter a valid billing address.
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> <SetAutoPay> <statusCode>128</statusCode> <description>FAIL</description> <errorDescription>Plan Code is required.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Plan Code is required.
How to Resolve?: Plan code cannot be blank. You should enter a valid plan code.
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> <SetAutoPay> <statusCode>129</statusCode> <description>FAIL</description> <errorDescription>Plan Code is incorrect.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Plan Code is incorrect.
How to Resolve?: Please provide correct plan code.
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> <SetAutoPay> <statusCode>130</statusCode> <description>FAIL</description> <errorDescription>Invalid Company ID.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Invalid Company ID.
How to Resolve?: Please provide valid company id.
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> <SetAutoPay> <statusCode>168</statusCode> <description>FAIL</description> <errorDescription>Invalid Amount.</errorDescription> </SetAutoPay> </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> <SetAutoPay> <statusCode>169</statusCode> <description>FAIL</description> <errorDescription>Company ID is required.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Company ID is required.
How to Resolve?: Please provide company ID.
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> <SetAutoPay> <statusCode>215</statusCode> <description>FAIL</description> <errorDescription>Invalid Card Details.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Invalid Card Details.
How to Resolve?: Please provide a valid Card Details.
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> <SetAutoPay> <statusCode>220</statusCode> <description>FAIL</description> <errorDescription>Card code is required.</errorDescription> </SetAutoPay> </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> <SetAutoPay> <statusCode>288</statusCode> <description>FAIL</description> <errorDescription>Updated OR Created by user ID not found.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Updated OR Created by user ID not found.
How to Resolve?: Updated OR Created by user ID not found.
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> <SetAutoPay> <statusCode>344</statusCode> <description>FAIL</description> <errorDescription>Auto Pay already set for selected customer.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Auto Pay already set for selected customer.
How to Resolve?: Auto Pay already set for selected customer.
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> <SetAutoPay> <statusCode>356</statusCode> <description>FAIL</description> <errorDescription>Agent ID cannot be blank.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Agent ID cannot be blank.
How to Resolve?: Please provide Agent ID as it cannot be blank.
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> <SetAutoPay> <statusCode>457</statusCode> <description>FAIL</description> <errorDescription>Invalid Source.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Invalid Source.
How to Resolve?: Please provide a valid Source. Given value is invalid for Source.
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> <SetAutoPay> <statusCode>577</statusCode> <description>FAIL</description> <errorDescription>Set Auto Pay type is invalid.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Set Auto Pay type is invalid.
How to Resolve?: Please provide a valid Set Auto Pay type. Given value is invalid for Set Auto Pay type.
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> <SetAutoPay> <statusCode>578</statusCode> <description>FAIL</description> <errorDescription>Set Auto Pay type is required.</errorDescription> </SetAutoPay> </VcareOssApi>
Error Description: Set Auto Pay type is required.
How to Resolve?: Provide a Set Auto Pay type. Set Auto Pay type is mandatory.
All the status codes are listed under the status code sections. Please click here to go to the status code.