Create Account

Create Account:

Postman Collection

Create Account

URL

POST : /v1/service/upicollect/generate/account

Headers

Content-Type  (String)   required
application/json

Authorization  (String)   required
Basic Auth

Accept  (String)   required
application/json

Request

Example Request

    curl --location --request GET '/v1/service/upicollect/generate/account' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Basic Og==' \
        --data '{
            "merchantCode": "MID73323XXXXX",
            "label": "Label",
            "clientRefId": "CRF2332229XXXXX",
            "description": "description",
            "virtualAccountNumber": "1231234XXXXX",
            "virtualPaymentAddress": "anilXXXXXX",
            "autoDeactivateAt": "2026-05-21",
            "authorizedRemitters": [
                {
                    "account_number": "XXXXXXXXX2661",
                    "account_ifsc": "BARXXXOROMA"
                }
            ],
            "amountLimit": {
                "imps": 200000,
                "neft": 200000,
                "rtgs": 300000
            }
        }'

Response Samples

SUCCESS

    {
            "code": "0x0200",
        "message": "Record added successfully.",
        "status": "SUCCESS",
        "data": {
            "label": "Label",
            "virtualAccountPrefix": "111222",
            "virtualAccountId": "cva0c7d4fa7042f495cd451cxxxxx",
            "virtualAccountNumber": "1112221231XXXXXX",
            "virtualAccountIfsc": "YESBXXXXNOC",
            "virtualPaymentAddress": "aniXXXXX@yesbank",
            "upiQrcodeRemoteFileLocation": "https://s3.ap-south-1.amazonaws.com/yesbank.png",
            "upiQrcodeScannerRemoteFileLocation": "https://s3.ap-south-1.amazonaws.com/yesbank.pdf",
            "authorizedRemitters": [
                {
                    "account_number": "XXXXXXXXX2661",
                    "account_ifsc": "BARBXXXOROMA"
                }
            ],
            "transactionAmountLimit": {
                "imps": 200000,
                "neft": 200000,
                "rtgs": 300000
            },
            "description": "description",
            "isActive": true,
            "kycFlow": false
        }
    }

FAILED

    {
        "code": "0x0202",
        "status": "FAILURE",
        "message": "The merchant code is not valid."
    }

Response Code

Status Code	Status	Message
0x0200	SUCCESS	TRANSACTION SUCCESSFULL
0x0201	UNAUTHORIZED	UNAUTHORIZED USER
0x0202	FAILURE	FAILURE USER
0x0203	MISSING_PARAMETER	MISSING PARAMETER
0x0204	CONNECTION_TIMEOUT	CONNECTION TIMEOUT
0x0205	SOMETHING_WENT_WRONG	SOMETHING WENT WRONG
0x0206	PENDING	TRANSACTION PENDING
0x0207	REVERSED	TRANSACTION REVERSED
0x0209	REDIRECT	REDIRECT URL