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


Sandbox	https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/api/issuance/v1/enroll
Production	Contact your WIBMO KAM or support.

Request parameters

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.

Sample request

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"
}
'

Response parameters (Decrypted)

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.

Sample response (Decrypted)

{
    "customerId": "000000000429",
    "responseCode": "00",
    "clientTxnId": "Req_Phy_Card04758474s291ram683",
    "responseDateTime": "2024-06-19T15:19:55.620318625",
    "accosaTransactionId": 4638,
    "responseMessage": "SUCCESS",
    "cardUrn": "10000810"
}

API response codes

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