Perso Card Shipping API
Headers
Request Body Parameters
| Parameters | Parameter description with validations | Sample | Data type | Mandatory/Optional |
| issuanceCategory | Issuance Category.PM-Program managed issuance, CORPORATE –Corporate issuance, RETAIL– Retail issuance. | "RETAIL" | String | Mandatory |
| recipientName | Name of the card recipient. | “RAVIFINTECH” | String | Mandatory when issuanceCategory is “PM” or ”CORPORATE” |
| address1 | Primary shipping address | "BBSR,ODISHA" | String | Mandatory |
| address2 | Secondary address line (apartment, suite, landmark, or additional details | "BBSR,ODISHA" | String | Mandatory |
| city | City of the shipping address | “Puri” | String | Mandatory |
| state | State of the shipping address | “Odisha” | String | Mandatory |
| pinCode | Pin code of the shipping address | “752030” | String | Mandatory |
| country | Country name of the shipping address | “India” | String | Mandatory |
| latLong | Latitude and Longitude of the shipping address | “18.9581934,72.8320729” | String | Mandatory |
| channel | Source channel through which the request was made. It can be either 'ANDROID' or 'WEB'. | “WEB” | String | Mandatory |
| persoData | It contains the personalization data. | It will be array of object | Array of Object | Mandatory |
| cardrefNo | Card reference number which is assigned to the customer. | “1500006845” | String | Mandatory |
| mobileNumber | Mobile number of the customer | “9876567878” | String | Mandatory |
| embossName | Name to be printed(embossed) on the card | “Himanshu” | String | Mandatory |
| deviceId | Device ID- Unique identifier of the requesting device | “abce234” | String | Mandatory if channel is “ANDROID” |
Sample Request Body
Response Body Parameters
| Parameters | Description | Data type |
| data | Fetched Data | Object |
| cardRefFailedResult | Signifies a FAILED Result. | Array |
| cardRefSuccessResult | Signifies a SUCCESS Result. | Array |
| CardRefNo | Card Reference Number (of the concerned card) | String |
| statusDesc | Status Description of the performed operation. | String |
| statusCode | Status Code(0/1) | String |
| statusDesc | Status Description of Status | String |
| status | SUCCESS/FAILED | String |
Sample Response Body
SUCCESS:
FAILED:
If card is not mapped to the customer.
Detailed Status Codes
| Status | Response Type | Description |
| 0 | SUCCESS | Card Shipped Successfully |
| 1 | FAILED | Card Shipping Failed |