Skip to main content
POST
/
ppi
/
wallet
/
transfer
/
verify
Verify Transfer
curl --request POST \
  --url https://api.cashfree.com/ppi/wallet/transfer/verify \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "transfer_id": "TRANSFER123456",
  "otp": "222113"
}
'
{
  "user_id": "USER827364",
  "wallet_id": "WALLET936721",
  "cf_transfer_id": "8901234567890123456",
  "transfer_id": "TRANSFER123456",
  "amount": 500.75,
  "transfer_mode": "NEFT",
  "sub_wallet": {
    "cf_sub_wallet_id": "35246543210987654321",
    "name": "Cashfree payout Wallet",
    "type": "FULL_KYC_PPI",
    "status": "ACTIVE",
    "balance": 9500.86,
    "available_balance": 9500.86,
    "funds_on_hold": 0
  },
  "status": "PENDING",
  "status_code": "TRANSFER_INITIATED",
  "bank_ref_no": null,
  "bene_details": {
    "bene_id": "BENE123",
    "cf_bene_instrument_id": "35246543210987654323",
    "instrument_details": {
      "bank_account_number": "1234567890",
      "ifsc": "HDFC0000123"
    }
  },
  "purpose": "BUSINESS",
  "remarks": "Vendor payment",
  "notes": {
    "example_key": "example_value"
  },
  "initiated_at": "2025-09-02T10:15:30Z",
  "processed_at": null
}
Call this API after Initiate Transfer. Use Get Transfer Details to proceed with bank processing after OTP succeeds.
You can submit an OTP for verification at most three times per transfer.

Authorizations

​
x-client-id
string
header
required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

​
x-client-secret
string
header
required

The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your Merchant Dashboard.

Headers

​
x-api-version
string
default:2025-11-01
required

API version to be used. Format is in YYYY-MM-DD.

Example:

"2025-11-01"

Body

application/json

Request parameters to verify the OTP for a wallet transfer request.

​
transfer_id
string
required

Transfer identifier from the initiate transfer request (transfer_id you supplied while initiating the transfer).

Required string length: 1 - 50
Example:

"TRANSFER123456"

​
otp
string
required

One-time password received by the end user on the configured notification channels.

Required string length: 4 - 10
Example:

"222113"

Response

Success response for verifying a wallet transfer OTP.

​
user_id
string

Unique identifier for the user, as provided by you during PPI user creation.

Example:

"USER827364"

​
wallet_id
string

Unique identifier for the wallet, as provided by you during wallet creation.

Example:

"WALLET936721"

​
cf_transfer_id
string

Unique identifier for the transfer transaction, generated by Cashfree.

Example:

"8901234567890123456"

​
transfer_id
string

Unique identifier for the transfer transaction, as provided by you during the transfer request.

Example:

"TRANSFER123456"

​
amount
number<double>

Amount that was transferred.

Example:

1250.5

​
transfer_mode
enum<string>

Mode of transfer used.

Available options:
RTGS,
NEFT,
IMPS,
UPI
Example:

"IMPS"

​
sub_wallet
object
​
status
enum<string>

Status of the transfer operation.

Available options:
RECEIVED,
PENDING,
SUCCESS,
FAILED,
REJECTED,
VALIDATION_PENDING,
REVERSED,
APPROVAL_PENDING,
QUEUED,
MANUALLY_REJECTED
Example:

"PENDING"

​
bank_ref_no
string | null

Bank reference number for the transfer. Will be null if transfer is not yet processed.

Example:

"BNK202502101530001"

​
status_code
string

Status code for detailed tracking of transfer progress.

Example:

"TRANSFER_INITIATED"

​
bene_details
object

Beneficiary details used for the transfer.

​
purpose
string

Purpose of the transfer.

Example:

"SALARY"

​
remarks
string

Remarks for the transfer transaction.

Example:

"Monthly groceries transfer"

​
notes
object

Optional key-value pairs for any extra information. Keys and values must be strings.

​
initiated_at
string<date-time>

Timestamp when the transfer transaction was initiated.

Example:

"2025-09-02T10:15:30Z"

​
processed_at
string<date-time> | null

Timestamp when the transfer transaction was processed. Will be null if still pending.

Example:

"2025-09-02T10:17:45Z"