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
