The Request Physical Card API fulfils the purpose of requesting a physical card on top of an existing virtual card available to the user. The API captures card identifiers and the address where the physical card shall be delivered after the printing.
Environment
| Parameter | Type | Parameter Requirement | Description |
|---|
| api-key | String (15) | Mandatory | This parameter must contain the API key. |
| token | String (360) | Mandatory | This parameter must contain the token generated using the Encrypt API. |
curl --request POST \
--url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/issuance/v1/enroll \
--header 'X-Consumer-Custom-ID: F42BC4E7B801C834B630DE498473533F' \
--header 'accept: application/json' \\
--header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
--data '
{
"token": "e3ln1sSCTF9rgy9AjN5QNAkJruloChEdm7C39FVnfczb5gfIGv"
}
'
This API will provide a token in the response that must be decrypted using the Decrypt API. The decrypted response is similar to the following:
| Parameter | Datatype | Parameter Requirement | Description |
|---|
| messageCode | numeric (4) | Conditional | Code to Identity ‘Request physical card API response |
| clientTxnId | string (100) | Conditional | Echoed from the request. |
| customerId | string(20) | conditional | Echoed from the request. |
| cardUrn | numeric(11) | Mandatory | Echoed from the request. |
| reserveField1 | string(50) | Optional | Echoed from the request. |
| reserveField2 | string(50) | Optional | Echoed from the request. |
{
"customerId": "000000000429",
"responseCode": "00",
"clientTxnId": "Req_Phy_Card04758474s291ram683",
"responseDateTime": "2024-06-19T15:19:55.620318625",
"accosaTransactionId": 4638,
"responseMessage": "SUCCESS",
"cardUrn": "10000810"
}
| Response Code | Description |
|---|
| 00 | SUCCESS |
| 1001 | Card not found |
| 1030 | INVALID MESSAGE |
| 1031 | INVALID BANK ID |
| 1032 | INVALID_CLIENT_CHANNEL |
| 1045 | UNABLE TO PROCESS REQUEST CAUSE OF UNKNOWN FIELD |
| 1049 | INVALID SECURE CODE |
| 1051 | CHECKSUM FAILURE |
| 1052 | SYSTEM_ERROR |
| 1054 | DUPLICATE REQUEST |
| 1055 | MALFORMED_REQUEST |
| 1058 | INVALID_WALLETS |
| 1080 | IP_NOT_ALLOWED |
| 1081 | OPERATION NOT ALLOWED |
| 1085 | PRODUCT NOT ALLOWED |
| 1088 | INVALID REQUEST DATE FORMAT |
| 1093 | INVALID CLIENT TXN ID |
| 1103 | Invalid transaction amount |
| 1104 | TRANSACTION AMOUNT MISMATCH |
| 1107 | SENDER CARD NOT FOUND |
| 1110 | RECEIVER CARD NOT FOUND |
| 1111 | Sender and receiver cannot be the same |
| 1262 | CLIENT ID NOT PRESENT IN THE REQUEST |
| 1264 | BANK ID NOT PRESENT IN THE REQUEST |
| 1310 | XCONSUMERKEY NOT PRESENT IN THE REQUEST |
| 1311 | SECURE CODE NOT PRESENT IN REQUEST |
| 1320 | REQUEST_DATETIME_IS_MANDATORY |
| 1501 | SYSTEM_ERROR_DB |
| 1504 | SYSTEM_CAS_FAILURE |
| 6900 | SENDER ACCOUNT NUMBER NULL OR EMPTY |
| 6901 | RECEIVER ACCOUNT NUMBER NULL OR EMPTY |
| 6902 | SENDER RECEIVER INVALID ACCOUNT NUMBER |
| 6903 | Sender URN and Customer ID both missing |
| 6904 | Receiver URN and Customer ID both missing |
| 6905 | INVALID ACCOUNT NUMBER IN REQUEST |
| 6906 | SENDER IMPL ID MISMATCH |
| 6907 | RECEIVER IMPL ID MISMATCH |
| 6908 | Customer not found |
| 6909 | SENDER CUSTOMER NOT FOUND |
| 6910 | RECEIVER CUSTOMER NOT FOUND |
| 6911 | INVALID RESERVED FIELD 1 |
| 6912 | INVALID RESERVED FIELD 2 |
| 6913 | INVALID RESERVED FIELD 3 |
| 6914 | INVALID RESERVED FIELD 4 |
| 6915 | INVALID RESERVED FIELD 5 |
| 6916 | INVALID RESERVED FIELD 6 |
| 6917 | MORE THAN ONE CUSTOMER IDENTIFIER NOT ALLOWED FOR SENDER |
| 6918 | MORE THAN ONE CUSTOMER IDENTIFIER NOT ALLOWED FOR RECEIVER |
| 6919 | TRANSFER AMOUNT MORE THAN AVAILABLE BALANCE OF SENDER |
| 6920 | SOURCE ACCOUNT TYPE MUST BE A NUMBER WITH MAX LENGTH 2 |
| 6921 | SENDER TRANSACTION AMOUNT IS ZERO OR INVALID |
| 6922 | SENDER URN LENGTH EXCEEDED |
| 6923 | SENDER ACCOUNT NUMBER LENGTH EXCEEDED |
| 6924 | SENDER TRANSACTION AMOUNT LENGTH EXCEEDED |
| 6925 | SENDER SOURCE ACCOUNT LENGTH EXCEEDED |
| 6926 | SENDER ACCOUNT NUMBER CURRENCY LENGTH EXCEEDED |
| 6927 | RECEIVER URN LENGTH EXCEEDED |
| 6928 | RECEIVER TRANSACTION AMOUNT LENGTH EXCEEDED |
| 6929 | RECEIVER ACCOUNT NUMBER LENGTH EXCEEDED |
| 6930 | SENDER CUSTOMER ID LENGTH EXCEEDED |
| 6931 | RECEIVER CUSTOMER ID LENGTH EXCEEDED |
| 6932 | SENDER RESERVED FIELD LENGTH EXCEEDED |
| 6933 | RECEIVER RESERVED FIELD LENGTH EXCEEDED |
| 6934 | RECEIVER TRANSACTION AMOUNT IS ZERO OR INVALID |
| 6936 | FIELD OUT OF RANGE FOR DATA TYPE |
| 7937 | SENDER_IMPL_ID_IMPL_TYPE_MISMATCH |
| 7938 | RECEIVER_IMPL_ID_IMPL_TYPE_MISMATCH |
| 7945 | RECEIVER_BENEFICIARY_NOT_PRESENT |
| 7946 | Improper beneficiary implementation ID combination |
| 10027 | CURRENCY NOT PRESENT |
| 10049 | Invalid source account type |
| 10099 | Database exception |
| 10212 | RESERVED FIELD 1 IS MANDATORY |
| 10213 | RESERVED FIELD 2 IS MANDATORY |
| 10214 | RESERVED FIELD 3 IS MANDATORY |
| 10215 | RESERVED FIELD 4 IS MANDATORY |
| 10216 | RESERVED FIELD 5 IS MANDATORY |
| 10217 | RESERVED FIELD 6 IS MANDATORY |
| 30082 | BENEFICIARY_ID_NOT_PRESENT |
| 303042 | FUND_TRANSFER_FAIL |
| 303178 | Request Date Time Length should not be more than 14 characters |
| 303193 | Message Code cannot be Blank, Empty, or null |
