This API is used to link or delink a wallet number to a card number based on the respective operation's URL parameters (link or delink). This API is only applicable for debit products issued on Pine Labs platform.
Wallet Linking
The Credit+ Issuing system receives, validates and processes the request. If the request is successful, the system links the specified wallet number and the card number. Additionally, the system can also define the referenced wallet to be the default wallet of the cardholder based on the default Wallet flag. A device can be linked to a new wallet number or to an existing wallet number if that wallet number is not linked to any other device. The linking request can be made only for primary devices and not for add-on or supplementary devices. When processed for a primary device, the wallet is linked with all the associated devices (add-on or supplementary) of the primary device. If the request fails, the system returns the corresponding error code.
Wallet Delinking
The Credit+ Issuing system receives, validates and processes the request. If the request is successful, the system delinks the specified wallet number and the card number and defines the new default wallet number that has to be mandatorily provided in the request. If the request fails, the system returns the corresponding error code. The delink request can be made only for primary devices. Once it is successful, the wallet is delinked from the primary and all its associated devices; that is, supplementary and add-on devices also.
HTTP Status and Response Status Matrix
- HTTP Code: This is the response status code issued by a server in response to a client's request made to the server.
- Error Code: This is the error code returned by Credit+ Issuing application in the ‘code’ field of the response message indicating if the request was processed successfully or failed.
- Reason: This is the description of the error code returned by Credit+ Issuing application.
| HTTP Code | Error Code | Reason |
|---|---|---|
| 400 | 997 | Account type is invalid. |
| 400 | 997 | Device number is invalid. |
| 400 | 997 | Invalid Device number. It should be numeric. |
| 400 | 997 | Wallet number is invalid. |
| 400 | 997 | Invalid Wallet number. It should be numeric. |
| 400 | 997 | Default wallet value should be 'Y' or 'N'. |
| 400 | 997 | Delinking status received is invalid. |
| 400 | 990 | Channel not authenticated for this service |
| 400 | BTHCM00018 | Error Updating device |
| 400 | BTHCM00018 | Error while processing request |
| 400 | WALDLK013 | Delink wallet number and new default number should not be same |
| 400 | WALLNK001 | Invalid Device Number |
| 400 | WALLNK002 | Device is canceled or replaced |
| 400 | WALLNK003 | Wallet Number Already Linked with the device |
| 400 | WALDLK004 | New Default Wallet Number is mandatory for de-linking default wallet |
| 400 | WALDLK008 | Requested default wallet is not linked with the device |
| 400 | WALDLK006 | Invalid Product Type |
| 400 | WALDLK007 | New default wallet is not in Normalstatus |
| 400 | WALDLK005 | Wallet Number is Invalid |
| 400 | BTHCM00018 | Error occurred during Card Cancellation |
| 400 | BTHCM00018 | Other Error occurred during Card Cancellation |
| 400 | WALLNK010 | Device is not active |
| 400 | WALLNK012 | Wallet Number is already assigned with another device |
| 400 | WALLNK011 | Wallet is not in Normalstatus |
| 400 | WLNDLN005 | Log statement request failed due to an internal error. Please contact system admin |
| 400 | WLNDLN003 | Invalid request type |
| 400 | WALLNK005 | Invalid Product Type |
| 400 | WALLNK007 | Invalid wallet number length |
| 400 | WALLNK008 | Invalid Account type |
| 400 | WALDLK001 | Invalid Device Number |
| 400 | WALDLK002 | Device is canceled or replaced |
| 400 | WALDLK003 | Wallet Number Already De-Linked |
| 400 | WALLNK008 | Invalid Account type |