Skip to main content
POST
/
ppi
/
wallet
/
credit
Credit Funds to a User Sub-Wallet
curl --request POST \
  --url https://api.cashfree.com/ppi/wallet/credit \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "credit_id": "2345678901234567890",
  "wallet_id": "9876543210987654321",
  "user_id": "1234567890123456789",
  "sub_wallet_id": "5432109876543210987",
  "amount": 100.5,
  "remarks": "Refund for order #123"
}'
{
  "credit_id": "CRED12345",
  "cf_credit_id": "8901234567890123456",
  "wallet_id": "9876543210987654321",
  "user_id": "1234567890123456789",
  "sub_wallet_id": "5432109876543210987",
  "gift_code": {
    "gift_code": "GIFT-2025-XYZ123",
    "amount": 100.5,
    "expiry": "2025-12-31T23:59:59"
  },
  "sub_wallet_balance": 1500.75,
  "amount": 100.5,
  "status": "PENDING",
  "sub_status": "PENDING",
  "initiated_at": "2025-09-02T10:15:30",
  "processed_at": "2025-09-02T10:20:45"
}

Authorizations

​
x-client-id
string
header
required

Your unique client identifier issued by Cashfree.

​
x-client-secret
string
header
required

The secret key associated with your client ID.

Body

application/json
​
credit_id
string
required

Unique reference for this credit operation.

Example:

"CRED12345"

​
user_id
string
required

Unique identifier for the user.

Example:

"1234567890123456789"

​
wallet_id
string
required

User wallet identifier.

Example:

"9876543210987654321"

​
sub_wallet_id
string
required

User sub-wallet identifier.

Example:

"5432109876543210987"

​
amount
number
required

Amount to credit. Decimal values are allowed. The minimum value should be equal to or greater than 1.00 (>= 1.00).

Example:

100.5

​
remarks
string

Optional remarks for the credit transaction.

Example:

"Refund for order #123"

Response

Credit transaction was processed as successful or pending.

​
credit_id
string

Unique reference for this credit operation.

Example:

"CRED12345"

​
cf_credit_id
string

Cashfree internal credit ID.

Example:

"8901234567890123456"

​
wallet_id
string

User wallet identifier.

Example:

"9876543210987654321"

​
user_id
string

Unique identifier for the user.

Example:

"1234567890123456789"

​
sub_wallet_id
string

Sub-wallet identifier.

Example:

"5432109876543210987"

​
gift_code
object

Gift code details are present when sub-wallet is of gift type.

​
sub_wallet_balance
number

Current balance of the sub-wallet after the credit operation.

Example:

1500.75

​
amount
number

Amount that was credited.

Example:

100.5

​
status
string

Status of the credit operation.

Example:

"PENDING"

​
sub_status
string

Detailed sub-status for the credit operation.

Example:

"PENDING"

​
initiated_at
string<date-time>

Timestamp when the credit transaction was initiated.

Example:

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

​
processed_at
string<date-time>

Timestamp when the credit transaction was processed.

Example:

"2025-09-02T10:20:45"

⌘I