put https://uatmea-iss-apigw.creditpluspinelabs.com/deviceapi/apis/devices/statuses
The Delivery Confirmation API is used to confirm the delivery of card to the cardholder. The transactions for instant card delivery, where physical or digital products are opted at institutional level, will work only if this API is successful. The Delivery Confirmation API can only be called afterthe Request Embossing API or Get Embossing API is processed. The API request is encrypted. Refer to the Message Level Security - AES Encryption section in the CR+ REST API Security Requirements attachment document for detailed information on encryption of JSON payload. It is applicable for instant cards of prepaid, credit, and debit products issued on Pine Labs platform.
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.
- Description: This is the description of the error code returned by Credit+ Issuing application.
- Details: This is the detailed description of the error code returned by Credit+ Issuing application
| HTTP Code | Error Code | Description | Details |
|---|---|---|---|
| 200 | OK | The server has successfully processed your request. | |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'mobile.number' | 'Mobile number' field is mandatory when only last 4 digits of device number are provided. |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'mobile.isdCode' | 'ISD Code' field is mandatory when only last 4 digit of device number are provided. |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'device.number', 'device.packID' | At least one field must be present - 'deviceNumber', 'packID'. |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'device.delivery'. | Missing Required Field 'device.delivery'. |
| 400 | MISSING_REQUIRED_FIELD | Missing Required Field 'ProductType'. | Missing Required Field 'ProductType'. |
| 400 | RECORD_NOT_FOUND | Record not found for given search criteria(s) - ''. | Device linked to 'device.number' : XXXX<LAST 4 Digits of DeviceNumber> not found. |
| 400 | RECORD_NOT_FOUND | Delivery confirmation cannot be processed as embossing is not completed. | |
| 400 | RECORD_NOT_FOUND | Delivery confirmation not received. | |
| 400 | RECORD_NOT_FOUND | Device Production Batch is not executed for the card. | |
| 400 | RECORD_NOT_FOUND | Delivery Confirmation cannot be processed for devices other than normal status. | |
| 400 | TIMESTAMP_ERROR | Request timestamp is in past. | Request timestamp of '<"dataValidUntilTimestamp">' field value '' is in past. |
| 400 | ERR_CODE_INVALID_FIELD_FORMAT | Invalid Field Value 'dataValidUntilTimestamp'. | dataValidUntilTimestamp field must be in ISO 8601 format. |
| 400 | ERR_DB_PROC | Error inside PRC_INST_DEVICE_DELIVERY_CONF | |
| 403 | AUTHORIZATION_ERROR | User in not authorized to access requested resource. | |
| 409 | RESOURCE_ALREADY_EXISTS | Delivery confirmation already received. | |
| 500 | SYSTEM_ERROR | An unexpected error has occurred with the service you have requested. |